> 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-it/pannello-proprieta/interactions/navigate.md).

# Naviga

## Panoramica

L’interazione Navigate consente di definire azioni di navigazione quando gli utenti interagiscono con i componenti, ad esempio facendo clic su un pulsante. Questa funzione abilita il reindirizzamento fluido verso vari tipi di pagina, migliorando il coinvolgimento degli utenti e creando un’esperienza di navigazione fluida in tutto il sito.

<figure><img src="/files/7715542183ea11a1d872e4a3e55a09a61b66298d" alt="" width="563"><figcaption></figcaption></figure>

### **Caratteristiche principali**

* Supporta più tipi di riferimento a pagina
* Azioni di navigazione personalizzabili
* Migliora il flusso di navigazione del sito

### Casi d’uso

* **Pagina prodotto:** Reindirizza a una pagina dettagliata delle specifiche del prodotto.
* **Pagina di supporto:** Vai a un articolo della guida o a un modulo di contatto.
* **Pagina community:** Collega a un profilo membro o a una discussione.
* **Pagina evento:** Vai direttamente a un modulo di registrazione all’evento.
* **Pagina di destinazione:** Guida a una pagina con i dettagli della campagna.
* **Pagina profilo:** Vai a record di contatto correlati.

## Configurazione

Aggiungi l’interazione Navigate a un componente (ad esempio, Button) in una pagina del sito Experience Cloud e configurala tramite la scheda Interactions in Experience Builder.

### **Tipi di navigazione disponibili**

Questi tipi di riferimento a pagina specificano dove vengono indirizzati gli utenti.

| Tipo di navigazione                        | Descrizione                                                            | Esempio di caso d’uso                        |
| ------------------------------------------ | ---------------------------------------------------------------------- | -------------------------------------------- |
| **Aura - Pagina record esterna**           | Collega a una pagina record specifica usando il framework Aura.        | Visualizza i dettagli di un contatto.        |
| **Aura - Pagina relazione record esterna** | Collega a record correlati (ad esempio, i contatti di un account).     | Visualizza le opportunità di un account.     |
| **Aura - Pagina di accesso**               | Attiva azioni di accesso o disconnessione.                             | Accedi per visualizzare contenuti riservati. |
| **Articolo Knowledge**                     | Reindirizza a un articolo Knowledge specifico.                         | Accedi a un articolo di supporto.            |
| **Pagina di contenuto gestito**            | Collega a una pagina di contenuto gestita dal CMS.                     | Visualizza un articolo di notizie.           |
| **Pagina denominata**                      | Reindirizza a una pagina interna di Experience Builder.                | Vai a una pagina denominata "Supporto".      |
| **Pagina oggetto**                         | Vai a una vista elenco o a una pagina di nuovo record per un oggetto.  | Apri la vista elenco dei contatti.           |
| **Pagina record**                          | Collega alla pagina dei dettagli di un record specifico.               | Visualizza un record Account.                |
| **Pagina relazione record**                | Vai a un elenco correlato (ad esempio, le opportunità di un contatto). | Visualizza i casi di un account.             |
| **Pagina web**                             | Reindirizza a una pagina web esterna o interna.                        | Collega a un sito partner.                   |

*<mark style="background-color:green;">**Buona pratica**</mark>:* Scegli il tipo in base alla destinazione (ad esempio, Pagina record per i record); prova la navigazione nell’anteprima.

**Configurazione della navigazione verso una pagina specifica**

Per configurare la navigazione verso una pagina o una risorsa specifica, segui questi passaggi in base al tuo caso d’uso:

### **Vai a una pagina denominata**

1. Aggiungi un componente Button e vai alla **Interactions** scheda.
2. Seleziona **Naviga** e scegli **Pagina denominata**.
3. **Nome pagina:** Inserisci il nome API della pagina di destinazione (ad esempio, Content\_Document\_\_c).
4. *Perché questo?* Indirizza gli utenti a una pagina interna (ad esempio, una pagina di documento di contenuto) definita in Experience Builder.

