AX - Mappa
Panoramica
AX - Mappa è un componente di Experience Cloud che visualizza i record di Salesforce come marker di posizione interattivi su una mappa nelle pagine dei siti Experience.
Usalo per mostrare agli utenti del portale posizioni basate su campi di indirizzo o coordinate latitudine/longitudine—come sedi di servizi vicine, siti dei clienti, risultati dei localizzatori di negozi o sedi di eventi. Gli utenti possono cliccare sui marker per vedere i dettagli del record e navigare verso i record. Recupera i dati di posizione da qualsiasi oggetto standard o personalizzato in Experience Builder.
Perfetto per localizzatori di negozi, mappe di territori di servizio, ricerche di sedi di eventi, visualizzazioni di prossimità dei clienti o ovunque gli utenti del portale debbano visualizzare dati geografici.
La Mappa Avonni è un Componente Dati Reattivo
🎥 Tutorial
Impara a visualizzare i record su Experience Cloud usando Avonni Map.
Configurazione della Mappa
Capire il processo di configurazione, in particolare le sezioni Origine dati e Mappature dei dati, è fondamentale per utilizzare efficacemente questo componente.
Configurazione dell'origine dati
La sezione Origine dati è dove colleghi Avonni Map ai tuoi dati Salesforce. Hai due opzioni.

Origine dati manuale
Inserisci manualmente i dati nella tabella dati.
Ideale per dati non dinamici, test e demo.
Query
Crea una query per popolare automaticamente la tabella con i dati Salesforce.
Adatta per set di dati dinamici, in tempo reale e di grandi dimensioni.
Configurazione delle mappature dei dati
Nella sezione Mappature dei dati puoi attivare il tuo componente Mappa specificando come devono essere mappati i campi. Ciò comporta l'allineamento di campi come le coordinate di posizione dalla configurazione dell'origine dati con gli attributi della mappa corrispondenti.
Condivisione del modello dati con Avonni Map
Aderenza alle regole di condivisione dei dati di Salesforce:
Rispetto delle impostazioni dell'organizzazione: I componenti Avonni rispettano pienamente le configurazioni di condivisione dei dati esistenti e le impostazioni di accesso della tua organizzazione Salesforce.
Politica di non interferenza: Questi componenti non modificano né influenzano in alcun modo le regole di condivisione dei dati preesistenti.
Visibilità e accesso controllati: La possibilità di visualizzare e interagire con i record tramite i componenti Avonni è regolata dalle impostazioni di condivisione e dai permessi utente definiti dalla tua organizzazione
Devi concentrarti sulla sezione Posizione per assicurarti che le tue Mappature dei dati siano configurate correttamente, in particolare per la mappatura delle posizioni. Ecco perché:
Configurare le Mappature dei dati: Per garantire che il componente Mappa mostri le informazioni corrette, devi mappare i campi dei dati Salesforce alle etichette di posizione corrispondenti. Ad esempio, mapperai un campo Salesforce contenente gli indirizzi di strada all'etichetta 'street' nel componente Mappa, i nomi delle città all'etichetta 'city' e così via.
Importanza della precisione: Le mappature accurate sono fondamentali. Il componente Mappa potrebbe mostrare informazioni errate se il campo Salesforce sbagliato è mappato a un'etichetta di posizione. Ad esempio, se il campo 'city' è mappato erroneamente all'etichetta 'postal code', la mappa potrebbe mostrare una posizione in una città completamente diversa o addirittura in un altro paese.

Filtri
L'attributo Filtri ti permette di scegliere campi specifici che possono essere usati per filtrare e affinare i marker visualizzati sul componente mappa.

Altre impostazioni
Vista elenco
Questa funzione mostra o nasconde l'elenco delle posizioni. I valori validi sono visible, hidden o auto. Questo valore ha come predefinito auto, che mostra l'elenco solo quando sono presenti più marker.
Livello di zoom
Nel componente mappa puoi regolare il livello di zoom per concentrarti su aree diverse, dal mondo agli edifici singoli. Se non imposti un livello di zoom, la mappa si adatterà automaticamente per mostrare tutti i marker che hai posizionato.

Il pannello Proprietà ha un'opzione per impostare lo zoom manualmente. I livelli di zoom vanno da 1 a 22 sui browser desktop e da 1 a 20 sui dispositivi mobili.
Ecco una guida rapida a ciò che generalmente mostra ciascun livello di zoom:
Livello 1: L'intero mondo
Livello 5: Un continente o una grande massa terrestre
Livello 10: Una città
Livello 15: Dettagli a livello stradale
Livello 20: Edifici singoli
Consulta la documentazione delle API di Google Maps su Livelli di zoom per informazioni più approfondite.
Comportamento dell'interfaccia del componente Mappa

