Carte

La carte Avonni affiche une carte d’un lieu spécifique. Elle peut vous aider à situer un endroit ou à obtenir un itinéraire.

Note sur les fonctionnalités avancées de la carte

Pour des fonctionnalités avancées telles que regroupement de cartes, interactif dessin, et travailler avec GeoJSON données, nous recommandons d'utiliser le composant Avonni Map pour Screen Flows

Configurer votre carte

Pour commencer avec le composant Avonni Map, vous devez d'abord choisir un type de carte et configurer la manière dont vos données sont affichées.

Connexion de vos données de localisation

Le Source de données est ce qui fournit cette liste d’épingles—ou repères—à votre Avonni Map. Chaque enregistrement récupéré depuis votre source de données (comme un Compte, un Contact, ou un objet personnalisé) sera tracé comme un point sur la carte, à condition qu’il contienne des informations de localisation, y compris une adresse postale ou des coordonnées de latitude et longitude spécifiques.

Pour fournir ces données de localisation, choisissez l’une des options suivantes dans la propriété "Source de données".

Manuel

Saisir les données de localisation directement dans la configuration du composant. Cela convient pour un petit ensemble statique de repères qui ne changera pas souvent.

Variable

Utiliser une variable comme source de données. Cela est utile pour afficher des emplacements qui changent en fonction des interactions de l’utilisateur ou d’autres logiques du composant.

Requête

Récupérer des données directement depuis Salesforce en utilisant une requête Avonni. C’est l’option la plus courante et la plus puissante pour afficher un ensemble dynamique d’enregistrements Salesforce sur la carte.

Mapper vos données de localisation

Connectez vos champs Salesforce aux attributs d’Avonni Map pour afficher les informations correctes. Par exemple, liez votre champ "Adresse" à l’attribut "address" sur la carte.

Choisir un type de carte

Le composant Avonni Map propose deux fournisseurs de cartographie puissants : Google Maps et Leaflet. Votre choix détermine l’apparence de la carte, ses performances avec de grands jeux de données et les fonctionnalités interactives disponibles. Voici un aperçu pour vous aider à sélectionner la meilleure option pour votre cas d’usage.

Google Maps : pour la simplicité et la familiarité

Choisissez Google Maps pour une interface conviviale et immédiatement reconnue. C’est une excellente option pour des cartes simples qui ne nécessitent pas l’affichage d’un très grand nombre de repères.

• Points forts : Comprend des fonctionnalités intégrées familières comme Street View et l’imagerie satellite. Il peut tracer des emplacements directement à partir d’adresses postales sans avoir besoin de coordonnées.

• Considération clé : Google Maps est préférable pour l’affichage d’un plus petit nombre d’emplacements, avec une limite technique de 100 repères par carte.

Leaflet : pour les volumes de données importants et les fonctionnalités avancées

Sélectionnez Leaflet lorsque vous avez besoin d’une carte hautement interactive avec des capacités avancées ou que vous devez afficher un grand nombre de repères.

• Points forts : Leaflet est très performant et peut gérer des centaines ou des milliers de repères. Il offre des fonctionnalités puissantes comme le regroupement de repères (regroupement des points proches), des outils de dessininteractifs, et un riche GeoJSON support pour les formes personnalisées.

• Considération clé : Leaflet nécessite des coordonnées de latitude et longitude spécifiques pour chaque enregistrement que vous souhaitez tracer. Il ne peut pas convertir automatiquement les adresses postales en points de la carte.

Guide rapide : lequel utiliser ?

• Utilisez Google Maps si... vous avez moins de 100 repères à afficher et souhaitez la simplicité d’utilisation des adresses postales.

• Utilisez Leaflet si... vous devez afficher un grand volume de repères, avez besoin de fonctionnalités avancées comme le dessin ou le regroupement, ET disposez de données de latitude/longitude pour vos enregistrements.

Personnalisation de l’apparence des repères

Au-delà du simple placement des repères sur la carte, vous pouvez contrôler précisément leur apparence visuelle pour chaque enregistrement. Cela se fait dans la Mappages de données section des propriétés du composant Map, vous permettant de créer un rendu qui correspond à votre marque ou transmet des informations spécifiques d’un coup d’œil.

Comment configurer l’apparence des repères

