Page cover

Carte

Aperçu

Le composant Avonni Map améliore les sites Salesforce Experience Cloud en intégrant des cartes interactives. Ce document décrit les différents paramètres disponibles pour personnaliser le composant de carte.

🎥 Tutoriels

Nom
Description

Apprenez à afficher des enregistrements sur Experience Cloud en utilisant Avonni Map.

Configuration de la carte

Comprendre le processus de configuration, en particulier les sections Source de données et Mappages de données, est essentiel pour utiliser ce composant efficacement.

Configuration de la source de données

La section Source de données est l'endroit où vous connectez Avonni Map à vos données Salesforce. Vous avez deux options.

Type de source de données
Description
Cas d'utilisation

Source de données manuelle

Saisir manuellement des données dans la table de données.

Idéal pour les données non dynamiques, les tests et les démos.

Requête

Créer une requête pour autopopuler la table avec des données Salesforce.

Adapté aux ensembles de données dynamiques, en temps réel et volumineux.

Configuration des mappages de données

Dans la section Mappages de données, vous pouvez activer votre composant Map en spécifiant comment les champs doivent être mappés. Cela implique d'aligner des champs comme les coordonnées de localisation provenant de votre configuration de source de données avec les attributs pertinents de la carte.

Partage du modèle de données avec Avonni Map

Respect des règles de partage des données Salesforce :

  • Respect des paramètres de l'org : Les composants Avonni sont entièrement conformes aux configurations et paramètres d'accès de partage de données existants de votre organisation Salesforce.

  • Politique de non-interférence : Ces composants ne modifient ni n'affectent en rien vos règles de partage de données préétablies.

  • Visibilité et accès contrôlés : La possibilité de visualiser et d'interagir avec des enregistrements via les composants Avonni est régie par les paramètres de partage et les autorisations utilisateur définis par votre organisation

Vous devez vous concentrer sur la section Localisation pour vous assurer que vos Mappages de données sont correctement configurés, en particulier pour le mappage des emplacements. Voici pourquoi :

  1. Configuration des mappages de données: Pour garantir que le composant Carte affiche les bonnes informations, vous devez mapper les champs de données Salesforce aux étiquettes de localisation correspondantes. Par exemple, vous mapperez un champ Salesforce contenant des adresses de rue à l'étiquette « street » du composant Carte, les noms de ville à l'étiquette « city », et ainsi de suite.

  2. Importance de l'exactitude: Des mappages précis sont essentiels. Le composant Carte peut afficher des informations incorrectes si le mauvais champ Salesforce est mappé à une étiquette de localisation. Par exemple, si le champ « city » est incorrectement mappé à l'étiquette « postal code », la carte peut afficher un emplacement dans une ville totalement différente ou même dans un autre pays.

Filtres

L'attribut Filtres vous permet de choisir des champs spécifiques pouvant être utilisés pour filtrer et affiner les marqueurs affichés sur le composant de carte.

Autres paramètres

Affichage en liste

Cette fonction affiche ou masque la liste des emplacements. Les valeurs valides sont visible, hidden ou auto. Cette valeur par défaut est auto, qui affiche la liste uniquement lorsque plusieurs marqueurs sont présents.

Niveau de zoom

Dans le composant de carte, vous pouvez ajuster le niveau de zoom pour vous concentrer sur différentes zones, du monde entier aux bâtiments individuels. Si vous ne définissez pas de niveau de zoom, la carte s'ajustera automatiquement pour afficher tous les marqueurs que vous y avez placés.

Le panneau Propriétés propose une option pour régler le zoom manuellement. Les niveaux de zoom vont de 1 à 22 sur les navigateurs de bureau et de 1 à 20 sur les appareils mobiles.

Voici un guide rapide de ce que chaque niveau de zoom montre généralement :

  • Niveau 1 : Le monde entier

  • Niveau 5 : Un continent ou une grande masse terrestre

  • Niveau 10 : Une ville

  • Niveau 15 : Détails au niveau de la rue

  • Niveau 20 : Bâtiments individuels

Reportez-vous à la documentation de l'API Google Maps sur Niveaux de zoom pour des informations plus approfondies.

Comportement de l'interface du composant de carte

Ces paramètres vous permettent de contrôler la façon dont les utilisateurs interagissent avec la carte, offrant une expérience utilisateur plus fluide et ciblée. Qu'il s'agisse de désactiver des fonctions de zoom et de glisser spécifiques ou d'ajouter des fonctionnalités utiles comme une barre de recherche ou un pied de page, chaque paramètre a un objectif distinct :

Paramètre
Description

Désactiver le glissement

Empêche de déplacer la carte via cliquer-et-glisser, la maintenant dans une position fixe.

