Navigiert

Überblick

Die Navigate-Interaktion ermöglicht es Ihnen zu steuern, wohin Benutzer gelangen, wenn sie auf interaktive Elemente (z. B. Schaltflächen, Links oder Tabellenzeilen) in Ihrer Dynamischen Komponente klicken. Sie können Benutzer senden zu:

  • Andere Seiten innerhalb von Salesforce

  • Bestimmte Datensätze oder Objekte

  • Externe Websites

  • Benutzerdefinierte Lightning-Komponenten

Wichtig: Navigate-Interaktionen funktionieren nur auf bereitgestellten Lightning-Seiten. In der Vorschau werden sie nicht ausgeführt.


Verstehen der Page-Reference-Typen

Wenn Sie eine Navigate-Interaktion hinzufügen, wählen Sie zuerst einen Page Reference Type. Dies teilt Salesforce mit, zu welcher Art von Ziel Sie navigieren.

Verfügbare Typen:

  • App: Navigieren Sie zu einer bestimmten Lightning-App.

  • Knowledge Article: Navigieren Sie zu einem bestimmten Knowledge-Artikel.

  • Lightning Component: Navigieren Sie zu einer benutzerdefinierten Lightning-Komponente.

  • Login Page: Navigieren Sie zur Login-Seite einer Experience Builder-Site.

  • Named Page (Standard): Navigieren Sie zu Standard-Salesforce-Seiten (wie Startseite, Chatter usw.).

  • Navigation Item Page: Navigieren Sie zu einer Seite, die mit einer benutzerdefinierten Registerkarte verknüpft ist.

  • Object Page: Navigieren Sie zu einer Standard- oder benutzerdefinierten Objektseite (Listenansicht, Seite zum Erstellen eines neuen Datensatzes usw.).

  • Record Page: Navigieren Sie zur Detailseite eines bestimmten Datensatzes.

  • Web Page: Navigieren Sie zu einer externen Website (URL).

Die folgenden Abschnitte erläutern, wie jeder Page-Reference-Typ konfiguriert wird.


Konfigurationsanleitung nach Typen

Record Page (am häufigsten)

Verwenden Sie dies, um: Die Detailseite, die Bearbeitungsseite oder die Klonseite eines bestimmten Datensatzes zu öffnen.

Beispielszenarien

  • Klicken Sie auf eine Schaltfläche, um einen Account-Datensatz anzuzeigen

  • Klicken Sie auf eine Tabellenzeile, um einen Kontakt zu bearbeiten

  • Klonen Sie eine Opportunity über eine benutzerdefinierte Aktion

Konfiguration

  1. Page Reference Type: Record Page

  2. Object API Name: Der Objekttyp des Datensatzes, den Sie öffnen

    • Beispiele: Account, Contact, Opportunity, My_Custom_Object__c

  3. Record ID: Woher die ID des Datensatzes stammt

    • Aus einer Tabellenzeile: Verwenden Sie @TableName.firstSelectedRow.Id

    • Vom aktuellen Datensatz: Verwenden Sie @recordId

    • Aus einer Variablen: Wählen Sie Ihre Variable, die die ID enthält

  4. Action Name: Welche Seite geöffnet werden soll

    • view - Detailseite (Standard)

    • edit - Bearbeitungsseite

    • clone - Klon-/Duplikatseite

Beispiel: Navigieren, um einen Account anzuzeigen, wenn auf eine Schaltfläche geklickt wird

  • Object API Name: Account

  • Record ID: @AccountsTable.firstSelectedRow.Id

  • Action Name: view

Sehen Sie sich das Tutorial an


Object Page

Verwenden Sie dies, um: Navigieren Sie zu einer objektbezogenen Seite (nicht zu einem bestimmten Datensatz).

Beispielszenarien

  • Klicken Sie auf eine Schaltfläche, um einen neuen Account zu erstellen

  • Öffnen Sie die Startseite der Fälle

  • Alle Opportunities anzeigen

Konfiguration

  1. Page Reference Type: Object Page

  2. Object API Name: Das Objekt, zu dem Sie navigieren möchten

    • Beispiele: Account, Case, Opportunity

  3. Action Name: Welche Seite geöffnet werden soll

    • home - Objekt-Startseite (zeigt typischerweise die Standard-Listenansicht)

    • list - Bestimmte Listenansicht (kann zusätzliche Konfiguration erfordern)

    • new - Seite zum Erstellen eines neuen Datensatzes

Beispiel: Erstellen Sie einen neuen Kontakt

  • Object API Name: Contact

  • Action Name: new

💡 Tipp: Beim Verwenden von newkönnen Sie Felder im Formular für neue Datensätze vorbefüllen. Siehe Automatisch ausgefüllte Felder unten.