1. Sélectionnez le composant Map et naviguez vers la Mappages de données section dans le panneau des propriétés. C’est ici que vous connectez les champs de votre source de données aux propriétés visuelles de la carte.

2. Repérez le Type attribut dans la liste des options de mappage disponibles.

Méthode 1 : utiliser des formes de repères prédéfinies

Pour un rendu cohérent, vous pouvez définir l’ Type attribut sur une valeur de texte statique. Tous les repères de votre carte utiliseront alors cette forme.

• Configuration : Min/Max : Type attribut sur l’une de ces valeurs de texte :

  • par défaut : Un repère de carte simple et standard.

  • circle : Un repère circulaire.

  • rectangle : Un repère rectangulaire.

  • polygon : Un repère à plusieurs côtés.

  • pin : Le repère classique en forme d’épingle.

Méthode 2 : utiliser une icône personnalisée

Pour utiliser votre propre image de marque ou des images spécifiques, vous pouvez configurer la carte pour utiliser une image SVG personnalisée pour les repères. Cela se fait généralement en définissant l’ Type sur icon et en mappant un autre attribut (comme iconUrl ou iconName) à un champ de votre source de données contenant l’URL ou le nom du SVG.

Personnalisation supplémentaire

Dans la section Data Mappings, vous pouvez souvent configurer des attributs supplémentaires pour affiner l’apparence du repère sélectionné Type:

• Couleur de remplissage et opacité : Contrôlez la couleur principale du repère et sa transparence.

• Contour : Personnalisez la bordure du repère (sa couleur, son épaisseur et son style comme plein ou en pointillés).

• Échelle : Ajustez la taille globale du repère.

La puissance du style dynamique

Parce que ces attributs d’apparence (Type, Couleur de remplissage, Échelle, etc.) sont configurés dans Mappages de données, vous pouvez les rendre pilotés par les données. Au lieu de définir une valeur statique pour tous les repères, vous pouvez mapper ces attributs à des champs de votre source de données.

• https://docs.google.com/gview?embedded=true&url=[votre URL PDF] Vous pourriez avoir un champ de formule sur votre objet Compte qui renvoie une couleur en fonction du secteur . En mappant l’ Couleur de remplissage attribut de la carte à ce champ de formule, les repères de vos Comptes seront automatiquement colorés par secteur sur la carte, fournissant un aperçu visuel instantané

Configurer votre carte

L’Avonni Map n’est pas seulement une vue statique — c’est un outil dynamique que vous pouvez façonner pour montrer les emplacements exactement comme vous en avez besoin. Ces options de personnalisation vous permettent de contrôler où elle se concentre, comment elle apparaît et ce que les utilisateurs peuvent faire, transformant une carte basique en un outil puissant pour explorer et gérer les données.

Centrer la carte

Le point de vue initial de votre carte — où elle est « centrée » lorsqu’elle se charge pour la première fois — est configuré dans la Emplacement du centre de la carte section du panneau des propriétés. Cela assure que vos utilisateurs commencent en regardant la zone géographique la plus pertinente.

Dans cette section, vous avez plusieurs façons de définir ce point central :

• Centre par défaut : Laissez les paramètres par défaut pour afficher une vue standard du monde, permettant à l’utilisateur de naviguer depuis une perspective globale. C’est une bonne option si vous affichez des repères à travers de nombreuses régions différentes.

• Spécifier par coordonnées : Pour un centrage précis, vous pouvez saisir manuellement des latitude et longitude valeurs. C’est idéal lorsque vous connaissez les coordonnées exactes du point focal souhaité.

• Spécifier par adresse : Fournissez un emplacement en utilisant des champs composants d’adresse, tels que rue, ville, état et pays. La carte géocodera ensuite cette adresse pour déterminer le point central. Cela est utile lorsque vous disposez de données d’adresse mais pas de coordonnées spécifiques.

• Définir le centre dynamiquement avec des ressources : N’importe quel champ de coordonnées ou d’adresse peut être lié à ressources de variable ou à des attributs d’autres composants. Cela permet au centre de la carte de changer dynamiquement en fonction des saisies de l’utilisateur ou d’autres données sur la page (par ex. centrer la carte sur l’adresse d’un enregistrement sélectionné).

Vous pouvez également activer l’option Afficher le centre comme repère , qui place une épingle distincte au point central calculé de la carte pour identifier facilement le point de vue initial.

