Définir des clés secondaires pour référencer les enregistrements Dynamics 365

 

Date de publication : février 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Avec les clés secondaires, vous disposez d'un moyen efficace et précis d'intégrer des données dans Microsoft Dynamics 365 à partir des systèmes externes. Il est particulièrement important dans les cas où un système externe ne stocke pas les ID d'enregistrement Dynamics 365 (GUID) qui identifient les enregistrements de manière unique. Les clés secondaires ne sont pas des GUID et vous pouvez les utiliser pour identifier les enregistrements Dynamics 365. Vous devez leur attribuer un nom unique. Vous pouvez utiliser un ou plusieurs champs d'entités pour définir la clé. Par exemple, pour identifier un enregistrement de compte avec une clé secondaire, utilisez le nom du compte et le numéro du compte. Vous pouvez définir des clés secondaires dans l'application Web Dynamics 365 sans écrire de code, ou vous pouvez les définir par programme. Notez qu'en définissant les clés secondaires dans l'interface utilisateur, vous ne pouvez pas les utiliser par programme dans le code.

Voici quelques avantages de la fonction de clé secondaire :

• Recherche plus rapide des enregistrements.

• Opérations de traitement des données en bloc plus fiables, surtout dans Dynamics 365 (en ligne).

• Programmation simplifiée des données importées à partir des systèmes externes sans ID d'enregistrement Dynamics 365.

Pour plus d'informations sur la programmabilité des clés secondaires, voir :
MSDN : Define alternate keys for an entity (Définition de clés secondaires pour une entité)
MSDN : Use an alternate key to create a record (Utilisation d'une clé secondaire pour créer un enregistrement)

Définir les clés secondaires

Pour définir les clés secondaires, accédez à Accédez à Paramètres > Personnalisations.. Choisissez Personnaliser le système > Composants > Entités > Entité <X> > Clés. Sélectionnez Nouveau. Dans le formulaire, renseignez les champs requis (Nom complet et Nom), puis choisissez et ajoutez les champs à la clé. Enregistrez la clé. Dans notre exemple, nous avons utilisé le champ Numéro de compte dans la définition de la clé secondaire.

Notes

Vous pouvez définir jusqu'à cinq clés différentes pour une entité.

Voir aussi

Personnalisation de votre système Dynamics 365
Créer et modifier des ressources Web
MSDN : Définition de clés secondaires pour une entité
MSDN : Utilisation d'une clé secondaire pour créer un enregistrement

© 2017 Microsoft. Tous droits réservés. Copyright