Définir des clés secondaires pour référencer des enregistrements
Cette rubrique s’applique à Dynamics 365 Customer Engagement (on-premises). Pour la version Power Apps de cette rubrique, consultez : Définir les clés secondaires à l’aide du portail Power Apps
Avec les clés secondaires, vous disposez d’un moyen efficace et précis d’intégrer des données à 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 (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. 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 sans écrire de code, ou vous pouvez les définir par programme. Notez qu’en définissant des 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.
Programmation simplifiée des données importées à partir des systèmes externes sans ID d’enregistrement.
Important
- Vous ne pouvez pas utiliser un champ utilisé par des enregistrements existants en tant que clé secondaire. Il en résultera une erreur d’enregistrements dupliqués.
- Les champs dont la sécurité au niveau du champ est activée ne peuvent pas être utilisés comme clé secondaire. Pour plus d’informations : Sécurité au niveau des champs pour contrôler l’accès
Pour en savoir plus sur la programmabilité des clés secondaires, voir :
Définition de clés secondaires pour une entité
Utilisation d’une clé secondaire pour créer un enregistrement
Définir des clés secondaires
- Ouvrez l’explorateur de solutions.
- Accédez à Composants>Entités>Entité <X>>Clés.
- Sélectionnez Nouveau.
- Dans le formulaire, renseignez les champs requis (Nom complet et Nom), puis sélectionnez et ajoutez les champs à la clé.
- Enregistrez la clé.
L’exemple ci-dessous utilise le champ Numéro de compte dans la définition de la clé secondaire.
Note
Vous pouvez définir jusqu’à cinq clés différentes pour une entité.
Voir aussi
Créer et modifier des ressources Web
Définition de clés secondaires pour une entité (Guide du développeur)Utilisation d’une clé secondaire pour créer un enregistrement (Guide du développeur)