> 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

## Aperçu

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

<figure><img src="/files/d2f1f8fd119577890fa93982f1d7a02fc1b228e6" 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 la fluidité de la navigation sur le site

### Cas d’utilisation

* **Page produit :** Rediriger vers une page de spécifications produit détaillée.
* **Page d’assistance :** Accéder à un article d’aide ou à un formulaire de contact.
* **Page communauté :** Lien vers le profil d’un membre ou un fil de discussion.
* **Page événement :** Diriger vers un formulaire d’inscription à un événement.
* **Page d’atterrissage :** Orienter vers une page de détails de campagne.
* **Page de profil :** Accéder aux enregistrements de contact associés.

## Configuration

Ajoutez l’interaction Navigate à un composant (par exemple, un bouton) sur une page de site Experience Cloud et configurez-la via l’onglet Interactions dans Experience Builder.

### **Types de navigation disponibles**

Ces types de références de page indiquent vers 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.      | Afficher les détails d’un contact.                |
| **Aura - Page de relation d’enregistrement externe** | Renvoie vers des enregistrements associés (par exemple, 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.                              | Se connecter pour accéder à du contenu restreint. |
| **Article de connaissance**                          | Dirige vers un article de connaissance spécifique.                                 | Accéder à un article d’assistance.                |
| **Page de contenu géré**                             | Renvoie vers une page de contenu gérée par un CMS.                                 | Consulter un article d’actualité.                 |
| **Page nommée**                                      | Redirige vers une page interne d’Experience Builder.                               | Aller à une page nommée « Support ».              |
| **Page d’objet**                                     | Accède à une vue de liste ou à une page de nouvel enregistrement pour un objet.    | Ouvrir la vue de liste des contacts.              |
| **Page d’enregistrement**                            | Renvoie vers la page de détails d’un enregistrement spécifique.                    | Afficher un enregistrement de compte.             |
| **Page de relation d’enregistrement**                | Accède à une liste associée (par exemple, 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 exemple, 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 Bouton et allez dans l’onglet **Interactions**  .
2. Sélectionnez **Naviguer** et choisissez **Page nommée**.
3. **Nom de la page :** Saisissez le nom API de la page cible (par exemple, Content\_Document\_\_c).
4. *Pourquoi cela ?* Dirige les utilisateurs vers une page interne (par exemple, une page de document de contenu) définie dans Experience Builder.

<figure><img src="/files/236fe32a5492f482d8e9d5aae6e39506626959c3" 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 dans votre site Experience Cloud

#### Étapes de configuration

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

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

<figure><img src="/files/f335bfbe0dae4bc07fecc01251db0b8ca16cffce" 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, là où l’interaction Navigate doit aboutir. Si cette page n’existe pas, l’interaction Naviguer 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, comme 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 exemple, un champ de formule sur l’enregistrement qui stocke l’URL) pour définir dynamiquement la cible de redirection.
   * Ou choisir **Personnalisé** et saisir manuellement une URL externe (par exemple, <https://www.example.com>).
3. **Pourquoi cela ?** Cette option redirige les utilisateurs vers un site 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 exemple, un ID d’enregistrement) à une page cible, en personnalisant son contenu en fonction du contexte de l’utilisateur. C’est idéal pour créer des expériences personnalisées, comme afficher les détails d’un enregistrement spécifique sur une nouvelle page.

<figure><img src="/files/e6d4b851a48f51e01daa7175c8a9dbaf9268c4f2" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

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

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

<figure><img src="/files/19f5c14b983390697113c3594e2c2907fc680030" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### **Configurer le bouton**

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

{% step %}

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

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

<figure><img src="/files/77c557c06ca9c360a9eb15621392da3347e5358a" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
*Pourquoi est-ce utile ?*

Cette fonctionnalité vous permet d’envoyer des données dynamiques (par exemple, 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*

Considérez cela comme l’adresse d’une lettre : Naviguer vers une page nommée est l’enveloppe, et le paramètre d’URL (par exemple, 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 dynamiquement un lien vers l’article de connaissance associé à l’enregistrement actuel.
3. *Pourquoi cela ?* 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 :* La `{{Record.UrlName}}` l’expression utilise la syntaxe LWR pour récupérer le nom d’URL unique de l’article de connaissance (par exemple, à partir d’un enregistrement associé). Assurez-vous que l’enregistrement possède 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 valide d’article de connaissance (par exemple, article-title) ; vérifiez les autorisations de l’utilisateur pour accéder à l’article.

***

## Exemples

### **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 cela ?* Crée un bouton d’aide pour assister l’utilisateur.
2. **Définir l’interaction Lien vers :**
   * **Naviguer :**
     * **Type :** Page nommée
     * **Nom de la page :** Customer\_Support\_\_c
     * *Pourquoi cela ?* Redirige vers la page CustomerSupport définie dans Experience Builder.

**Résultat :** Les utilisateurs cliquent sur le bouton sur n’importe quelle page et accèdent à la page d’assistance.

<figure><img src="/files/f22fecc90463f09eebd1e366cbe7054e1d4a880e" alt="" width="375"><figcaption></figcaption></figure>

***

## Points clés à considérer

* **Précision de la cible :** Assurez-vous que les noms de page ou les ID correspondent exactement.
* **Performances :** 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.

***

## Dépannage des problèmes courants

* **La navigation ne fonctionne pas :** Vérifiez le type et la cible sélectionnés (par exemple, 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 exemple, {!Record.Id}) est valide.
* **Si les problèmes persistent :** Contactez notre équipe d’assistance à <support@avonni.com> pour obtenir de l’aide.

***

## Résumé

Le composant Avonni Navigate améliore les sites Experience Cloud avec des actions de navigation personnalisables. Il est idéal pour guider les utilisateurs vers des pages ou des ressources


---

# 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-fr/panneau-des-proprietes/interactions/navigate.md?ask=<question>&goal=<endgoal>
```

`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.
