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’outil Diagramme de métadonnées, disponible sous forme d’échantillon de code, pour lire les métadonnées du service Web de l’organisation et générer des diagrammes de relations entre entités à partir de ces données.

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 une nouvelle entité personnalisée nommée « Coffre-fort » créée dans Power Apps et sa relation avec une entité « Compte bancaire » (compte) légèrement personnalisée.

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é account, l’entité new_safedepositbox personnalisée et d’autres entités dans le système. Les noms affichés sont les noms d’entité logiques.

Notes

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

Vous pouvez rechercher des informations sur les relations pour une table dans Power Apps. Remarquez la relation un-à-plusieurs avec le Coffre-fort.

L’entité de compte bancaire qui s’affiche sur le diagramme représente le compte bancaire d’un client. En tant que client d’une banque, vous pouvez ouvrir plusieurs comptes bancaires, tels que des comptes chèques et des comptes d’épargne, où chaque compte bancaire peut avoir zéro ou plusieurs coffres-forts. Voici un exemple de relation de type un à plusieurs entre un compte bancaire et des coffres-forts.

Vous pouvez associer plusieurs activités, telles que des tâches, des messages électroniques et des rendez-vous à un compte bancaire. Le compte bancaire est associé à un client, des informations de contact sont conservées dans le dossier et un journal de conversation instantané pour les demande de support est conservé.

À 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 Diagramme de métadonnées 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’outil Diagramme de métadonnées afin de générer des diagrammes de métadonnées Microsoft Visio, construisez et exécutez le code de l’outil à l’aide de la solution Visual Studio fournie dans le dossier de projet de l’échantillon de code.

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

Le dossier du projet contient un fichier Readme avec des instructions pour construire et exécuter l’échantillon. L’exemple de code est une application de console autonome qui crée un diagramme de relation d’entité. Le programme nécessite que Microsoft Visio soit installé sur votre ordinateur car il fait appel aux fonctions de la bibliothèque Visio pour générer le diagramme.

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 montre les relations entre les entités account et new_safedepositbox, utilisez la commande suivante :

GenerateEntityDiagram.exe account new_safedepositbox

L’entité personnalisée new_safedepositbox doit exister dans votre environnement pour que cela fonctionne. Sinon, essayez toute combinaison d’entités qui existent ; peut-être « contact du compte ». Le nom du fichier Visio généré est account.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, « account.vsd » :

GenerateEntityDiagram.exe account

GenerateEntityDiagram.exe account 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 de développement de la communauté, jonasr.app/uml pour plus d’informations sur le générateur de diagrammes UML, LinkeD365.blog pour obtenir plus d’informations sur ERD Visio Builder.

Notes

Les outils de la communauté ne sont pas un produit de Microsoft et nous n’étendons 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

Utiliser les tables Dataverse avec du code
Utiliser des définitions de table avec du code

Notes

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