Utiliser les métadonnées pour générer des diagrammes d’entités

 

Date de publication : janvier 2017

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

La représentation visuelle des métadonnées peut être très utile, surtout lorsque vous essayez de décrire la relation entre des entités dans le système. Vous pouvez utiliser l’exemple de code Diagramme de métadonnées fourni pour Microsoft Dynamics 365 (Online et local) pour générer les diagrammes de relation d’entité. Vous pouvez créer un diagramme simple qui indique une relation pour une seule entité, ou un diagramme complexe incluant des douzaines d’entités associées, notamment des entités personnalisées et des entités système.

Contenu de la rubrique

Relations dans les diagrammes d’entité

À propos des diagrammes

Générer des diagrammes d’entité avec l’outil Diagramme de métadonnées

Relations dans les diagrammes d’entité

L’exemple suivant montre deux nouvelles entités personnalisées créées dans Microsoft Dynamics 365. La première entité représente un compte bancaire et la deuxième entité représente un coffre-fort. Le diagramme d’entité ci-après a été généré avec l’outil Diagramme de métadonnées. Il indique la relation entre l’entité new_bankaccount, l’entité new_safedepositbox et d’autres entités dans le système. Les noms affichés sont les noms d’entité logiques. Notez que s’il existe plusieurs relations entre les deux mêmes entités, une seule ligne est dessinée dans le diagramme pour des raisons de simplicité.

Diagramme des relations d'entité pour les entités personnalisées

Le tableau suivant indique les relations un-à-plusieurs où l’entité principale est un compte bancaire ou un coffre-fort.

Nom du schéma de relation

Entité de référence

new_bankaccount_ActivityPointers

activitypointer

new_bankaccount_Appointments

rendez-vous

new_bankaccount_Emails

Courrier électronique

new_bankaccount_Faxes

fax

new_bankaccount_Letters

letter

new_bankaccount_PhoneCalls

phonecall

new_bankaccount_ServiceAppointments

serviceappointment

new_bankaccount_Tasks

tâche

new_bankaccount_RecurringAppointmentMasters

recurringappointmentmaster

new_bankaccount_DuplicateMatchingRecord

duplicaterecord

new_bankaccount_DuplicateBaseRecord

duplicaterecord

new_bankaccount_Annotations

annotation

new_bankaccount_AsyncOperations

asyncoperation

new_bankaccount_UserEntityInstanceDatas

userentityinstancedata

new_bankaccount_ProcessSession

processsession

new_bankaccount_BulkDeleteFailures

bulkdeletefailure

new_bankaccount_PrincipalObjectAttributeAccesses

principalobjectattributeaccess

new_new_bankaccount_new_safedepositbox

new_safedepositbox

new_safedepositbox_ActivityPointers

activitypointer

new_safedepositbox_Appointments

rendez-vous

new_safedepositbox_Emails

Courrier électronique

new_safedepositbox_Faxes

fax

new_safedepositbox_Letters

letter

new_safedepositbox_PhoneCalls

phonecall

new_safedepositbox_ServiceAppointments

serviceappointment

new_safedepositbox_Tasks

tâche

new_safedepositbox_RecurringAppointmentMasters

recurringappointmentmaster

new_safedepositbox_DuplicateMatchingRecord

duplicaterecord

new_safedepositbox_DuplicateBaseRecord

duplicaterecord

new_safedepositbox_Annotations

annotation

new_safedepositbox_AsyncOperations

asyncoperation

new_safedepositbox_UserEntityInstanceDatas

userentityinstancedata

new_safedepositbox_ProcessSession

processsession

new_safedepositbox_BulkDeleteFailures

bulkdeletefailure

new_safedepositbox_PrincipalObjectAttributeAccesses

principalobjectattributeaccess

Le tableau suivant indique les relations plusieurs-à-un où l’entité principale est un compte bancaire ou un coffre-fort.

Nom du schéma de relation

Entité référencée

lk_new_bankaccount_createdby

systemuser

lk_new_bankaccount_createdonbehalfby

systemuser

lk_new_bankaccount_modifiedby

