> 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 Leiten Sie Benutzer auf eine Seite um — einen Datensatz, eine Objektseite, eine benannte Seite, eine externe URL und mehr — wenn sie mit einer Komponente interagieren. ## Ü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 Benutzerinteraktion und sorgt für ein reibungsloses Surferlebnis auf Ihrer Website.
### **Hauptfunktionen** * Unterstützt mehrere Seitentypen von Verweisen * Anpassbare Navigationsaktionen * Verbessert den Navigationsfluss der Website ### Anwendungsfälle * **Produktseite:** Leitet zu einer detaillierten Produkt-Spezifikationsseite weiter. * **Support-Seite:** Navigieren Sie zu einem Hilfeartikel oder Kontaktformular. * **Community-Seite:** Verlinken Sie zu einem Mitgliederprofil oder einem Diskussionsthread. * **Veranstaltungsseite:** Direkt zu einem Anmeldeformular für eine Veranstaltung. * **Landingpage:** Leitet zu einer Seite mit Kampagnendetails weiter. * **Profilseite:** Navigieren Sie zu zugehörigen Kontakt-Datensätzen. ## Konfiguration Fügen Sie die Navigate-Interaktion zu einer Komponente (z. B. einer Schaltfläche) auf einer Experience Cloud-Site-Seite hinzu und konfigurieren Sie sie über die Registerkarte „Interactions“ im Experience Builder. ### **Verfügbare Navigationstypen** Diese Seitentypen bestimmen, wohin Benutzer weitergeleitet werden. | Navigationstyp | Beschreibung | Beispielanwendungsfall | | -------------------------------------------- | -------------------------------------------------------------------------------- | -------------------------------------------------------------- | | **Aura - Externe Datensatzseite** | Verweist mithilfe des Aura-Frameworks auf eine bestimmte Datensatzseite. | Details eines Kontakts anzeigen. | | **Aura - Externe Datensatz-Beziehungsseite** | 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** | Leitet zu einem bestimmten Knowledge-Artikel weiter. | Auf einen Support-Artikel zugreifen. | | **Verwaltete Inhaltsseite** | Verweist auf eine vom 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. | | **Datensatz-Beziehungsseite** | 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. | Zu einer Partner-Website verlinken. | ***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 diesen Schritten entsprechend Ihrem Anwendungsfall: ### **Zu einer benannten Seite navigieren** 1. Fügen Sie eine Schaltflächenkomponente hinzu und wechseln Sie zur **Interactions** 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 für die Weiterleitung das richtige Datensatz-ID-Feld aus; normalerweise ist es „**`Datensatz: Id`**“. 4. **Aktionsname:** Auf Ansicht setzen (Standard für Details). *Warum das?* Führt Benutzer zur Detailseite für einen bestimmten Datensatz (z. B. einen Kontaktdatensatz).
{% 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. 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 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** Mit dieser Funktion können Sie dynamische Daten (z. B. eine Datensatz-ID) an eine Zielseite senden und deren Inhalt basierend auf dem Benutzerkontext anpassen. Sie eignet sich perfekt für die Erstellung personalisierter Erlebnisse, z. B. zum Anzeigen bestimmter Datensatzdetails auf einer neuen Seite.
{% 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 %} #### **Die 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* Mit dieser Funktion können Sie dynamische Daten (z. B. eine Datensatz-ID) an die Zielseite senden und deren Inhalt anpassen. Wenn Sie beispielsweise auf der Startseite auf eine Schaltfläche klicken, können Benutzer zu einer CustomerDetails-Seite gelangen, auf der Informationen zu einem bestimmten Kontakt basierend auf der übergebenen recordId angezeigt werden. {% endstep %} {% step %} *Analogie* Stellen Sie sich das wie das Adressieren eines Briefes vor — „Navigate to Named Page“ ist der Umschlag und der URL-Parameter (z. B. recordId) ist die Adresse, die dem System mitteilt, wohin es gehen und welche Daten es mitbringen soll {% endstep %} {% step %} *Fehlerbehebung* Wenn die Zielseite nicht korrekt 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 zum Knowledge-Artikel herzustellen, der mit dem aktuellen Datensatz verknüpft ist. 3. *Warum das?* Leitet Benutzer zu einer bestimmten Knowledge-Artikel-Seite weiter, basierend auf dem `UrlName` Feld des aktuellen Datensatzes, was den Zugriff auf Support-Inhalte vereinfacht. 4. *Tipp:* Der `{{Record.UrlName}}` 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 einen gültigen `UrlName` Wert enthält. 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. artikel-titel); prüfen Sie die Benutzerberechtigungen für den Zugriff auf den Artikel. *** ## Beispiel ### **Beispiel 1: Zur Support-Seite navigieren** In diesem Beispiel wird eine Schaltfläche hinzugefügt, um zu einer Support-Seite auf einer Experience Cloud-Site zu navigieren. 1. **Schaltfläche konfigurieren:** * **Beschriftung:** „Support erhalten“ * **Symbolname:** utility:help * **Variante:** neutral * *Warum das?* Erstellt eine Hilfeschaltfläche für die Benutzerunterstützung. 2. **Mit Interaktion verknüpfen:** * **Navigieren:** * **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 Hinweise * **Zielgenauigkeit:** Stellen Sie sicher, dass Seitennamen oder IDs exakt übereinstimmen. * **Leistung:** Halten Sie Navigationsziele schlank. * **Barrierefreiheit:** Testen Sie den Fokus und den Kontrast der Schaltfläche. * **Sicherheit:** Validieren Sie externe URLs, um Probleme zu vermeiden. *** ## Fehlerbehebung * **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 im 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:** Wenden Sie sich an unser Support-Team unter für Unterstützung. --- # 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.