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

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 Dynamics 365 Customer Engagement (on-premises) 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.

Relations dans les diagrammes d’entité

L’exemple suivant montre deux nouvelles entités personnalisées créées dans Dynamics 365 Customer Engagement (on-premises). 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.

Hinweis

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é.

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 :

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 Office Visio, générez et exécutez l’une des solutions suivantes disponibles dans le package du Kit du développement logiciel (SDK).

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

Après avoir téléchargé l’exemple, vous trouverez le fichier de la solution avec le chemin d’accès au dossier suivant : Generate entity diagrams with the metadata diagram tool\C#\Diagram.

Le dossier contient un fichier Lisez-moi 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 nécessite Office Visio.

Vous pouvez exécuter le programme à l’invite de commandes. Répertoriez 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.

Hinweis

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.

Outils de la communauté

Générateur de diagramme UML

Le Générateur de diagramme UML pour XrmToolBox est un outil qui génère des diagrammes de relations d’entités (ERD) sous la forme de fichiers PlantUML à partir de métadonnées dans Microsoft Dynamics 365 et Power Platform Dataverse. Comme il en résulte des fichiers texte, ils peuvent être modifiés manuellement et conservés dans le contrôle de code source pour le suivi des modifications au fil du temps.

Le Créateur de diagramme de relation d’entités pour XrmToolBox est un outil qui génère des diagrammes de relations d’entités visuels à partir de métadonnées dans Microsoft Dynamics 365 et Power Platform Dataverse.

ERD Visio Builder pour XrmToolBox est un outil qui génère des diagrammes Visio à partir des métadonnées de Microsoft Dynamics 365 et de Power Platform Dataverse.

Consultez l’article Outils de développement pour connaître les outils développés par la communauté, jonasr.app/uml pour obtenir plus d’informations sur le générateur de diagrammes UML, journeyintocrm.com pour obtenir plus d’informations sur le créateur de diagrammes de relation d’entité et LinkeD365.blog pour obtenir plus d’informations sur ERD Visio Builder.

Hinweis

Les outils de la communauté ne sont pas un produit de Microsoft Dynamics et n’étendent pas le support aux outils de la communauté. Si vous avez des questions relatives à cet outil, contactez l’éditeur. Pour plus d’informations : XrmToolBox.

Voir aussi

Présentation des entités dans Dynamics 365 Customer Engagement (on-premises)
Étendre le modèle de métadonnées pour Dynamics 365 Customer Engagement (on-premises)
Clé des diagrammes d’entité
Diagrammes des relations d’entité Dynamics 365 Customer Engagement (on-premises)

Hinweis

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).