Niveau de zoom

Le zoom contrôle à quel point votre carte est rapprochée ou éloignée au démarrage, définissant le niveau de détail que les utilisateurs voient immédiatement.

• Ajuster le niveau de zoom initial :

  • Choisissez un niveau de zoom de 1 (vue mondiale) à 22 (niveau bâtiment).

En-tête

L’en-tête est la barre supérieure de la carte, lui donnant un nom et des outils d’interaction. Le personnaliser ajoute de la clarté et du contrôle, faisant de la carte plus qu’une image — elle devient une partie étiquetée et exploitable de votre interface.

• Personnaliser l’en-tête de la carte :

  • Titre, légende, icône, est joint, boutons : Configurer les éléments de l’en-tête.

Filtrage et recherche

Ces outils permettent aux utilisateurs de réduire ou de trouver des données spécifiques sur la carte, en coupant l’encombrement pour se concentrer sur ce dont ils ont besoin.

• Options de filtrage : Ajouter un menu de filtre pour affiner les données de la carte.

• Options de recherche : Activer la fonctionnalité de recherche pour des champs spécifiques.

Vue Liste

La vue Liste associe une liste textuelle à votre carte, affichant tous les emplacements dans une barre latérale cliquable. C’est comme une table des matières — permettant aux utilisateurs de parcourir ou de sauter entre les repères sans déplacer la carte.

• Afficher ou masquer la liste des emplacements :

  • Choisissez entre visible, masqué ou auto (par défaut).

Interactions de la carte

Les interactions transforment votre carte d’un affichage statique en un outil dynamique sur lequel vos utilisateurs peuvent agir. En configurant les interactions, vous pouvez définir précisément ce qui se passe lorsqu’un utilisateur clique sur un repère de la carte ou sur un bouton dans l’en-tête de la carte. Vous trouverez ces paramètres dans la Interactions section des propriétés du composant Map.

Au clic sur un repère

Cet événement se déclenche chaque fois qu’un utilisateur clique sur un repère spécifique de la carte. C’est le moyen principal de rendre vos points de données interactifs.

• Accéder aux données du repère : Dans la configuration de l’interaction, vous pouvez accéder aux données du repère qui a été cliqué. Par exemple, pour obtenir l’ID de l’enregistrement associé au repère, vous utiliseriez généralement le sélecteur de ressources pour choisir Événement du composant > marker > value (en supposant que la valeur du repère ait été mappée à l’ID de l’enregistrement dans la section Data Mappings).

• Cas d’utilisation courants :

  • Naviguer vers l’enregistrement : Configurer une Maps interaction pour ouvrir la page complète de l’enregistrement du repère cliqué.

  • Ouvrir les détails dans une boîte de dialogue ou un panneau : utilisez les interactions "Ouvrir la boîte de dialogue Flow", "Ouvrir le panneau Flow" ou "Ouvrir la boîte de dialogue/panneau de composant dynamique" pour afficher plus de détails ou fournir des capacités d’édition pour l’enregistrement sélectionné sans quitter la carte.

  • Afficher des infos rapides : Utilisez une interaction Afficher Toast pour afficher de brèves informations sur l’emplacement sélectionné.

Au clic sur une action d'en-tête

Cet événement se déclenche lorsqu’un utilisateur clique sur un bouton personnalisé que vous avez ajouté à la En-tête section de l’en-tête de la carte. Ces actions s’appliquent à l’ensemble de la carte ou du jeu de données, pas seulement à un repère.

• Cas d’utilisation courants :

  • Actualiser les données : Ajoutez un bouton « Actualiser » qui déclenche une Rafraîchir la requête interaction pour recharger tous les repères de la carte avec les dernières données.

  • Ajouter un nouvel enregistrement : Ajoutez un bouton qui lance une "Ouvrir la boîte de dialogue Flow" pour guider les utilisateurs dans la création d’un nouvel enregistrement qui apparaîtra ensuite sur la carte (après un rafraîchissement).

  • Voir le rapport : Ajoutez un bouton qui utilise une Maps interaction pour emmener l’utilisateur vers un rapport ou un tableau de bord Salesforce associé.

En configurant ces interactions, vous transformez votre carte d’un simple affichage visuel en un centre interactif pour explorer, mettre à jour et agir sur vos données géographiques directement là où les utilisateurs les voient