> 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-fr/panneau-des-proprietes/interactions/navigate.md).

# Naviguer

Redirigez les utilisateurs vers une page — un enregistrement, une page d'objet, une page nommée, une URL externe, et plus encore — lorsqu'ils interagissent avec un composant.

## Vue d'ensemble

L'interaction Navigate vous permet de définir des actions de navigation lorsque les utilisateurs interagissent avec des composants, comme en cliquant sur un bouton. Cette fonctionnalité permet une redirection fluide vers différents types de pages, améliorant l'engagement des utilisateurs et créant une expérience de navigation fluide sur votre site.

<figure><img src="https://3803934262-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>

### **Fonctionnalités clés**

* Prend en charge plusieurs types de références de page
* Actions de navigation personnalisables
* Améliore le flux de navigation du site

### Cas d'utilisation

* **Page produit :** Rediriger vers une page de spécifications détaillées du produit.
* **Page d'assistance :** Accédez à un article d'aide ou à un formulaire de contact.
* **Page communautaire :** Lien vers le profil d'un membre ou un fil de discussion.
* **Page d'événement :** Dirige vers un formulaire d'inscription à un événement.
* **Page d'atterrissage :** Guide vers une page de détails de campagne.
* **Page de profil :** Accédez aux enregistrements de contact associés.

## Configuration

Ajoutez l'interaction Navigate à un composant (par ex., un bouton) sur une page de site Experience Cloud et configurez-la à partir du paramètre d'interaction du composant dans le panneau des propriétés. Experience Builder n'a pas d'onglet Interactions distinct — le paramètre se trouve dans l'éditeur pour l'événement que vous configurez, comme celui d'un bouton **Au clic** ou celui d'un élément de liste **Lier à**.

### **Types de navigation disponibles**

Ces types de références de page indiquent où les utilisateurs sont dirigés.

| Type de navigation                                   | Description                                                                       | Exemple de cas d'utilisation                      |
| ---------------------------------------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------- |
| **Aura - Page d'enregistrement externe**             | Renvoie vers une page d'enregistrement spécifique à l'aide du framework Aura.     | Consultez les détails d'un contact.               |
| **Aura - Page de relation d'enregistrement externe** | Renvoie vers des enregistrements associés (par ex., les contacts d'un compte).    | Voir les opportunités d'un compte.                |
| **Aura - Page de connexion**                         | Déclenche des actions de connexion ou de déconnexion.                             | Connectez-vous pour accéder au contenu restreint. |
| **Article de connaissance**                          | Dirige vers un article de connaissance spécifique.                                | Accédez à un article d'assistance.                |
| **Page de contenu géré**                             | Renvoie vers une page de contenu gérée par un CMS.                                | Consultez un article d'actualité.                 |
| **Page nommée**                                      | Redirige vers une page interne d'Experience Builder.                              | Go to a "Support" named page.                     |
| **Page d'objet**                                     | Navigue vers une vue de liste ou une page de nouvel enregistrement pour un objet. | Ouvrez la vue de liste des Contacts.              |
| **Page d'enregistrement**                            | Renvoie vers la page de détails d'un enregistrement spécifique.                   | Consultez un enregistrement de compte.            |
| **Page de relation d'enregistrement**                | Navigue vers une liste associée (par ex., les opportunités d'un contact).         | Voir les cas d'un compte.                         |
| **Page Web**                                         | Redirige vers une page web externe ou interne.                                    | Lien vers un site partenaire.                     |

