Google Maps
YellowBox Store
Objet
Le plugin Google Maps permet à l’administrateur de géocoder des adresses renseignées dans YellowBox CRM et d’intégrer au sein d’écrans utilisateurs un composant permettant de visualiser sur une carte géographique une sélection de fiches géocodées.
Exemple de visuel
Plugin Google Maps paramétré de manière à visualiser sur une carte les sociétés situées à 3 kms alentours d’une société sélectionnée.
Installation
Le plugin est téléchargeable par l’administrateur depuis le YellowBox Store accessible via le bouton 
de la barre de notification.
- Cliquer sur le pavé du plugin pour voir le descriptif.
- Cliquer sur le bouton [Installer] pour télécharger dans la liste des plugins paramétrables dans votre YellowBox CRM.
- Ce plugin nécessite une activation car soumis à abonnement (cf. tarification en ligne dans le YellowBox Store).
Pré-requis : YellowBox CRM Version 7.7 ou supérieure
Paramétrage
Le plugin Google Maps peut faire l’objet de plusieurs utilisations dans la base YellowBox CRM. Pour chaque cas d’usage, il convient d’ajouter un paramétrage particulier.
Pour ce faire, accéder à la liste des plugins paramétrés via le menu administrateur ‘Traitements/Traitements/Plugins’.
- Ajouter un nouveau plugin paramétré en cliquant sur le bouton [+ Ajouter] du bandeau en entête.
Le paramétrage d’un plugin nécessite la réalisation des opérations suivantes :
- Donner un nom unique qui vous permettra de le repérer facilement par la suite
- Sélectionner le plugin désiré dans la listes des plugins téléchargés
- Sélectionner l’instance désirée
- Entrer les différents paramètres demandés
La description générale des éléments nécessaires au bon fonctionnement du plugin est accessible via le bouton
présent dans le paramétrage du plugin.
Les instances disponibles
Cinq instances sont disponibles avec ce plugin. Les quatre premières instances permettent de réaliser le géocodage des adresses sur une fiche en particulier ou sur un ensemble de fiches, à partir de la table adresse native ou de champs paramétrés dans la base. La cinquième instance permet de visualiser sur une carte les éléments géocodés.
CustomFieldsGeocodingFunction (Fonction)
Cette fonction permet de géocoder une adresse à partir de champs créés par l’administrateur sur une fiche. Des champs complémentaires à l’adresse postale classique seront nécessaires pour consigner le géocodage réalisé.
Concernant la consignation d’erreur de géocodage par le traitement, une case à cocher (booléen) doit être créé dans la table concernée et identifié dans les paramétrages de géocodage de ces champs.
Il sera nécessaire de mettre en place une règle pour qu’elle se décoche automatiquement dès modification d’un des champs de l’adresse, afin que son géocodage soit relancé.
CustomFieldsGlobalGeocodingfunction (Fonction)
Même fonction que la précédente sur un ensemble de fiches.
GenericAddressFieldsGeocodingFunction (Fonction)
Cette fonction permet le géocodage d’une fiche à partir de l’adresse saisie dans la table adresse. Tous les champs nécessaires à la géolocalisation sont natifs.
Dans le cas où l’adresse n’a pu être géocodée, la case ‘Erreur géocodage’ présente au niveau de l’adresse native est cochée automatiquement. Cette case à cocher est visible et requêtable.
GenericAddressFieldsGlobalGeocodingFunction (Fonction)
Même fonction que la précédente sur un ensemble de fiches.
Googlemaps (composant)
Permet de paramétrer le plugin pour visualiser les données issues d’une liste ou d’une recherche.
Choix du type d’utilisation de l’instance Google Maps
Les données représentées dans le composant peuvent s’appuyer sur :
- Le résultat d’une recherche (Cas #1)
- Une liste ou une sous-liste (Cas#2)
La case ‘en tant que présentation’ dans une liste’ permet de basculer d’une source d’alimentation du composant à l’autre.
Cas #1 La case ‘en tant que présentation’ dans une liste’ est décochée. La recherche sur laquelle s’appuie l’alimentation des données du tableau doit être renseignée.
Cas #2 La case ‘en tant que présentation dans une liste’ est cochée. La table contenant les fiches que vous souhaitez visualiser dans le composant via des listes et/ou des sous-listes doit être renseignée. Le composant paramétré peut être utilisé comme présentation :
- d’une liste
- d’une sous-liste
Principaux paramètres
Clé de l’API Google : cette clé est fournie par les services de YellowBox CRM dès validation de l’activation du plugin.
Table utilisée : table à partir de laquelle sont issues les informations apparaissant dans les étiquettes représentant une adresse.
Utiliser la table adresse : ‘Oui’ si la table adresse native de YellowBox est utilisée pour consigner les adresses. Dans le cas contraire, il convient de renseigner les correspondances ‘Latitude’ et ‘Longitude’ avec les champs de la table sélectionnée.
Faire apparaître ma position : si ‘Oui’ est sélectionné un cercle indiquant la position de l’utilisateur sera visible sur la carte. Cette activation ne peut être effective qu’avec le consentement de l’utilisateur final : à la première visualisation d’une carte dans YellowBox CRM, une question lui est posée dans ce sens par son navigateur. Cette option peut être modifiée à tout moment par l’utilisateur dans les options du navigateur utilisé.
De la même manière, dans le cas où l’affichage est réalisé à partir d’une recherche basée sur la fiche courante, celle-ci est mise en évidence via une punaise plus grande que les autres.
Champs pour la bulle d’aide et champs pour affichage des détails : ces zones de correspondance permettent de personnaliser le contenu des étiquettes représentant une adresse.
Un champ de type document, peut être inséré dans le paramètre ‘Champs pour affichage des détails’. Il permet d’afficher une photo dans l’étiquette qui apparait lors du clic sur le marqueur d’une société.
Sélection du champ de rupture : champ de la table utilisée sur lequel réaliser une identification par couleur des punaises (exemple ‘Type de société’).
Style de la carte : permet de faire apparaître des punaises correspondantes à des compléments d’information de Google Maps (par exemple les hotels, restaurants…).
Intégration du composant
Comme vu au niveau du paramétrage, le plugin Google Maps peut être utilisé en tant que composant alimenté par une recherche (CAs #1) ou mettre à disposition de l’utilisateur une nouvelle présentation sur les listes ou sous-listes d’une table (Cas #2).
Cas #1
Dans le cas où le plugin s’appuie sur une recherche, le composant peut être inséré dans :
- Un accueil
- Une fiche
En tant qu’administrateur il est possible d’ajouter un plugin paramétré directement dans les écrans des utilisateurs en cliquant sur le bouton en bas d’écran [Mode éditeur].
Pour ajouter un composant Google Maps préparamétré, il convient de réaliser les opérations suivantes :
- Passer en mode éditeur
- Sélectionner l’objet qui doit accueillir le composant
- Cliquer sur [Ajouter] dans la barre de propriétés apparaissant au bas de l’écran
- Sélectionner [Composant] dans la liste déroulante
- Sélectionner dans la seconde liste déroulante le nom du plugin paramétré à insérer
- Ajuster la taille et la position du composant selon le résultat ciblé
Cas #2
Dans le cas où le plugin est alimenté de données d’une liste, il apparaît automatiquement dans la liste des présentations disponibles. Aucun paramétrage complémentaire n’est nécessaire pour la mise à disposition des utilisateurs.
Utilisation
Le plugin Google Maps est disponible dans YellowBox CRM soit directement dans un écran de type accueil ou fiche, soit sous la forme d’une présentation disponible dans les listes ou sous-listes.
Opérations à réaliser pour afficher la liste des sociétés (dans notre exemple) sous forme de tableau :
- Cliquer sur le bouton
pour accéder à la gestion des présentations - Cliquer sur ‘Changer de présentation’ pour accéder à la liste des présentations disponibles
- Cliquer sur la présentation voulue dans la colonne ‘Autre’ (‘GoogleMaps - Liste des sociétés’).
Dans notre exemple, l’affichage classique sera alors remplacé par celui-ci :
L’utilisateur pourra modifier sa sélection via les filtres et/ou les recherches et la carte sera alors actualisée en temps réel.
Le clic sur une punaise fait apparaître l’étiquette correspondante. Il est alors possible d’ouvrir la fiche représentée via clic sur le bouton ‘Ouvrir la fiche’.