<figure><img src="/files/93fec1c653bffab9e01944604d36382d9d27bfad" alt=""><figcaption></figcaption></figure>

### **Vai a una pagina record**

Usa questa opzione quando vuoi che un pulsante o un componente apra la pagina dei dettagli di un record specifico nel tuo sito Experience Cloud

#### Passaggi di configurazione

1. Seleziona **Naviga** e scegli **Pagina record**.
2. **Nome API oggetto:** Inserisci l’oggetto (ad esempio, Contact).
3. **ID record:** Seleziona il campo corretto dell’ID record per il reindirizzamento; di solito è “**`Record: Id`**”.
4. **Nome azione:** Imposta su View (predefinito per i dettagli).

*Perché questo?* Porta gli utenti alla pagina dei dettagli di un record specifico (ad esempio, un record Contact).

<figure><img src="/files/1d5af4fe648238171238f200b85d2d5085ad26fa" alt="" width="304"><figcaption></figcaption></figure>

{% hint style="warning" %}

#### Importante

Per assicurarti che la navigazione a una pagina record funzioni correttamente, crea prima la Pagina oggetto nel tuo sito Experience in cui deve arrivare l’interazione Navigate. Se questa pagina non esiste, l’interazione Navigate to Record Page non funzionerà.
{% endhint %}

### **Vai a una pagina web esterna**

Usa questa opzione quando vuoi che un pulsante o un componente apra un sito esterno o un’altra risorsa web, come il tuo sito principale, un portale partner o una pagina di documentazione

#### Passaggi di configurazione

