Considérations relatives aux objets externes Salesforce Maps

Comment Salesforce Maps récupère les données d'objets externes

Les objets externes permettent aux administrateurs Salesforce d'accéder en temps réel via Salesforce Connect aux données qui vivent hors d'une organisation Salesforce. Vous pouvez tracer des objets externes dans Salesforce Maps, mais il existe des limitations importantes lorsque votre source de données externe utilise OData 2.0, Odata 4.0 ou des connexions inter-organisations.

Lorsque vous tracez des objets externes, Maps récupère les données via Salesforce Connect, qui passe des appels externes à des systèmes externes. Cette intégration en temps réel introduit des contraintes spécifiques qui ne s'appliquent pas aux objets Salesforce standard.

Limitations SOQL et des requêtes

Les objets externes ont plusieurs restrictions de requête qui affectent la récupération et l'affichage des données par Salesforce Maps :

• Requêtes de relation : Les requêtes impliquant des relations entre des objets externes et des objets standard peuvent ne pas prendre en charge toutes les opérations SOQL. Vérifiez que vos relations avec les objets externes prennent en charge les champs que vous devez tracer.
• Fonctions d'agrégation : Les fonctions COUNT, SUM, AVG, MIN et MAX ne sont pas prises en charge dans la plupart des sources de données externes. Les fonctionnalités de Maps qui s'appuient sur l'agrégation peuvent ne pas fonctionner avec des objets externes.
• Opérateurs de filtrage : Les opérateurs de filtrage SOQL ne sont pas tous disponibles pour des objets externes. Les opérateurs spécifiques pris en charge dépendent de la version et de la configuration Odata de votre source de données externe.
• Clause LIMITE : Les sources de données externes peuvent appliquer leurs propres limites en enregistrements indépendamment des clauses Salesforce SOQL LIMIT. Consultez la documentation de votre source de données externe pour des restrictions spécifiques.

Conseil Testez vos requêtes d'objet externe dans la Developer Console avant de les configurer en tant qu'objets de base dans Salesforce Maps afin d'identifier rapidement les opérations non prises en charge.

Géocodage et champs d'adresse requis

Le géocodage des objets externes nécessite une attention particulière :

• Champs d'adresse : Les objets externes doivent avoir des champs d'adresse exposés via la source de données externe. Si les champs d'adresse ne sont pas disponibles directement, vous devez configurer une relation de référence avec un objet standard ou personnalisé qui contient l'adresse.
• Limites de l'API de géocodage : Chaque fois que Maps trace des objets externes, il peut déclencher des opérations de géocodage qui sont prises en compte dans les limites en géocodage de votre organisation. Surveillez votre utilisation du géocodage en utilisant des jeux de données externes volumineux.
• Références indirectes : Si vous tracez des enregistrements sans adresse, assurez-vous que la relation entre l'objet externe et l'objet contenant l'adresse est correctement configurée en tant que référence indirecte.

Limitations du Shield Platform Encryption

Si votre organisation utilise Shield Platform Encryption, tenez compte des contraintes supplémentaires suivantes lors du tracé d'objets externes:

• Champs cryptés : Les objets externes ne prennent pas directement en charge Shield Platform Encryption. Cependant, si vous utilisez des références indirectes à des objets standard qui contiennent des champs cryptés, certaines opérations de filtrage et de recherche risquent de ne pas fonctionner normalement.
• Restrictions de recherche : Les champs cryptés des objets standard associés ne peuvent pas être utilisés dans des requêtes de recherche lorsqu'ils sont accédés via des relations d'objet externe.
• Limites de l'opérateur : Les opérateurs de comparaison (LIKE, CONTAINS, etc.) peuvent ne pas fonctionner sur des champs cryptés référencés via des relations d'objet externe.

Important Si vous rencontrez un comportement de filtrage inattendu avec des objets externes, vérifiez si les objets associés contiennent des champs cryptés qui peuvent entraîner la limitation.