Queste impostazioni ti consentono di controllare come gli utenti interagiscono con la mappa, fornendo un'esperienza utente più snella e mirata. Dal disabilitare funzioni specifiche di zoom e trascinamento all'aggiunta di funzionalità utili come una barra di ricerca o un footer, ogni impostazione ha uno scopo distinto:
Disabilita trascinamento
Impedisce di spostare la mappa attraverso clic e trascinamento, mantenendola in una posizione fissa.
Nascondi controlli di zoom
Rimuove i controlli di zoom in/out, mantenendo un livello di zoom coerente sulla mappa.
Disabilita lo zoom con la rotella
Impedisce alla mappa di zoomare avanti o indietro con la rotella del mouse, garantendo un livello di zoom costante.
Disabilita lo zoom con doppio clic
Disabilita lo zoom effettuato con il doppio clic sulla mappa, mantenendo un livello di zoom fisso.
Disabilita interfaccia predefinita
Rimuove elementi standard dell'interfaccia della mappa come il toggle della vista strada, offrendo una visualizzazione della mappa più pulita.
Mostra piè di pagina
Mostra un footer sulla mappa per informazioni aggiuntive come le fonti dei dati della mappa o una legenda.
Ricercabile
Aggiunge una barra di ricerca alla mappa, consentendo agli utenti di trovare e ingrandire facilmente posizioni o punti specifici.
Posizione del centro mappa
Quando si usano più marker sulla mappa, la mappa si concentrerà automaticamente su un punto centrale vicino al centro di tutti i marker. Calcola questo punto in base alle loro posizioni.

Interazioni
Per il componente Mappa è disponibile un'interazione "on Select". Questa funzione ti permette di specificare quale azione deve verificarsi quando gli utenti cliccano su un marker della mappa.

Visualizza una breve notifica pop-up sullo schermo, fornendo un rapido feedback o informazione dopo aver cliccato un marcatore della mappa.
Reindirizza l’utente a una pagina diversa del tuo sito o a un URL, guidandolo verso informazioni più dettagliate sulla posizione cliccata.
Apre una finestra modale con un messaggio di avviso, presentando informazioni importanti o avvertimenti sulla posizione selezionata.
Attiva una finestra di dialogo di conferma, utilizzata per azioni che richiedono una conferma aggiuntiva da parte dell’utente, come la partecipazione a un evento.
Apre una finestra di dialogo che esegue un Salesforce Flow, avviando workflow o processi correlati alla posizione cliccata.
Impostazioni
Titolo elenco
Imposta un titolo per la tua lista mappa.
Vista elenco
Questa funzionalità è particolarmente utile per permettere agli utenti di vedere un elenco dettagliato dei luoghi o degli elementi sulla mappa.
Automatico: Determina automaticamente la vista migliore.
Visibile: Mantiene la vista elenco sempre visibile.
Nascosto: Nasconde la vista elenco.
Livello di zoom
I livelli di zoom vanno da 1 a 22 sui browser desktop e da 1 a 20 sui dispositivi mobili.
Ecco una guida rapida a ciò che generalmente mostra ciascun livello di zoom:
Livello 1: L'intero mondo
Livello 5: Un continente o una grande massa terrestre
Livello 10: Una città
Livello 15: Dettagli a livello stradale
Livello 20: Edifici singoli
Disabilita trascinamento
Impedisci agli utenti di trascinare la visuale della mappa.
Nascondi controlli di zoom
Rimuovi i controlli di zoom in/out dalla mappa
Disabilita lo zoom con la rotella
Disattiva lo zoom usando la rotella del mouse
Disabilita il doppio clic
Impedisci che il doppio clic ingrandisca la mappa
Disabilita interfaccia predefinita
Rimuovi l'interfaccia standard di Google Maps per un aspetto più pulito
Mostra piè di pagina
Aggiungi una sezione footer al componente mappa
Ricercabile
Abilita una funzione di ricerca all'interno della mappa
Fonte dati
Manuale: Aggiungi marker sulla mappa manualmente.
Query: Usa i dati di Salesforce con la mappatura dei dati per il posizionamento automatico dei marker
Posizione centrale della mappa
Specifica il punto centrale iniziale della mappa
Opzioni di filtro
Configura i filtri per la mappa, visualizzati come un popover
Opzioni motore di ricerca
Segnaposto: Testo visualizzato nella barra di ricerca prima dell'immissione.
Posizione: Scegli tra left, right, center o fill per la posizione della barra di ricerca
Dimensione
Larghezza e Altezza: Specifica le dimensioni del componente mappa.
"Overflow" si riferisce a come il contenuto che supera i confini del suo contenitore viene gestito o visualizzato. Quando il contenuto all'interno di un componente di layout è troppo grande per entrare nelle dimensioni assegnate (altezza e larghezza), l'impostazione di overflow determina cosa succede al contenuto in eccesso.
Overflow: Controlla come viene gestito il contenuto in overflow.
Ultimo aggiornamento
È stato utile?