1. Scegli l’ **Naviga** interazione e seleziona l’ **Pagina web** opzione.
2. **URL di destinazione:** Puoi:
   * Selezionare un campo (ad esempio, un campo formula sul record che memorizza l’URL) per impostare dinamicamente la destinazione del reindirizzamento.
   * Oppure, scegliere **Personalizzato** e inserire manualmente un URL esterno (ad esempio, <https://www.example.com>).
3. **Perché questo?** Questa opzione reindirizza gli utenti a un sito web o a una risorsa esterna, migliorando la connettività del sito.
4. **Risoluzione dei problemi:** Se la navigazione non funziona, verifica che l’URL o il valore del campo selezionato siano validi e assicurati che l’utente disponga delle autorizzazioni necessarie per accedere al sito di destinazione.

### **Passaggio di parametri URL con Navigate to Named Page**

Questa funzione ti consente di inviare dati dinamici (ad esempio, un ID record) a una pagina di destinazione, personalizzandone il contenuto in base al contesto dell’utente. È perfetta per creare esperienze personalizzate, ad esempio mostrare i dettagli di un record specifico in una nuova pagina.

<figure><img src="/files/1ef5907b1aaf534cff58d84151a80c376ea0069c" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

#### **Configura la pagina di destinazione**

Aggiungi un componente come Avonni Record Detail alla pagina di destinazione (ad esempio, CustomerDetails). Nel relativo attributo "Record ID", usa l’espressione {!Route.recordId} per acquisire un parametro URL chiamato recordId.

<figure><img src="/files/8639e2ad9419ef0df390e8fe9ca0d56842dfed48" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### **Configura il pulsante**

Nella pagina di origine (ad esempio, la home page), aggiungi un Avonni Button. Nelle **Naviga** impostazioni, scegli **Pagina denominata** e inserisci il nome API (ad esempio, CustomerDetails).
{% endstep %}

{% step %}

#### **Aggiungi parametri**

* **Nome:** Inserisci recordId (corrispondente all’attributo del componente di destinazione).
* **Valore:** Seleziona un campo (ad esempio, {!Record.Id}) oppure inserisci un ID record specifico da passare.

<figure><img src="/files/83166664f881035537a9e0286ec1c404e2e7729e" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
*Perché è utile*

Questa funzione ti consente di inviare dati dinamici (ad esempio, un ID record) alla pagina di destinazione, personalizzandone il contenuto. Ad esempio, facendo clic su un pulsante nella home page gli utenti possono essere portati a una pagina CustomerDetails che mostra le informazioni di uno specifico Contact in base al recordId passato.
{% endstep %}

{% step %}
*Analogia*

Pensala come l’indirizzamento di una lettera: Navigate to Named Page è la busta e il parametro URL (ad esempio, recordId) è l’indirizzo, che indica al sistema dove andare e quali dati recuperare
{% endstep %}

{% step %}
*Risoluzione dei problemi*

Se la pagina di destinazione non viene caricata correttamente, verifica che il parametro recordId corrisponda all’attributo del componente di destinazione e che l’ID sia valido.
{% endstep %}
{% endstepper %}

### **Vai a un articolo Knowledge**

1. Seleziona **Naviga** e scegli **Articolo Knowledge**.
2. **Nome URL:** Inserisci l’espressione `{{Record.UrlName}}` per collegarti dinamicamente all’articolo Knowledge associato al record corrente.
3. *Perché questo?* Indirizza gli utenti a una pagina di articolo Knowledge specifica in base al `UrlName` campo del record corrente, semplificando l’accesso ai contenuti di supporto.
4. *Suggerimento:* La `{{Record.UrlName}}` l’espressione usa la sintassi LWR per recuperare il nome URL univoco dell’articolo Knowledge (ad esempio, da un record correlato). Assicurati che il record abbia un `UrlName` campo valido popolato.
5. *Risoluzione dei problemi:* Se la navigazione non riesce, verifica che il `UrlName` campo esista e contenga un segmento URL valido dell’articolo Knowledge (ad esempio, article-title); controlla le autorizzazioni dell’utente per accedere all’articolo.

***

## Esempi

### **Esempio 1: vai alla pagina di supporto**

Questo esempio aggiunge un pulsante per navigare a una pagina di supporto in un sito Experience Cloud.

1. **Configura il pulsante:**
   * **Etichetta:** "Get Support"
   * **Nome icona:** utility:help
   * **Variante:** neutral
   * *Perché questo?* Crea un pulsante di aiuto per assistere gli utenti.
2. **Imposta collegamento all’interazione:**
   * **Navigate:**
     * **Tipo:** Pagina denominata
     * **Nome pagina:** Customer\_Support\_\_c
     * *Perché questo?* Reindirizza alla pagina CustomerSupport definita in Experience Builder.

**Risultato:** Gli utenti fanno clic sul pulsante da qualsiasi pagina, navigando alla pagina di supporto.

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

***

## Considerazioni chiave

* **Precisione della destinazione:** Assicurati che i nomi delle pagine o gli ID corrispondano esattamente.
* **Prestazioni:** Mantieni leggeri i target di navigazione.
* **Accessibilità:** Testa il focus e il contrasto del pulsante.
* **Sicurezza:** Valida gli URL esterni per evitare problemi.

***

## Risoluzione dei problemi comuni

* **La navigazione non funziona:** Controlla il tipo e la destinazione selezionati (ad esempio, Nome pagina o ID record corretti); verifica le autorizzazioni.
* **Pagina non trovata:** Assicurati che la pagina denominata o l’oggetto esista in Experience Builder.
* **L’ID dinamico non riesce:** Conferma che la sorgente dell’ID record (ad esempio, {!Record.Id}) sia valida.
* **Se i problemi persistono:** Contatta il nostro team di supporto all'indirizzo <support@avonni.com> per assistenza.

***

## Riepilogo

Il componente Avonni Navigate migliora i siti Experience Cloud con azioni di navigazione personalizzabili. È perfetto per guidare gli utenti verso pagine o risorse


---

# 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-it/pannello-proprieta/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.
