Generación de diagramas de entidades mediante metadatos

Una representación visual de los metadatos puede ser útil, especialmente cuando se 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 relación de entidad a partir de esos datos.

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

Relaciones en diagramas de entidades

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

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

Nota:

Si hay varias relaciones entre las mismas dos entidades, el diagrama muestra solo una línea por motivos de simplicidad.

Diagrama de relación de entidad para una entidad personalizada.

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

Relaciones con la cuenta bancaria.

La entidad de cuenta bancaria que muestra el diagrama representa una cuenta bancaria para un cliente. Como cliente bancario, puede abrir varias cuentas bancarias, como cuentas de cheques y ahorros, donde cada cuenta bancaria puede tener cero o más cajas de depósito seguras. Esta relación es un ejemplo de un tipo de relación uno a varios entre una cuenta bancaria y una caja fuerte.

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

Acerca de los diagramas

La documentación del SDK incluye diagramas para muchas entidades del sistema. Puede encontrar estos diagramas en los temas que describen las funcionalidades de la entidad. Cada cuadro del diagrama tiene el nombre de la entidad en negrita en la primera línea. En las líneas siguientes se enumeran los atributos que definen las relaciones de esa entidad.

La herramienta Diagrama de metadatos no genera líneas que muestran las relaciones con las entidades de organización, unidad de negocio y usuario (systemuser). Esta opción simplifica el diagrama. La codificación de colores indica la relación de propietario para cada entidad. En el diagrama siguiente se describe la codificación de colores:

Clave del diagrama para diagramas de relaciones entre entidades.

Generación de diagramas de entidades con la herramienta de diagrama de metadatos

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

Código fuente de ejemplo: Generación de diagramas de entidades con la herramienta de diagrama de metadatos

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

Puede ejecutar el programa en la línea de comandos. Enumere las entidades que desea incluir en el diagrama como argumentos de línea de comandos. Puede incluir otras entidades en el diagrama según sea necesario para mostrar todas las relaciones de cada entidad solicitada. Para generar un diagrama que muestre las relaciones de las entidades de cuenta y new_safedepositbox, use el siguiente comando:

GenerateEntityDiagram.exe account new_safedepositbox

La entidad personalizada new_safedepositbox debe existir en el entorno para que este comando 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 nombre del archivo de Visio. Si ejecuta los dos comandos siguientes, el segundo comando sobrescribe el diagrama generado por el primero. Este comportamiento se produce porque los archivos de Visio tienen el mismo nombre –"account.vsd":

GenerateEntityDiagram.exe account

GenerateEntityDiagram.exe account new_safedepositbox

Para evitar sobrescribir un archivo de diagrama generado, cambie el nombre del primer archivo antes de ejecutar el segundo comando.

Herramientas de la comunidad

Las siguientes herramientas desarrolladas por la comunidad proporcionan formas alternativas de generar diagramas de relación de entidad a partir de metadatos de Dataverse.

Generador de diagramas UML

UML Diagram Generator for XrmToolBox es una herramienta que genera diagramas de relación de entidad (ERD) como archivos PlantUML a partir de metadatos de Microsoft Dynamics 365 y Power Platform Dataverse. Dado que el resultado es archivos basados en texto, puede editarlos manualmente y mantenerlos en el control de código fuente para el seguimiento de cambios a lo largo del tiempo.

Creadores de diagramas de relaciones de entidades

Estas herramientas generan diagramas de relación de entidades visuales a partir de metadatos en Microsoft Dynamics 365 y Power Platform Dataverse.

Generador de Visio de ERD

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

Más herramientas de la comunidad

Para obtener más información, consulte el artículo Herramientas de desarrollo . Para obtener más información sobre el generador de diagramas UML, consulte jonasr.app/uml. Para obtener más información sobre erD Visio Builder, vea LinkeD365.blog.

Nota:

Las herramientas de la comunidad no son un producto de Microsoft y Microsoft no proporciona soporte técnico para ellos. Si tiene alguna pregunta sobre la herramienta, póngase en contacto con el publicador. Para obtener más información, vea XrmToolBox.

Consulte también

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