> 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 zu einer Seite um — ein Datensatz, eine Objektseite, eine benannte Seite, eine externe URL und mehr — wenn sie mit einer Komponente interagieren.

## Überblick

Die Interaktion „Navigate“ ermöglicht es Ihnen, Navigationsaktionen zu definieren, wenn Benutzer mit Komponenten interagieren, z. B. indem sie auf eine Schaltfläche klicken. Diese Funktion ermöglicht eine nahtlose Weiterleitung zu verschiedenen Seitentypen, erhöht die Benutzerbindung und schafft ein reibungsloses Surferlebnis auf Ihrer gesamten Website.

<figure><img src="https://4175360472-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-b76cdd189cdf5f4bc6b29a9931ea057133c580fd%2F2023-11-06_11-26-43.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

### **Wichtigste Funktionen**

* Unterstützt mehrere Arten von Seitenreferenzen
* Anpassbare Navigationsaktionen
* Verbessert den Navigationsfluss der Website

### Anwendungsfälle

* **Produktseite:** Weiterleitung zu einer detaillierten Produktspezifikationsseite.
* **Supportseite:** Navigieren Sie zu einem Hilfeartikel oder einem Kontaktformular.
* **Community-Seite:** Verknüpfen Sie zu einem Mitgliederprofil oder einem Diskussionsthread.
* **Veranstaltungsseite:** Direkt zu einem Formular für die Veranstaltungsanmeldung.
* **Landingpage:** Leiten Sie zu einer Seite mit Kampagnendetails.
* **Profilseite:** Navigieren Sie zu zugehörigen Kontaktdatensätzen.

## Konfiguration

Fügen Sie die Interaktion „Navigate“ zu einer Komponente (z. B. einer Schaltfläche) auf einer Experience-Cloud-Site-Seite hinzu und konfigurieren Sie sie über die Interaktionseinstellung der Komponente im Eigenschaftenbereich. Experience Builder hat keine separate Registerkarte „Interaktionen“ — die Einstellung befindet sich im Editor für das Ereignis, das Sie verknüpfen, z. B. die Schaltfläche **Beim Klicken** oder eines Listenelements **Verknüpfen mit**.

### **Verfügbare Navigationstypen**

Diese Arten von Seitenreferenzen geben an, wohin Benutzer weitergeleitet werden.

| Navigationstyp                              | Beschreibung                                                                                            | Beispielanwendungsfall                           |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------ |
| **Aura - Externe Datensatzseite**           | Verknüpft zu einer bestimmten Datensatzseite mithilfe des Aura-Frameworks.                              | Die Details eines Kontakts anzeigen.             |
| **Aura - Externe Datensatzbeziehungsseite** | Verknüpft zu zugehörigen Datensätzen (z. B. Kontakte eines Kontos).                                     | Die Opportunities für ein Konto anzeigen.        |
| **Aura - Anmeldeseite**                     | Löst Anmelde- oder Abmeldeaktionen aus.                                                                 | Anmelden, um auf geschützte Inhalte zuzugreifen. |
| **Knowledge-Artikel**                       | Leitet zu einem bestimmten Knowledge-Artikel weiter.                                                    | Auf einen Supportartikel zugreifen.              |
| **Verwaltete Inhaltsseite**                 | Verknüpft zu einer von CMS verwalteten 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 Seite zum Erstellen eines neuen Datensatzes für ein Objekt. | Die Listenansicht für Kontakte öffnen.           |
| **Datensatzseite**                          | Verknüpft zu der Detailseite eines bestimmten Datensatzes.                                              | Einen Kontodatensatz anzeigen.                   |
| **Datensatzbeziehungsseite**                | Navigiert zu einer zugehörigen Liste (z. B. Opportunities eines Kontakts).                              | Die Cases für ein Konto anzeigen.                |
| **Webseite**                                | Leitet zu einer externen oder internen Webseite weiter.                                                 | Zu einer Partnerseite verlinken.                 |

*<mark style="background-color:green;">**Best Practice**</mark>:* 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 öffnen Sie deren **Beim Klicken** Einstellung.
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 in Experience Builder definiert ist.

<figure><img src="https://4175360472-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-e9561697b8d10bf218981515183b03208b8db1c6%2F2025-09-05_15-36-22.png?alt=media" alt=""><figcaption></figcaption></figure>

### **Zu einer Datensatzseite navigieren**

Verwenden Sie diese Option, wenn Sie möchten, dass eine Schaltfläche oder Komponente die Detailseite eines bestimmten Datensatzes in Ihrer Experience-Cloud-Site öffnet

#### Konfigurationsschritte

1. Wählen Sie **Navigieren** und wählen Sie **Datensatzseite**.
2. **Objekt-API-Name:** Geben Sie das Objekt ein (z. B. Kontakt).
3. **Datensatz-ID:** Wählen Sie das richtige Feld für die Datensatz-ID zur Weiterleitung aus; normalerweise ist es „**`Datensatz: Id`**“.
4. **Aktionsname:** Auf Anzeigen festlegen (Standard für Details).

*Warum das?* Führt Benutzer zur Detailseite eines bestimmten Datensatzes (z. B. eines Kontaktdatensatzes).

