1. Configurer l’Application Connectée “Daquota”

Cette étape est requise pour permettre aux utilisateurs d’accéder à l’application Daquota sans autorisation manuelle.

Naviguez vers Setup > Connected Apps > Manage Connected Apps :

• Cliquez sur le bouton Edit.
• Sous OAuth Policies, réglez Permitted Users sur :
  Admin approved users are pre-authorized
• Cliquez sur Save.

Ensuite, configurez les profils :

• Cliquez sur le nom Daquota (pas sur le bouton edit). Note : le chargement peut être long.
• Dans la section Profiles, cliquez sur le bouton Manage Profile.
• Cochez le profil System Administrator pour vous donner l’accès (ainsi que tout autre profil souhaité).
• Cliquez sur le bouton Save.

2. Ouvrir l’Application de Démo LocalFlow

Dans le Salesforce App Launcher, recherchez et ouvrez LocalFlow.

Cela vous permet de vérifier que l’application est fonctionnelle et correctement installée. Si vous voyez la carte, FÉLICITATIONS, vous pouvez commencer à l’utiliser.

Avec cette configuration, vous avez accès au comportement par défaut. Pour modifier le comportement de la carte et accéder aux fonctionnalités avancées, vous devez assigner le Permission Set Daquota à vos utilisateurs. Lisez la suite pour les configurations additionnelles.

3. Configurer les calques, le formatage conditionnel, etc.

Dans l’onglet Configuration de l’application, en tant qu’administrateur, vous avez accès à diverses options pour personnaliser la carte selon vos besoins. Toutes les configurations seront instantanément visibles pour tous les utilisateurs une fois sauvegardées, gérez donc cela avec précaution.

Par défaut, la carte montre certains objets standards Salesforce, mais vous pouvez modifier cela intégralement.

Note : Vous ne pourrez pas sauvegarder et partager la configuration de la carte avec d’autres utilisateurs à moins de leur assigner le Permission Set Daquota.

4. Configurer les Clés API (API Keys)

Pour les services nécessitant des clés API, LocalFlow implémente un mécanisme sécurisé “Bring Your Own Key” (BYOK). Vos clés API sont stockées de manière chiffrée dans Salesforce et ne sont jamais exposées aux utilisateurs finaux.

Clé API Gemini (Pour l’IA)

Pour utiliser l’assistant IA afin de générer des analyses et des insights depuis vos données, vous devez fournir une clé API Gemini :

• Obtenez votre clé API Gemini depuis un compte Google AI Studio. (Pour un utilisateur unique, une clé gratuite suffit pour un usage basique).
• Naviguez vers la Configuration LocalFlow dans l’application (icône engrenage en haut à droite).
• Dans le champ Gemini API Key, copiez-collez votre clé.
• Sauvegardez la configuration pour rendre la clé disponible à vos utilisateurs.

Note importante : Lors de l’utilisation de l’assistant IA, aucune donnée métier n’est envoyée à Google. L’IA ne fournit pas les résultats de l’analyse, elle retourne des formules d’analyse qui sont ensuite exécutées localement sur vos données Salesforce.

Clé API Google Maps

Par défaut, LocalFlow est livré avec une configuration Leaflet (Open Street Map) gratuite. Cependant, si vous souhaitez utiliser Google Maps :

• Obtenez votre clé API Google Maps depuis la Google Cloud Console (Maps JavaScript API & Geocoding API requises).
• Dans la Configuration LocalFlow, collez votre clé dans le champ Google Maps API Key.
• Sauvegardez la configuration.

APIs Externes

Certaines analyses peuvent nécessiter un accès à des APIs externes pour l’enrichissement des données. Vous pouvez sélectionner des APIs spécifiques dans la configuration (onglets DataSource). Contactez-nous pour ajouter une source de données privée.

5. Assigner le Permission Set Daquota aux utilisateurs

Cette configuration est obligatoire même pour les admins, afin de pouvoir modifier, sauvegarder et partager la configuration de la carte.

Naviguez vers Setup > Users :

• Cliquez sur l’utilisateur à qui vous voulez donner l’accès.
• Assignez le Permission Set Daquota à l’utilisateur.

En tant qu’admin, essayez de modifier et sauvegarder la configuration. Si vous y parvenez, votre configuration de permission fonctionne. Faites de même pour les autres utilisateurs.

6. Ajouter l’onglet LocalFlow à d’autres applications (optionnel)

Vous pouvez rendre l’onglet LocalFlow accessible depuis d’autres applications Salesforce :

• Allez dans Setup > App Manager.
• Éditez l’application désirée.
• Ajoutez l’onglet : LocalFlow.

7. Ajouter le composant LocalFlow aux Pages d’Enregistrement (recommandé)

Vous pouvez ajouter le composant personnalisé LocalFlow à n’importe quelle Lightning Record Page. Avec la bonne configuration, il affichera la localisation de l’enregistrement sur la carte.

Étapes :

1. Éditez une page d’enregistrement dans le Lightning App Builder.
2. Glissez-déposez le composant LocalFlow.
3. Configurez les options suivantes selon vos besoins :

Astuce : Il est pratique de créer un nouvel onglet dans votre mise en page pour y placer le composant. Dans ce cas, choisissez Layout: fillHeight et Height: 100% pour que la carte remplisse l’espace restant de l’écran.

8. Réinitialiser automatiquement le géocodage quand une adresse change (recommandé)

Par défaut, les champs Latitude et Longitude ne sont pas remis à zéro quand l’adresse change. Pour forcer le re-calcul, créez un Salesforce Flow :

• Créez un Record-Triggered Flow (Trigger: After Update).
• Ajoutez une Décision : si un composant de l’adresse change (BillingAddress, etc.).
• Si changé → Update record : BillingLatitude = null et BillingLongitude = null.

LocalFlow détectera alors les coordonnées nulles et les recalculera automatiquement.

9. Ajouter des géo-données aux objets (optionnel)

Cette fonctionnalité permet d’ajouter des zones géographiques ou des lieux à n’importe quel objet via des API externes.

1. Créer une Feature Layer : Allez dans l’onglet Features et cliquez sur Add feature layer. Une feature layer est une liste de features GEOJSON accessibles via une URL d’API.

2. Configurer : Définissez le ID field (identifiant unique) et le label field (affichage).

3. Utiliser : Ajoutez un champ personnalisé GeoData dans vos objets pour stocker les IDs des features. Vous pouvez ensuite visualiser ces données dans l’application principale ou sur la fiche enregistrement.

10. Mettre à jour dynamiquement l’état et la configuration (optionnel)

Dans l’application daquota_maps_record, l’état de la carte peut être piloté par des champs calculés Salesforce.

Si vous avez les champs MyAddress__c, créez le champ calculé MyAddress_config__c. L’application écoutera ce champ et se rafraîchira automatiquement après une sauvegarde ou modification par un Screen Flow.

La valeur READONLY rend la carte non éditable pour le champ correspondant.

11. Besoin d’aide ?

Si vous rencontrez des problèmes ou avez besoin de support additionnel, veuillez consulter notre documentation ou contacter notre équipe support.