Usar metadatos para generar diagramas de entidad

La representación visual de metadatos puede ser útil, especialmente cuando intenta describir la relación entre entidades del sistema. Puede usar la herramienta Diagrama de metadatos, disponible como ejemplo de código, para leer los metadatos del servicio web de la organización y generar diagramas de relaciones entre entidades a partir de esos datos.

Puede crear un diagrama que muestre una relación solo para una entidad, o un diagrama complejo que incluya docenas de entidades relacionadas, incluidas las entidades personalizadas y del sistema.

Relaciones en diagramas de entidades

El siguiente ejemplo muestra una nueva entidad personalizada llamada "Caja de seguridad" creada en Power Apps y su relación con una entidad "Cuenta bancaria" (cuenta) ligeramente personalizada.

El siguiente diagrama de entidad se generó mediante la herramienta Diagrama de metadatos. Muestra la relación entre la entidad account, la entidad personalizada new_safedepositbox y las otras entidades del sistema. Los nombres mostrados son los nombres de entidad lógicos.

Nota

Si hay varias relaciones entre las dos mismas entidades, solo se dibujará una línea en el diagrama para obtener una mayor simplicidad.

Puede buscar información sobre relaciones para una tabla en Power Apps. Observe la relación de uno a varios con Safe Deposit Box.

La entidad de cuenta bancaria que aparece en el diagrama representa una cuenta bancaria de un cliente. Como cliente del banco, puede abrir varias cuentas bancarias, como cuentas para cheques y ahorros, en las que cada cuenta bancaria puede tener ninguna o más cajas de seguridad de banco. Este es un ejemplo de una relación de uno a varios entre una cuenta bancaria y cajas de seguridad de banco.

Puede asociar varias actividades, como tareas, correos electrónicos y citas con una cuenta bancaria. La cuenta bancaria está asociada con un cliente, hay información de contacto en el archivo y se mantiene un registro de chat para solicitudes de soporte.

Acerca de los diagramas

Puede encontrar los diagramas para muchas entidades del sistema de la documentación de SDK, en los temas que describen las capacidades de la entidad. En cada cuadro del diagrama, la primera línea de texto en negrita es el nombre de la entidad. Las líneas posteriores contienen los nombres de los atributos usados para definir las relaciones de esta entidad.

La herramienta Diagrama de metadatos no genera líneas que muestran las relaciones de las siguientes entidades: organización, unidad de negocio y usuario (systemuser). Esto se realiza para simplificar el diagrama. La codificación de colores se usa para indicar la relación de propietario de cada entidad. En el siguiente diagrama se describe la codificación de color:

Generar diagramas de entidad con la herramienta Diagrama de metadatos

Para utilizar la herramienta Diagrama de metadatos para generar diagramas de metadatos de Microsoft Visio, cree y ejecute el código de la herramienta utilizando la solución de Visual Studio proporcionada en la carpeta del proyecto del ejemplo de código.

Código fuente de ejemplo: Generar diagramas de entidad con la herramienta de diagrama de metadatos

La carpeta del proyecto contiene un archivo Léame con instrucciones para compilar y ejecutar el ejemplo. La muestra de código es una aplicación de consola independiente que crea un diagrama de relaciones entre entidades. El programa requiere que Microsoft Visio esté instalado en su equipo, ya que llama a las funciones de la biblioteca de Visio para generar el diagrama.

Puede ejecutar el programa en el símbolo del sistema. Enumere las entidades que desee incluir en el diagrama como argumentos de la línea de comandos. Es posible que se incluyan otras entidades en su diagrama según sea necesario para mostrar todas las relaciones de cada entidad que ha solicitado. Para generar un diagrama que muestra las relaciones para las entidades de cuenta y new_safedepositbox, utilice el siguiente comando:

GenerateEntityDiagram.exe account new_safedepositbox

La entidad personalizada new_safedepositbox debe existir en su entorno para que esto funcione. De lo contrario, pruebe cualquier combinación de entidades que existan, tal vez "contacto de cuenta". El nombre del archivo de Visio generado es account.vsd.

Nota

La herramienta usa el nombre de la primera entidad de la línea de comandos como el nombre del archivo Visio. Si ejecuta los siguientes dos comandos, el segundo comando sobrescribe el diagrama generado por el primero. Esto se debe a que los archivos de Visio tienen el mismo nombre, o sea ”account.vsd”:

GenerateEntityDiagram.exe account

GenerateEntityDiagram.exe account new_safedepositbox

Para evitar sobrescribir un archivo de diagrama generado, tiene cambiar el nombre al primer archivo antes de ejecutar el segundo comando.

Herramientas de la Comunidad

Generador de diagramas UML

Generador de diagramas UML para XrmToolBox es una herramienta que genera diagramas de relación entre entidades (ERD) en forma de archivos PlantUML desde metadatos en Microsoft Dynamics 365 y el Power Platform Dataverse. Como el resultado son archivos basados en texto, se pueden editar manualmente y mantener en control de fuente para el seguimiento de cambios a lo largo del tiempo.

Creador de diagramas de relación entre entidades para XrmToolBox es una herramienta que genera diagramas visuales de relación entre entidades a partir de metadatos en Microsoft Dynamics 365 y el Power Platform Dataverse.

ERD Visio Builder para XrmToolBox es una herramienta que genera diagramas de Visio a partir de los metadatos de Microsoft Dynamics 365 y Power Platform Dataverse.

Consulte el artículo para herramientas desarrollada por la comunidad Herramientas de desarrollo, jonasr.app/uml para obtener más información sobre el generador de diagramas UML, LinkeD365.blog para obtener más información sobre el creador de diagramas de relaciones entre entidades y LinkeD365.blog para obtener más información sobre ERD Visio Builder.

Nota

Las herramientas de la comunidad no son un producto de Microsoft y no se incluyen en el soporte técnico. Si tiene alguna duda relacionada con la herramienta, póngase en contacto con el Editor. Más información: XrmToolBox.

Consulte también

Trabajar con tablas de Dataverse usando código
Trabajar con definiciones de tabla mediante código

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).