*<mark style="background-color:green;">**Bonne pratique**</mark>:* Choisissez le type en fonction de la cible (par ex., Page d'enregistrement pour les enregistrements) ; testez la navigation en aperçu.

**Configuration de la navigation vers une page spécifique**

Pour configurer la navigation vers une page ou une ressource spécifique, suivez ces étapes en fonction de votre cas d'utilisation :

### **Naviguer vers une page nommée**

1. Ajoutez un composant Button et ouvrez son **Au clic** paramètre.
2. Sélectionnez **Naviguer** et choisissez **Page nommée**.
3. **Nom de la page :** Saisissez le nom d'API de la page cible (par ex., Content\_Document\_\_c).
4. *Pourquoi ceci ?* Dirige les utilisateurs vers une page interne (par ex., une page de document de contenu) définie dans Experience Builder.

<figure><img src="https://3803934262-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>

### **Naviguer vers une page d'enregistrement**

Utilisez cette option lorsque vous souhaitez qu'un bouton ou un composant ouvre la page de détails d'un enregistrement spécifique sur votre site Experience Cloud

#### Étapes de configuration

1. Sélectionnez **Naviguer** et choisissez **Page d'enregistrement**.
2. **Nom d'API de l'objet :** Saisissez l'objet (par ex., Contact).
3. **ID de l'enregistrement :** Sélectionnez le champ d'ID d'enregistrement approprié pour la redirection ; généralement, il s'agit de « **`Enregistrement : Id`** ».
4. **Nom de l'action :** Définissez sur Afficher (par défaut pour les détails).

*Pourquoi ceci ?* Amène les utilisateurs à la page de détails d'un enregistrement spécifique (par ex., un enregistrement de contact).

<figure><img src="https://3803934262-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" %}

#### Important

Pour garantir le bon fonctionnement de la navigation vers une page d'enregistrement, créez d'abord la page d'objet sur votre site Experience vers laquelle l'interaction Navigate doit mener. Si cette page n'existe pas, l'interaction Navigate vers une page d'enregistrement ne fonctionnera pas.
{% endhint %}

### **Naviguer vers une page Web externe**

Utilisez cette option lorsque vous souhaitez qu'un bouton ou un composant ouvre un site externe ou une autre ressource web, telle que votre site principal, un portail partenaire ou une page de documentation

#### Étapes de configuration

1. Choisissez l' **Naviguer** interaction et sélectionnez l' **Page Web** option.
2. **URL cible :** Vous pouvez soit :
   * Sélectionner un champ (par ex., un champ de formule sur l'enregistrement qui stocke l'URL) pour définir dynamiquement la cible de redirection.
   * Ou bien, choisissez **Personnalisé** et saisissez manuellement une URL externe (par ex., <https://www.example.com>).
3. **Pourquoi ceci ?** Cette option redirige les utilisateurs vers un site web ou une ressource externe, améliorant la connectivité du site.
4. **Dépannage :** Si la navigation ne fonctionne pas, vérifiez que l'URL ou la valeur du champ sélectionné est valide, et assurez-vous que l'utilisateur dispose des autorisations nécessaires pour accéder au site cible.

### **Transmission de paramètres d'URL avec Naviguer vers une page nommée**

Cette fonctionnalité vous permet d'envoyer des données dynamiques (par ex., un ID d'enregistrement) à une page cible, en personnalisant son contenu en fonction du contexte utilisateur. C'est idéal pour créer des expériences personnalisées, comme l'affichage de détails d'enregistrement spécifiques sur une nouvelle page.

<figure><img src="https://3803934262-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 %}

#### **Configurer la page cible**

Ajoutez un composant comme Avonni Record Detail à la page cible (par ex., CustomerDetails). Dans son attribut « Record ID », utilisez l'expression {!Route.recordId} pour capturer un paramètre d'URL nommé recordId.

<figure><img src="https://3803934262-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 %}

#### **Configurer le bouton**