<figure><img src="https://4175360472-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-c4d70da683e39ea1bb32268b0779996cd6128cbc%2F2025-09-05_15-41-52.png?alt=media" alt="" width="304"><figcaption></figcaption></figure>

{% hint style="warning" %}

#### Wichtig

Um sicherzustellen, dass die Navigation zu einer Datensatzseite korrekt funktioniert, erstellen Sie zuerst die Objektseite auf Ihrer Experience-Site, auf der die Interaktion „Navigate“ landen soll. Wenn diese Seite nicht vorhanden ist, funktioniert die Interaktion „Navigate to Record Page“ nicht.
{% endhint %}

### **Zu einer externen Webseite navigieren**

Verwenden Sie diese Option, wenn Sie möchten, dass eine Schaltfläche oder Komponente eine externe Website oder eine andere Webressource öffnet, 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. <https://www.example.com>).
3. **Warum das?** Diese Option leitet Benutzer zu einer externen Website oder Ressource weiter und verbessert die Konnektivität der Website.
4. **Fehlerbehebung:** Wenn die Navigation nicht funktioniert, überprü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 zum Erstellen personalisierter Erlebnisse, z. B. zum Anzeigen bestimmter Datensatzdetails auf einer neuen Seite.

<figure><img src="https://4175360472-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-ae4dd3b64c530bed1bab9f5cfa5a581985f4c167%2F2024-10-17_15-22-41.png?alt=media" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

#### **Zielseite einrichten**

Fügen Sie der Zielseite eine Komponente wie Avonni Record Detail hinzu (z. B. CustomerDetails). Verwenden Sie im Attribut „Record ID“ den Ausdruck {!Route.recordId}, um einen URL-Parameter mit dem Namen recordId zu erfassen.

<figure><img src="https://4175360472-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-67906ac9c31e38326caa838ca3563a069cd78933%2F2024-10-17_15-21-19.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### **Schaltfläche einrichten**

Fügen Sie auf der Quellseite (z. B. der Startseite) eine Avonni-Schaltfläche hinzu. Wählen Sie in den **Navigieren** Einstellungen **Benannte Seite** aus 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.

<figure><img src="https://4175360472-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-eed5b139b882ece8e987c1489203359113df215d%2Fimage%20-%202025-09-05T160337.867.avif?alt=media" alt=""><figcaption></figcaption></figure>
{% 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. Beispielsweise kann ein Klick auf eine Schaltfläche auf der Startseite Benutzer zu einer CustomerDetails-Seite führen, die anhand der übergebenen recordId die Informationen eines bestimmten Kontakts anzeigt.
{% endstep %}

{% step %}
*Vergleich*

Stellen Sie sich das vor wie das Adressieren eines Briefs — „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 korrekt geladen wird, stellen Sie sicher, dass der Parameter recordId dem Attribut der Zielkomponente entspricht 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 mit dem aktuellen Datensatz verknüpften Knowledge-Artikel herzustellen.
3. *Warum das?* Leitet Benutzer zu einer bestimmten Knowledge-Artikel-Seite weiter, basierend auf dem `UrlName` Feld des aktuellen Datensatzes und vereinfacht so den Zugriff auf Supportinhalte.
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 einen gültigen `UrlName` Feldwert enthält.
5. *Fehlerbehebung:* Wenn die Navigation fehlschlägt, überprüfen Sie, ob das `UrlName` Feld vorhanden ist und einen gültigen URL-Abschnitt für den Knowledge-Artikel enthält (z. B. article-title); überprüfen Sie die Benutzerberechtigungen für den Zugriff auf den Artikel.

***

## Beispiel

### **Beispiel 1: Zu Supportseite navigieren**

In diesem Beispiel wird eine Schaltfläche hinzugefügt, um zu einer Supportseite auf einer Experience-Cloud-Site zu navigieren.

1. **Schaltfläche konfigurieren:**
   * **Beschriftung:** „Support erhalten“
   * **Symbolname:** utility:help
   * **Variante:** neutral
   * *Warum das?* Erstellt eine Hilfe-Schaltfläche für die Unterstützung der Benutzer.
2. **Interaktion „Link To“ festlegen:**
   * **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 navigieren zur Supportseite.

<figure><img src="https://4175360472-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-d0e9c60e20d1a81967af5bdb9e08d6e8111f716d%2F2025-09-05_15-49-24.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

***

## Fehlerbehebung

* **Navigation funktioniert nicht:** Überprüfen Sie den ausgewählten Typ und das Ziel (z. B. korrekter Seitenname oder 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 <support@avonni.com> für Unterstützung.

***

## Wichtige Überlegungen

* **Zielgenauigkeit:** Stellen Sie sicher, dass Seitennamen oder IDs exakt übereinstimmen.
* **Leistung:** Halten Sie Navigationsziele schlank.
* **Barrierefreiheit:** Testen Sie Fokus und Kontrast der Schaltfläche.
* **Sicherheit:** Validieren Sie externe URLs, um Probleme zu vermeiden.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-de/eigenschaftenbereich/interactions/navigate.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.