# Naviga ## Panoramica L’interazione Naviga consente di definire azioni di navigazione quando gli utenti interagiscono con i componenti, ad esempio cliccando un pulsante. Questa funzione permette il reindirizzamento fluido a vari tipi di pagina, migliorando il coinvolgimento degli utenti e creando un’esperienza di navigazione scorrevole sul tuo sito.
### **Caratteristiche principali** * Supporta più tipi di riferimenti di pagina * Azioni di navigazione personalizzabili * Migliora il flusso di navigazione del sito ### Casi d’uso * **Pagina prodotto:** Reindirizza a una pagina con specifiche dettagliate del prodotto. * **Pagina di supporto:** Naviga verso un articolo di aiuto o un modulo di contatto. * **Pagina della community:** Collega a un profilo membro o a una discussione. * **Pagina evento:** Indirizza a un modulo di registrazione all’evento. * **Pagina di destinazione:** Guida a una pagina dei dettagli della campagna. * **Pagina profilo:** Naviga verso record di contatto correlati. ## Configurazione Aggiungi l’interazione Naviga a un componente (es. Pulsante) su una pagina del sito Experience Cloud e configuralo tramite la scheda Interazioni in Experience Builder. ### **Tipi di navigazione disponibili** Questi tipi di riferimento di pagina specificano dove vengono indirizzati gli utenti. | Tipo di navigazione | Descrizione | Esempio di utilizzo | | ------------------------------------------ | ------------------------------------------------------------------------ | ------------------------------------------ | | **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 ai record correlati (es. Contatti di un Account). | Visualizza le Opportunità di un Account. | | **Aura - Pagina di accesso** | Attiva azioni di accesso o disconnessione. | Accedi per accedere a contenuti riservati. | | **Articolo Knowledge** | Indirizza a uno specifico articolo di Knowledge. | Accedi a un articolo di supporto. | | **Pagina contenuto gestito** | Collega a una pagina di contenuti gestita dal CMS. | Visualizza un articolo di notizie. | | **Pagina nominata** | Reindirizza a una pagina interna di Experience Builder. | Vai a una pagina nominata "Support". | | **Pagina oggetto** | Naviga 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** | Naviga a una lista correlata (es. Opportunità di un Contatto). | Visualizza i Case per un Account. | | **Pagina web** | Reindirizza a una pagina web esterna o interna. | Collega a un sito partner. | ***Buone pratiche**:* Scegli il tipo in base alla destinazione (es. Pagina Record per i record); testa la navigazione in anteprima. **Configurare la navigazione verso una pagina specifica** Per impostare la navigazione verso una pagina o una risorsa specifica, segui questi passaggi in base al tuo caso d’uso: ### **Navigare verso una pagina nominata** 1. Aggiungi un componente Pulsante e vai a **Interazioni** Scheda. 2. Seleziona **Naviga** e scegli **Pagina nominata**. 3. **Nome pagina:** Inserisci il nome API della pagina di destinazione (es. Content\_Document\_\_c). 4. *Perché questo?* Indirizza gli utenti a una pagina interna (es. una pagina documento di contenuto) definita in Experience Builder.
### **Navigare verso una pagina record** Usa questa opzione quando vuoi che un pulsante o un componente apra la pagina dei dettagli di uno specifico record nel tuo sito Experience Cloud #### Passaggi di configurazione 1. Seleziona **Naviga** e scegli **Pagina record**. 2. **Nome API oggetto:** Inserisci l’oggetto (es. Contact). 3. **ID record:** Seleziona il campo ID record corretto per il reindirizzamento; solitamente è “**`Record: Id`**”. 4. **Nome azione:** Imposta su Visualizza (predefinito per i dettagli). *Perché questo?* Porta gli utenti alla pagina dei dettagli di uno specifico record (es. un record Contatto).
{% hint style="warning" %} #### Importante Per assicurare che la navigazione verso una pagina record funzioni correttamente, crea prima la Pagina Oggetto sul tuo sito Experience dove l’interazione Naviga dovrebbe atterrare. Se questa pagina non esiste, l’interazione Naviga verso Pagina Record non funzionerà. {% endhint %} ### **Navigare verso 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 (es. un campo formula sul record che memorizza l’URL) per impostare dinamicamente l’obiettivo del reindirizzamento. * Oppure, scegli **Personalizzato** e inserisci manualmente un URL esterno (es. ). 3. **Perché questo?** Questa opzione reindirizza gli utenti a un sito o 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 sia valido e assicurati che l’utente abbia le autorizzazioni necessarie per accedere al sito di destinazione. ### **Passaggio di parametri URL con Naviga verso pagina nominata** Questa funzione ti permette di inviare dati dinamici (es. un ID record) a una pagina di destinazione, personalizzando il suo contenuto in base al contesto dell’utente. È perfetta per creare esperienze personalizzate, come mostrare i dettagli di un record specifico su una nuova pagina.
{% stepper %} {% step %} #### **Configura la pagina di destinazione** Aggiungi un componente come Avonni Record Detail alla pagina di destinazione (es. CustomerDetails). Nel suo attributo "Record ID", usa l’espressione {!Route.recordId} per catturare un parametro URL chiamato recordId.
{% endstep %} {% step %} #### **Configura il pulsante** Nella pagina di origine (es. homepage), aggiungi un Avonni Button. Nelle **Naviga** impostazioni, scegli **Pagina nominata** e inserisci il nome API (es. CustomerDetails). {% endstep %} {% step %} #### **Aggiungi parametri** * **Nome:** Inserisci recordId (corrispondente all’attributo del componente di destinazione). * **Valore:** Seleziona un campo (es. {!Record.Id}) o inserisci un ID record specifico da passare.
{% endstep %} {% step %} *Perché è utile* Questa funzione ti permette di inviare dati dinamici (es. un ID record) alla pagina di destinazione, personalizzandone il contenuto. Per esempio, cliccando un pulsante nella homepage puoi portare gli utenti a una pagina CustomerDetails che mostra le informazioni di uno specifico Contatto basate sul recordId passato. {% endstep %} {% step %} *Analogia* Pensalo come indirizzare una lettera—il Naviga verso pagina nominata è la busta, e il parametro URL (es. recordId) è l’indirizzo, che dice al sistema dove andare e quali dati portare {% endstep %} {% step %} *Risoluzione dei problemi* Se la pagina di destinazione non si carica correttamente, assicurati che il parametro recordId corrisponda all’attributo del componente di destinazione e che l’ID sia valido. {% endstep %} {% endstepper %} ### **Navigare verso 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 specifica pagina articolo di Knowledge basata sul campo `UrlName` del record corrente, semplificando l’accesso ai contenuti di supporto. 4. *Suggerimento:* L’ `{{Record.UrlName}}` espressione usa la sintassi LWR per estrarre il nome URL univoco dell’articolo Knowledge (es. da un record correlato). Assicurati che il record abbia un `UrlName` campo valorizzato. 5. *Risoluzione dei problemi:* Se la navigazione fallisce, verifica che il `UrlName` campo esista e contenga un segmento URL valido per l’articolo Knowledge (es. article-title); controlla le autorizzazioni utente per accedere all’articolo. *** ## Esempi ### **Esempio 1: Naviga alla pagina di supporto** Questo esempio aggiunge un pulsante per navigare a una pagina di supporto su un sito Experience Cloud. 1. **Configura il pulsante:** * **Etichetta:** "Ricevi supporto" * **Nome icona:** utility:help * **Variante:** neutra * *Perché questo?* Crea un pulsante di aiuto per l’assistenza agli utenti. 2. **Imposta Collegamento a Interazione:** * **Naviga:** * **Tipo:** Pagina nominata * **Nome pagina:** Customer\_Support\_\_c * *Perché questo?* Reindirizza alla pagina CustomerSupport definita in Experience Builder. **Risultato:** Gli utenti cliccano il pulsante su qualsiasi pagina e vengono indirizzati alla pagina di supporto.
*** ## Considerazioni chiave * **Precisione della destinazione:** Assicurati che i nomi delle pagine o gli ID corrispondano esattamente. * **Prestazioni:** Mantieni leggere le destinazioni di navigazione. * **Accessibilità:** Testa la messa a fuoco e il contrasto del pulsante. * **Sicurezza:** Valida gli URL esterni per prevenire problemi. *** ## Risoluzione dei problemi comuni * **La navigazione non funziona:** Controlla il tipo selezionato e la destinazione (es. Nome pagina corretto o ID record); verifica le autorizzazioni. * **Pagina non trovata:** Assicurati che la pagina nominata o l’oggetto esistano in Experience Builder. * **ID dinamico non valido:** Conferma che la fonte dell’ID record (es. {!Record.Id}) sia valida. * **Se i problemi persistono:** Contatta il nostro team di supporto a 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: 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: ``` GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-it/pannello-proprieta/interazioni/naviga.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.