Web Page

Verwenden Sie dies, um zu einer Website zu navigieren, indem Sie eine feste URL angeben oder dynamisch auf ein Feld verweisen, das eine URL enthält.

Konfiguration

  • Page Reference Type: Web Page

  • URL: Sie haben zwei Optionen:

    • Statische URL: Geben Sie die vollständige URL der Website direkt ein (z. B., https://www.example.com). Dadurch wird immer dieselbe Website aufgerufen.

    • Dynamische URL (aus einem Feld): Wählen Sie ein Feld aus dem Kontext der Komponente aus, das die URL enthält. Dieses Formelfeld erstellt die URL typischerweise basierend auf anderen Daten. Zum Beispiel könnten Sie ein Formelfeld auf einem Account-Objekt haben, das eine URL zur Website des Accounts generiert. Sie könnten dieses Formelfeld dann hier auswählen. Dadurch kann sich die Ziel-URL dynamisch basierend auf dem angezeigten oder ausgewählten Datensatz ändern.

Fehlerbehebung bei der Navigation zu Webseiten

Problem: Beim Klicken einer Schaltfläche mit einer Web Page-Interaktion passiert nichts oder die Navigation funktioniert nicht.

Mögliche Ursachen & Lösungen:

  1. Einschränkung im Vorschaumodus

    • ⚠️ Interaktionen funktionieren im Vorschaumodus nicht

    • Sie müssen Ihre Dynamische Komponente auf einer Lightning-Seite bereitstellen und sie in der tatsächlichen Salesforce-Umgebung anzeigen, um Navigationsinteraktionen zu testen

    • Der Vorschaumodus dient nur zur visuellen Layoutüberprüfung, nicht zum Funktionstest

  2. Ungültige oder leere URL

    • Stellen Sie sicher, dass die URL korrekt formatiert ist und das Protokoll enthält (z. B., https://)

    • Wenn Sie ein dynamisches URL-Feld verwenden, prüfen Sie, ob das Feld tatsächlich einen gültigen URL-Wert enthält

    • Testen Sie die URL direkt in einem Browser, um sicherzustellen, dass sie zugänglich ist

    • Verwenden Sie die Entwicklertools des Browsers (F12) in der Konsole, um nach JavaScript-Fehlern zu suchen

  3. Fehlendes Protokoll (http:// oder https://)

    • URLs müssen das vollständige Protokoll enthalten: https://www.example.com (korrekt)

    • www.example.com allein funktioniert nicht (falsch)

    • Wenn Sie ein dynamisches Feld verwenden, stellen Sie sicher, dass der Feldwert das Protokoll enthält

  4. Salesforce-Sicherheitsbeschränkungen

    • Externe URLs müssen möglicherweise zu den Vertrauenswürdigen Sites Ihrer Organisation hinzugefügt werden

    • Gehen Sie zu Setup → CSP Trusted Sites und fügen Sie die Domain hinzu

    • Einige Organisationen haben strenge Content-Security-Richtlinien, die externe Navigation blockieren

  5. Popup-Blocker

    • Wenn die Navigation in einem neuen Tab/Fenster geöffnet wird, können Browser-Popup-Blocker dies verhindern

    • Überprüfen Sie die Browsereinstellungen und erlauben Sie Pop-ups für Ihre Salesforce-Domain

    • Erwägen Sie die Verwendung einer Navigation, die im selben Tab geöffnet wird

  6. Probleme mit dynamischen URL-Feldern

    • Überprüfen Sie, ob die Feldreferenz korrekt ist und auf das richtige Objekt/den richtigen Datensatz zeigt

    • Stellen Sie sicher, dass das Feld Daten enthält (nicht null oder leer)

    • Bei Formelfeldern prüfen Sie, ob die Formel die URL korrekt zusammensetzt

    • Testen Sie den Feldwert unabhängig, um sicherzustellen, dass er eine gültige URL enthält

  7. Interaktion nicht richtig konfiguriert

    • Überprüfen Sie, ob die Interaktion tatsächlich zur Komponente hinzugefügt wurde (prüfen Sie das Interactions-Panel)

    • Stellen Sie sicher, dass der richtige Ereignisauslöser ausgewählt ist (z. B. „On Click“ für Schaltflächen)

    • Prüfen Sie, ob die Navigate-Aktion innerhalb der Interaktion korrekt konfiguriert ist

  8. Probleme mit dem Komponenten-Kontext

    • Wenn Sie eine dynamische URL aus einer ausgewählten Zeile oder einem Datensatz verwenden, stellen Sie sicher, dass tatsächlich ein Datensatz ausgewählt ist

    • Für Data Table-Komponenten prüfen Sie, ob die Zeilenauswahl aktiviert ist und funktioniert

    • Überprüfen Sie, ob die Kontextvariable (z. B., @AccountsTable.firstSelectedRow.Website__c) einen Wert hat.


App

Verwenden Sie dies, um zu einer Lightning-App zu navigieren.

  • Konfiguration:

    • Page Reference Type: App

    • App-Ziel: Geben Sie entweder:

      • Die App-ID (z. B., 06mRM0000008dNrYAI). Sie können die App-ID in der URL finden, wenn Sie die App unter Setup > App Manager bearbeiten. Die URL sieht wie folgt aus: /lightning/app/06mRM0000008dNrYAI.

      • Die App-Entwicklername (z. B., standard__LightningSales). Dies ist der API-Name der App.

    • Beispiel-URLs (Nur zu Informationszwecken - Sie müssen diese URLs eingeben nicht):

      • Zur App-Startseite (mithilfe der App-ID): /lightning/app/06mRM0000008dNrYAI

      • Zur Objekt-Startseite innerhalb der App (mithilfe der App-ID): /lightning/app/06mRM0000008dNrYAI/o/Case/home

      • Zur App-Startseite (mithilfe des Developer-Namens): /lightning/app/standard__LightningSales

      • Zur Objekt-Startseite innerhalb der App (mithilfe des Developer-Namens): /lightning/app/standard__LightningSales/o/Case/home


Knowledge Article

Verwenden Sie dies, um zu einem bestimmten Knowledge-Artikel zu navigieren.

  • Konfiguration:

    • Page Reference Type: Knowledge Article

    • Article Type: Geben Sie den API-Namen des Knowledge-Artikel-Typs ein (z. B., Knowledge__kav).

    • URL Name: Geben Sie den URL-Namen des spezifischen Artikels ein, auf den Sie verlinken möchten.

    Wichtiger Hinweis: In Experience Builder-Sites wird der Article Type ignoriert; es wird nur der URL Name verwendet.


Lightning Component

Verwenden Sie dies, um: Navigieren Sie zu einer benutzerdefinierten Lightning Web Component (LWC) oder Aura-Komponente.

Konfiguration

  1. Page Reference Type: Lightning Component

  2. Component Name: Der API-Name der Komponente

    • Format: namespace__componentName

    • Standard-Namespace: c__myComponent

    • Managed Package: myNamespace__myComponent


Login-Seite (Experience Builder-Sites)

Verwenden Sie dies, um: Navigieren Sie zu Login- oder Logout-Seiten in Experience Builder-Sites.

Konfiguration

  1. Page Reference Type: Login Page

  2. Action Name:

    • login - Zur Login-Seite navigieren

    • logout - Den Benutzer abmelden


Named Page (Standard)

Verwenden Sie dies, um: Navigieren Sie zu Standard-Salesforce-Seiten.

Konfiguration

  1. Page Reference Type: Named Page (Standard)

  2. Seitenname: Wählen Sie aus:

    • home - Salesforce-Startseite

    • chatter - Chatter-Feed

    • today - Heutige Kalenderansicht

    • dataAssessment - Datenbewertungsseite

    • filePreview - Dateivorschau-Seite


Verwenden Sie dies, um: Navigieren Sie zu einer Seite, die mit einer benutzerdefinierten Registerkarte verknüpft ist.

Konfiguration

  1. Page Reference Type: Navigation Item Page

  2. Tab API Name: Der API-Name Ihrer benutzerdefinierten Registerkarte

    • Beispiel: My_Custom_Tab__c


Automatisch ausgefüllte Felder beim Erstellen eines neuen Datensatzes

Wenn Sie zur Erstellung eines neuen Datensatzes navigieren (Object Page mit Aktion new), können Sie Felder im Formular vorbefüllen.

Anwendungsfall

Erstellen Sie einen neuen Kontakt, der automatisch mit dem aktuellen Account verknüpft ist.

Wie es funktioniert

  • Richten Sie Feldzuordnungen in der Navigate-Interaktion ein

  • Das Formular für den neuen Datensatz öffnet sich mit diesen bereits ausgefüllten Feldern

  • Benutzer können die Werte vor dem Speichern weiterhin ändern

Beispiel

Account-Feld vorbefüllen, wenn ein Kontakt von einer Account-Seite erstellt wird

  • Navigieren zu Object Page: Contact

  • Aktion: new

  • Feldzuordnung hinzufügen: AccountId = @Record: Id


Tutorials

Wie man eine Interaktion erstellt, um zu einer Objektseite zu navigieren

Wie man eine Interaktion erstellt, um zu einer Datensatzseite zu navigieren

Zuletzt aktualisiert

War das hilfreich?