Sur la page source (par ex., la page d'accueil), ajoutez un bouton Avonni. Dans les **Naviguer** paramètres, choisissez **Page nommée** et saisissez le nom d'API (par ex., CustomerDetails).
{% endstep %}

{% step %}

#### **Ajouter des paramètres**

* **Nom :** Saisissez recordId (correspondant à l'attribut du composant cible).
* **Valeur :** Sélectionnez un champ (par ex., {!Record.Id}) ou saisissez un ID d'enregistrement spécifique à transmettre.

<figure><img src="https://3803934262-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 %}
*Pourquoi est-ce utile*

Cette fonctionnalité vous permet d'envoyer des données dynamiques (par ex., un ID d'enregistrement) à la page cible, en personnalisant son contenu. Par exemple, cliquer sur un bouton sur la page d'accueil peut amener les utilisateurs vers une page CustomerDetails affichant les informations d'un contact spécifique en fonction du recordId transmis.
{% endstep %}

{% step %}
*Analogie*

Pensez-y comme à l'adressage d'une lettre : Naviguer vers une page nommée est l'enveloppe, et le paramètre d'URL (par ex., recordId) est l'adresse, indiquant au système où aller et quelles données apporter
{% endstep %}

{% step %}
*Dépannage*

Si la page cible ne se charge pas correctement, assurez-vous que le paramètre recordId correspond à l'attribut du composant cible et que l'ID est valide.
{% endstep %}
{% endstepper %}

### **Naviguer vers un article de connaissance**

1. Sélectionnez **Naviguer** et choisissez **Article de connaissance**.
2. **Nom d'URL :** Saisissez l'expression `{{Record.UrlName}}` pour créer un lien dynamique vers l'article de connaissance associé à l'enregistrement actuel.
3. *Pourquoi ceci ?* Dirige les utilisateurs vers une page d'article de connaissance spécifique en fonction du `UrlName` champ de l'enregistrement actuel, simplifiant l'accès au contenu d'assistance.
4. *Conseil :* Le `{{Record.UrlName}}` l'expression utilise la syntaxe LWR pour extraire le nom d'URL unique de l'article de connaissance (par ex., à partir d'un enregistrement associé). Assurez-vous que l'enregistrement dispose d'un `UrlName` champ valide renseigné.
5. *Dépannage :* Si la navigation échoue, vérifiez que le `UrlName` champ existe et contient un segment d'URL d'article de connaissance valide (par ex., article-title) ; vérifiez les autorisations de l'utilisateur pour accéder à l'article.

***

## Exemple

### **Exemple 1 : Naviguer vers la page d'assistance**

Cet exemple ajoute un bouton pour naviguer vers une page d'assistance sur un site Experience Cloud.

1. **Configurer le bouton :**
   * **Libellé :** "Obtenir de l'aide"
   * **Nom de l'icône :** utility:help
   * **Variante :** neutre
   * *Pourquoi ceci ?* Crée un bouton d'aide pour assister l'utilisateur.
2. **Définissez l'interaction Lier à :**
   * **Naviguer :**
     * **Type :** Page nommée
     * **Nom de la page :** Customer\_Support\_\_c
     * *Pourquoi ceci ?* Redirige vers la page CustomerSupport définie dans Experience Builder.

**Résultat :** Les utilisateurs cliquent sur le bouton sur n'importe quelle page, ce qui les dirige vers la page d'assistance.

<figure><img src="https://3803934262-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>

***

## Dépannage

* **La navigation ne fonctionne pas :** Vérifiez le type et la cible sélectionnés (par ex., le bon nom de page ou ID d'enregistrement) ; vérifiez les autorisations.
* **Page introuvable :** Assurez-vous que la page nommée ou l'objet existe dans Experience Builder.
* **L'ID dynamique échoue :** Confirmez que la source de l'ID d'enregistrement (par ex., {!Record.Id}) est valide.
* **Si les problèmes persistent :** Contactez notre équipe d'assistance à <support@avonni.com> pour obtenir de l'aide.

***

## Considérations importantes

* **Précision de la cible :** Assurez-vous que les noms de page ou les ID correspondent exactement.
* **Performance :** Gardez les cibles de navigation légères.
* **Accessibilité :** Testez le focus et le contraste du bouton.
* **Sécurité :** Validez les URL externes pour éviter les problèmes.


---

# 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-fr/panneau-des-proprietes/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.