Masquer les contrôles de zoom

Supprime les contrôles de zoom avant/arrière, maintenant un niveau de zoom cohérent sur la carte.

Désactiver le zoom par molette

Empêche la carte de zoomer ou dézoomer avec la molette de la souris, garantissant un niveau de zoom stable.

Désactiver le double-clic pour zoomer

Désactive le zoom lors d'un double-clic sur la carte, maintenant un niveau de zoom fixe.

Désactiver l'interface par défaut

Supprime les éléments d'interface standard de la carte comme le basculement Street View, offrant un affichage de carte plus épuré.

Afficher le pied de page

Affiche un pied de page sur la carte pour des informations supplémentaires telles que les sources des données cartographiques ou une légende.

Consultable

Ajoute une barre de recherche à la carte, permettant aux utilisateurs de trouver et de zoomer facilement sur des emplacements ou des points spécifiques.

Emplacement du centre de la carte

Lors de l'utilisation de plusieurs marqueurs sur la carte, la carte se concentrera automatiquement sur un point central proche du milieu de tous les marqueurs. Elle calcule ce point en fonction de leurs emplacements.

Interactions

Pour le composant Carte, il propose une interaction « on Select ». Cette fonction vous permet de spécifier quelle action doit se produire lorsque les utilisateurs cliquent sur un marqueur de carte.

Type d'interaction
Description

Affiche une brève notification contextuelle à l'écran, fournissant un retour ou une information rapide après avoir cliqué sur un marqueur de carte.

Redirige l'utilisateur vers une page différente de votre site ou une URL, le guidant vers des informations plus détaillées sur l'emplacement cliqué.

Ouvre une fenêtre modale avec un message d'alerte, présentant des informations importantes ou des avertissements concernant l'emplacement sélectionné.

Déclenche une boîte de dialogue de confirmation, utilisée pour les actions nécessitant une confirmation supplémentaire de l'utilisateur, comme la participation à un événement.

Ouvre une boîte de dialogue qui exécute un Flow Salesforce, initiant des workflows ou des processus liés à l'emplacement cliqué.

Paramètres

Nom
Description

Titre de la liste

Définissez un titre pour votre liste de carte.

Affichage en liste

Cette fonctionnalité est particulièrement utile pour que les utilisateurs puissent voir une liste détaillée des lieux ou des éléments sur la carte.

  • Auto: Détermine automatiquement la meilleure vue.

  • Visible: Garde la vue en liste toujours visible.

  • Hidden: Masque la vue en liste.

Niveau de zoom

Les niveaux de zoom vont de 1 à 22 sur les navigateurs de bureau et de 1 à 20 sur les appareils mobiles.

Voici un guide rapide de ce que chaque niveau de zoom montre généralement :

  • Niveau 1 : Le monde entier

  • Niveau 5 : Un continent ou une grande masse terrestre

  • Niveau 10 : Une ville

  • Niveau 15 : Détails au niveau de la rue

  • Niveau 20 : Bâtiments individuels

Désactiver le glissement

Empêcher les utilisateurs de faire glisser la vue de la carte.

Masquer les contrôles de zoom

Supprimer les contrôles de zoom avant/arrière de la carte

Désactiver le zoom par molette

Désactiver le zoom à l'aide de la molette de la souris

Désactiver le double clic

Empêcher le double-clic de zoomer sur la carte

Désactiver l'interface par défaut

Supprimer l'interface Google Maps standard pour un aspect plus épuré

Afficher le pied de page

Ajouter une section de pied de page au composant de carte

Consultable

Activer une fonction de recherche dans la carte

Source de données

  • Manuel: Ajouter des marqueurs sur la carte manuellement.

  • Requête: Utiliser les données Salesforce avec le mappage des données pour le placement automatique des marqueurs

Emplacement du centre de la carte

Spécifier le point central initial de la carte

Options de filtrage

Configurer des filtres pour la carte, affichés sous forme de popover

Options du moteur de recherche

  • Espace réservé: Texte affiché dans la barre de recherche avant la saisie.

  • Position: Choisir parmi left, right, center ou fill pour la position de la barre de recherche

Taille

  • Largeur et hauteur: Spécifier les dimensions du composant de carte.

"Débordement" fait référence à la manière dont le contenu qui dépasse les limites de son conteneur est géré ou affiché. Lorsque le contenu à l'intérieur d'un composant de mise en page est trop volumineux pour tenir dans les dimensions assignées (hauteur et largeur), le paramètre overflow détermine ce qui arrive au contenu excédentaire.

  • Débordement: Contrôler la façon dont le contenu débordant est géré.

Mis à jour

Ce contenu vous a-t-il été utile ?