Considérations relatives aux performances

Le tracé d'objets externes peut affecter les performances de Maps en raison de la récupération de données en temps réel :

• Limites en appels externes : Chaque requête de récupération de données d'objets externes est prise en compte dans les limites en appels externes de votre organisation. Les jeux de données volumineux ou les actualisations fréquentes de carte peuvent consommer rapidement des appels externes.
• Temps de réponse : Les performances de Maps dépendent du temps de réponse de votre source de données externe. Les systèmes externes lents retarderont le chargement et le tracé des cartes.
• Volume de données : Le tracé de volumes importants d'enregistrements d'objets externes peut être plus lent que le tracé d'objets standard. Vous pouvez utiliser des filtres pour réduire le nombre d'enregistrements récupérés et tracés.
• Limites de mise en cache : Contrairement aux objets standard, les données des objets externes sont récupérées en temps réel dans chaque requête. Les mécanismes de mise en cache de Salesforce qui améliorent les performances des objets standard ne s'appliquent pas aux données externes.

Conseil Pour des performances optimales, utilisez des filtres pour récupérer uniquement les enregistrements externes que vous devez tracer, et évitez de tracer simultanément un nombre excessif d'objets externes.

Comportement des couches avec des objets externes

Lors de la création de couches de données ou de couches de repères avec des objets externes :

• Création de couches : Vous pouvez créer des couches de données basées sur des objets externes, mais toutes les limitations en requêtes décrites ci-dessus s'appliquent.
• Cliquer pour créer : La fonctionnalité Cliquer pour créer peut avoir des limitations lors de l'utilisation d'objets externes en tant qu'objet cible. Vérifiez que votre source de données externe prend en charge les opérations d'insertion nécessaires.
• Mises à jour en direct du jeu de données : Les modifications apportées aux données externes dans le système source peuvent ne pas être immédiatement affichées dans les couches Maps en raison de la mise en cache ou des intervalles d'actualisation de la source de données.
• Couches de code couleur : Le code couleur basé sur des valeurs de champ d'objet externe fonctionne de la même façon que les objets standard, mais les performances peuvent être plus lentes avec des jeux de données externes volumineux.

Comportement de recherche et de filtrage

La fonctionnalité de recherche a des limitations spécifiques avec les objets externes :

• Recherche de POI : La recherche de points d'intérêt (POI) peut être plus lente avec des objets externes en raison de la récupération de données en temps réel.
• Recherche textuelle : Les capacités de recherche en texte complet dépendent de la prise en charge des opérations de recherche en texte par votre source de données externe.
• Rémanence du filtre : Il peut être nécessaire de réévaluer les filtres appliqués aux couches d'objets externes à chaque chargement de carte, ce qui peut affecter le temps de chargement.

Dépannage des objets externes

Si vous rencontrez des problèmes pour tracer des objets externes, vérifiez les points suivants :

Meilleures pratiques relatives aux objets externes

Suivez les meilleures pratiques suivantes lors de l'utilisation d'objets externes dans Salesforce Maps :

• Testez d'abord les requêtes : Utilisez la Developer Console pour tester des requêtes SOQL par rapport à des objets externes avant de les configurer dans Maps.
• Utilisez les filtres stratégiquement : Appliquez des filtres pour limiter le nombre d'enregistrements externes récupérés et tracés.
• Limites de surveillance : Suivez les limites en appels externes et l'utilisation de l'API de géocodage en utilisant des données externes.
• Sources de données du document : Gérez la documentation sur vos sources de données externes, notamment leurs limitations, les planifications d'actualisation et les opérations prises en charge.
• Planifier la latence : Définissez les attentes des utilisateurs que les cartes avec des objets externes peuvent charger plus lentement que les cartes avec uniquement des objets standard.
• Vérifier les relations : Assurez-vous que les relations de référence indirecte sont correctement configurées avant de tenter de tracer des objets externes qui n'ont pas leur propre adresse.