systemuser

lk_new_bankaccount_modifiedonbehalfby

systemuser

user_new_bankaccount

systemuser

team_new_bankaccount

équipe

owner_new_bankaccount

Propriétaire

business_unit_new_bankaccount

businessunit

new_account_new_bankaccount

compte

lk_new_safedepositbox_createdby

systemuser

lk_new_safedepositbox_createdonbehalfby

systemuser

lk_new_safedepositbox_modifiedby

systemuser

lk_new_safedepositbox_modifiedonbehalfby

systemuser

user_new_safedepositbox

systemuser

team_new_safedepositbox

équipe

owner_new_safedepositbox

Propriétaire

business_unit_new_safedepositbox

businessunit

new_new_bankaccount_new_safedepositbox

new_bankaccount

L’entité de compte qui s’affiche sur le diagramme représente un client de la banque. En tant que client de la banque, vous pouvez ouvrir plusieurs comptes bancaires, tels que des comptes courants et d’épargne, ainsi que plusieurs coffres-forts. Voici un exemple de type de relation plusieurs-à-un entre un compte bancaire et un client et un coffre-fort et un client. Vous pouvez associer plusieurs activités, telles que des tâches, des messages électroniques et des rendez-vous à un compte bancaire. Pour fournir des informations supplémentaires sur un compte bancaire ou un coffre-fort, vous pouvez utiliser des notes et des pièces jointes.

À propos des diagrammes

Vous trouverez les diagrammes de nombreuses entités système dans la documentation du Kit de développement logiciel (SDK), dans les rubriques qui décrivent les fonctionnalités des entités. Dans chaque zone du diagramme, la première ligne en gras est le nom de l’entité. Les lignes suivantes contiennent les noms des attributs utilisés pour définir les relations pour cette entité. L’outil ne génère pas de lignes pour indiquer les relations avec les entités suivantes : organisation, division, et utilisateur (systemuser). Ceci pour simplifier le diagramme. Le codage en couleurs est utilisé pour indiquer la relation propriétaire pour chaque entité. Le diagramme suivant décrit le codage en couleurs :

Clé des diagrammes de relations d'entité CRM

Générer des diagrammes d’entité avec l’outil Diagramme de métadonnées

Pour utiliser l’exemple de code qui génère par programme des diagrammes de métadonnées Microsoft Office Visio, générez et exécutez l’une des solutions suivantes disponibles dans le package du Kit du développement logiciel (SDK) : SDK\SampleCode\CS\Metadata\Diagram. Le dossier contient un fichier Readme avec des instructions d’utilisation. L’exemple de code est une application de console autonome qui crée un diagramme de relation d’entité. Le programme requiert Microsoft Office Visio.

Vous pouvez exécuter le programme à l’invite de commandes. Répertoriez simplement les entités à inclure dans le diagramme en tant qu’arguments de ligne de commande. D’autres entités peuvent être incluses dans votre diagramme si nécessaire pour indiquer toutes les relations pour chaque entité demandée. Pour générer un diagramme qui affiche les relations des entités new_bankaccount et new_safedepositbox, utilisez la commande suivante :

    MetadataDiagramConsole.exe new_bankaccount new_safedepositbox

Le nom du fichier Visio généré est new_bankaccount.vsd.

Notes

L’outil utilise le nom de la première entité sur la ligne de commande comme nom du fichier Visio. Si vous exécutez les deux commandes suivantes, la deuxième commande remplace le diagramme généré par la première, car les fichiers Visio portent le même nom, « new_bankaccount.vsd » :

MetadataDiagramConsole.exe new_bankaccount

MetadataDiagramConsole.exe new_bankaccount new_safedepositbox

Pour éviter de remplacer un fichier de diagramme généré, vous devez renommer le premier fichier avant d’exécuter la deuxième commande.

Voir aussi

Présentation des entités dans Microsoft Dynamics 365
Utiliser le service d'organisation avec des métadonnées Dynamics 365
Clé des diagrammes d’entité
Diagrammes des relations d’entité CRM 2015

Microsoft Dynamics 365

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