> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-de/eigenschaftenbereich/interactions/navigate.md). # Navigieren ## Übersicht Die Navigate-Interaktion ermöglicht es Ihnen, Navigationsaktionen zu definieren, wenn Benutzer mit Komponenten interagieren, z. B. durch Klicken auf eine Schaltfläche. Diese Funktion ermöglicht eine nahtlose Weiterleitung zu verschiedenen Seitentypen, steigert die Benutzerbindung und sorgt für ein reibungsloses Browsing-Erlebnis auf Ihrer Website.
### **Hauptfunktionen** * Unterstützt mehrere Seitentypen als Referenz * Anpassbare Navigationsaktionen * Verbessert den Navigationsfluss der Website ### Anwendungsfälle * **Produktseite:** Weiterleitung zu einer detaillierten Produktspezifikationsseite. * **Support-Seite:** Navigation zu einem Hilfeartikel oder Kontaktformular. * **Community-Seite:** Verknüpfung zu einem Mitgliederprofil oder Diskussionsthread. * **Veranstaltungsseite:** Direkt zu einem Anmeldeformular für eine Veranstaltung. * **Landingpage:** Weiterleitung zu einer Seite mit Kampagnendetails. * **Profilseite:** Navigation zu zugehörigen Kontaktdatensätzen. ## Konfiguration Fügen Sie die Navigate-Interaktion zu einer Komponente (z. B. Button) auf einer Experience-Cloud-Site-Seite hinzu und konfigurieren Sie sie über die Registerkarte Interaktionen im Experience Builder. ### **Verfügbare Navigationstypen** Diese Seitentypen als Referenz legen fest, wohin Benutzer weitergeleitet werden. | Navigationstyp | Beschreibung | Beispielanwendungsfall | | ------------------------------------------- | -------------------------------------------------------------------------------- | -------------------------------------------------------------- | | **Aura – Externe Datensatzseite** | Verweist mithilfe des Aura-Frameworks auf eine bestimmte Datensatzseite. | Die Details eines Kontakts anzeigen. | | **Aura – Externe Datensatzbeziehungsseite** | Verweist auf zugehörige Datensätze (z. B. Kontakte eines Kontos). | Opportunities für ein Konto anzeigen. | | **Aura – Anmeldeseite** | Löst Anmelde- oder Abmeldeaktionen aus. | Melden Sie sich an, um auf eingeschränkte Inhalte zuzugreifen. | | **Knowledge-Artikel** | Führt zu einem bestimmten Knowledge-Artikel. | Auf einen Support-Artikel zugreifen. | | **Verwaltete Inhaltsseite** | Verweist auf eine von einem CMS verwaltete Inhaltsseite. | Einen Nachrichtenartikel anzeigen. | | **Benannte Seite** | Leitet zu einer internen Experience-Builder-Seite weiter. | Zu einer benannten Seite „Support“ gehen. | | **Objektseite** | Navigiert zu einer Listenansicht oder einer neuen Datensatzseite für ein Objekt. | Die Listenansicht für Kontakte öffnen. | | **Datensatzseite** | Verweist auf die Detailseite eines bestimmten Datensatzes. | Einen Kontodatensatz anzeigen. | | **Datensatzbeziehungsseite** | Navigiert zu einer zugehörigen Liste (z. B. Opportunities eines Kontakts). | Cases für ein Konto anzeigen. | | **Webseite** | Leitet zu einer externen oder internen Webseite weiter. | Verknüpfung zu einer Partnerseite. | ***Best Practice**:* Wählen Sie den Typ basierend auf dem Ziel aus (z. B. Datensatzseite für Datensätze); testen Sie die Navigation in der Vorschau. **Navigation zu einer bestimmten Seite konfigurieren** Um die Navigation zu einer bestimmten Seite oder Ressource einzurichten, folgen Sie je nach Anwendungsfall diesen Schritten: ### **Zu einer benannten Seite navigieren** 1. Fügen Sie eine Schaltflächenkomponente hinzu und gehen Sie zur **Interaktionen** Registerkarte. 2. Wählen Sie **Navigieren** und wählen Sie **Benannte Seite**. 3. **Seitenname:** Geben Sie den API-Namen der Zielseite ein (z. B. Content\_Document\_\_c). 4. *Warum das?* Leitet Benutzer zu einer internen Seite weiter (z. B. einer Inhaltsdokumentseite), die im Experience Builder definiert ist.
### **Zu einer Datensatzseite navigieren** Verwenden Sie diese Option, wenn eine Schaltfläche oder Komponente die Detailseite eines bestimmten Datensatzes in Ihrer Experience-Cloud-Site öffnen soll #### Konfigurationsschritte 1. Wählen Sie **Navigieren** und wählen Sie **Datensatzseite**. 2. **Objekt-API-Name:** Geben Sie das Objekt ein (z. B. Contact). 3. **Datensatz-ID:** Wählen Sie das richtige Feld für die Datensatz-ID zur Weiterleitung aus; normalerweise ist es „**`Record: Id`**“. 4. **Aktionsname:** Auf View setzen (Standard für Details). *Warum das?* Führt Benutzer zur Detailseite eines bestimmten Datensatzes (z. B. eines Kontakt-Datensatzes).
{% hint style="warning" %} #### Wichtig Damit die Navigation zu einer Datensatzseite korrekt funktioniert, erstellen Sie zuerst die Objektseite auf Ihrer Experience-Site, auf der die Navigate-Interaktion landen soll. Wenn diese Seite nicht existiert, funktioniert die Interaktion „Navigate to Record Page“ nicht. {% endhint %} ### **Zu einer externen Webseite navigieren** Verwenden Sie diese Option, wenn eine Schaltfläche oder Komponente eine externe Website oder eine andere Webressource öffnen soll, z. B. Ihre Hauptwebsite, ein Partnerportal oder eine Dokumentationsseite #### Konfigurationsschritte 1. Wählen Sie die **Navigieren** Interaktion und wählen Sie die **Webseite** Option aus. 2. **Ziel-URL:** Sie können entweder: * Ein Feld auswählen (z. B. ein Formel-Feld im Datensatz, das die URL speichert), um das Weiterleitungsziel dynamisch festzulegen. * Oder wählen Sie **Benutzerdefiniert** und geben Sie manuell eine externe URL ein (z. B. ). 3. **Warum das?** Diese Option leitet Benutzer zu einer externen Website oder Ressource weiter und verbessert so die Konnektivität der Site. 4. **Fehlerbehebung:** Wenn die Navigation nicht funktioniert, prüfen Sie, ob die URL oder der ausgewählte Feldwert gültig ist, und stellen Sie sicher, dass der Benutzer über die erforderlichen Berechtigungen für den Zugriff auf die Zielseite verfügt. ### **URL-Parameter mit „Navigate to Named Page“ übergeben** Diese Funktion ermöglicht es Ihnen, dynamische Daten (z. B. eine Datensatz-ID) an eine Zielseite zu senden und deren Inhalt basierend auf dem Benutzerkontext anzupassen. Sie eignet sich perfekt zum Erstellen personalisierter Erlebnisse, z. B. um auf einer neuen Seite bestimmte Datensatzdetails anzuzeigen.
{% stepper %} {% step %} #### **Zielseite einrichten** Fügen Sie der Zielseite (z. B. CustomerDetails) eine Komponente wie Avonni Record Detail hinzu. Verwenden Sie im Attribut „Record ID“ den Ausdruck {!Route.recordId}, um einen URL-Parameter mit dem Namen recordId zu erfassen.
{% endstep %} {% step %} #### **Schaltfläche einrichten** Fügen Sie auf der Quellseite (z. B. der Startseite) eine Avonni-Schaltfläche hinzu. In den **Navigieren** Einstellungen wählen Sie **Benannte Seite** und geben Sie den API-Namen ein (z. B. CustomerDetails). {% endstep %} {% step %} #### **Parameter hinzufügen** * **Name:** Geben Sie recordId ein (entsprechend dem Attribut der Zielkomponente). * **Wert:** Wählen Sie ein Feld aus (z. B. {!Record.Id}) oder geben Sie eine bestimmte Datensatz-ID ein, die übergeben werden soll.
{% endstep %} {% step %} *Warum ist das nützlich* Diese Funktion ermöglicht es Ihnen, dynamische Daten (z. B. eine Datensatz-ID) an die Zielseite zu senden und deren Inhalt anzupassen. Wenn Sie beispielsweise auf der Startseite auf eine Schaltfläche klicken, können Benutzer zu einer CustomerDetails-Seite gelangen, auf der die Informationen eines bestimmten Kontakts basierend auf der übergebenen recordId angezeigt werden. {% endstep %} {% step %} *Vergleich* Stellen Sie es sich vor wie das Adressieren eines Briefes – „Navigate to Named Page“ ist der Umschlag und der URL-Parameter (z. B. recordId) ist die Adresse, die dem System sagt, wohin es gehen und welche Daten es mitbringen soll {% endstep %} {% step %} *Fehlerbehebung* Wenn die Zielseite nicht richtig geladen wird, stellen Sie sicher, dass der Parameter recordId mit dem Attribut der Zielkomponente übereinstimmt und dass die ID gültig ist. {% endstep %} {% endstepper %} ### **Zu einem Knowledge-Artikel navigieren** 1. Wählen Sie **Navigieren** und wählen Sie **Knowledge-Artikel**. 2. **URL-Name:** Geben Sie den Ausdruck ein `{{Record.UrlName}}` um dynamisch eine Verknüpfung zu dem Knowledge-Artikel herzustellen, der mit dem aktuellen Datensatz verknüpft ist. 3. *Warum das?* Führt Benutzer basierend auf dem `UrlName` Feld des aktuellen Datensatzes zu einer bestimmten Knowledge-Artikelseite und vereinfacht so den Zugriff auf Support-Inhalte. 4. *Tipp:* Die `{{Record.UrlName}}` Der Ausdruck verwendet die LWR-Syntax, um den eindeutigen URL-Namen des Knowledge-Artikels abzurufen (z. B. aus einem zugehörigen Datensatz). Stellen Sie sicher, dass der Datensatz über ein gültiges `UrlName` Feld verfügt. 5. *Fehlerbehebung:* Wenn die Navigation fehlschlägt, überprüfen Sie, ob das `UrlName` Feld vorhanden ist und einen gültigen URL-Abschnitt des Knowledge-Artikels enthält (z. B. article-title); prüfen Sie die Benutzerberechtigungen für den Zugriff auf den Artikel. *** ## Beispiele ### **Beispiel 1: Zur Support-Seite navigieren** Dieses Beispiel fügt eine Schaltfläche hinzu, um zu einer Support-Seite auf einer Experience-Cloud-Site zu navigieren. 1. **Schaltfläche konfigurieren:** * **Beschriftung:** „Support anfordern“ * **Symbolname:** utility:help * **Variante:** neutral * *Warum das?* Erstellt eine Hilfe-Schaltfläche zur Unterstützung der Benutzer. 2. **Mit der Interaktion „Link To“ verbinden:** * **Navigate:** * **Typ:** Benannte Seite * **Seitenname:** Customer\_Support\_\_c * *Warum das?* Leitet zur in Experience Builder definierten CustomerSupport-Seite weiter. **Ergebnis:** Benutzer klicken auf die Schaltfläche auf einer beliebigen Seite und werden zur Support-Seite navigiert.
*** ## Wichtige Überlegungen * **Zielgenauigkeit:** Stellen Sie sicher, dass Seitennamen oder IDs exakt übereinstimmen. * **Leistung:** Halten Sie die Navigationsziele schlank. * **Barrierefreiheit:** Testen Sie den Fokus und den Kontrast der Schaltfläche. * **Sicherheit:** Validieren Sie externe URLs, um Probleme zu vermeiden. *** ## Häufige Probleme beheben * **Navigation funktioniert nicht:** Überprüfen Sie den ausgewählten Typ und das Ziel (z. B. korrekter Seitenname oder korrekte Datensatz-ID); prüfen Sie die Berechtigungen. * **Seite nicht gefunden:** Stellen Sie sicher, dass die benannte Seite oder das Objekt in Experience Builder vorhanden ist. * **Dynamische ID schlägt fehl:** Bestätigen Sie, dass die Quelle der Datensatz-ID (z. B. {!Record.Id}) gültig ist. * **Wenn die Probleme weiterhin bestehen:** Kontaktieren Sie unser Support-Team unter für Unterstützung. *** ## Zusammenfassung Die Avonni-Navigate-Komponente erweitert Experience-Cloud-Sites um anpassbare Navigationsaktionen. Sie eignet sich perfekt, um Benutzer zu Seiten oder Ressourcen zu führen --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-de/eigenschaftenbereich/interactions/navigate.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.