Desarrolladores: comprender la terminología en Microsoft Dataverse

Dataverse no es solo una base de datos, sino también servicios web que permiten a los desarrolladores interactuar con los datos.

Si está familiarizado con el marco de entidades ADO.NET, los arquitectos y desarrolladores de aplicaciones orientadas a datos han luchado con la necesidad de lograr dos objetivos diferentes.

  • Deben modelar las entidades, relaciones y la lógica de los problemas comerciales que ellos solucionan.
  • También deben trabajar con los servicios de datos utilizados para almacenar y recuperar los datos.

El marco de entidades permite a los desarrolladores trabajar con datos en forma de objetos y propiedades específicos del dominio, como clientes y direcciones de clientes, sin tener que preocuparse por las tablas y columnas de la base de datos subyacente donde se almacenan estos datos.

En Power Apps y Dataverse, aunque las tablas y columnas se utilizan en la interfaz de usuario y se refieren a la idea general de cómo se almacenan los datos en la base de datos Dataverse, se usa terminología específica (como entidad y atributos) para hacer referencia al modelo de datos subyacente y las interfaces con los que trabajan los desarrolladores según el protocolo o la tecnología utilizados para interactuar con los datos.

Las estructuras de datos con las que trabajan los desarrolladores se exponen como entidades, y el término se incluye en los nombres de las cosas que usan los desarrolladores. Por ejemplo:

Para... Usando... Los desarrolladores harán lo siguiente...
Crear una tabla de Dataverse API web PUBLICAR una instancia de EntityMetadata EntityType en el recurso /EntityDefinitions
Crear una tabla de Dataverse .NET SDK Crear una instancia de la Clase EntityMetadata y usar la clase CreateEntityRequest para enviar esto al servicio de organización
Crear una fila o registro en una tabla Dataverse API web Los datos POST definidos como un EntityType específico. Puede encontrar una lista de estos EntityTypes aquí: Referencia de EntityType de API web
Crear una fila o registro en una tabla Dataverse .NET SDK Crear una instancia de la Clase de entidad o una clase que herede de ella (Cuenta, Contacto, etc.) y use la Clase CreateRequest para enviar esto al servicio de Organización. Un desarrollador puede encontrar la información que necesita para usar la clase Entity en la referencia de entidad.

Uso de terminología según protocolo o tecnología

La terminología utilizada en la documentación del desarrollador depende del protocolo o biblioteca de clases utilizados por los desarrolladores.

  • Al trabajar con la API web, utilizamos la terminología definida por el protocolo OData. Las estructuras de datos se definen como EntityTypes y tienen propiedades y propiedades de navegación.

  • Al trabajar con .NET SDK, usamos Entidad porque hay una clase Entity. La clase Entity tiene una propiedad Attributes que contiene una colección de atributos definidos por datos en una Clase AttributeMetadata y muchas otras clases derivadas de él.

Usamos la terminología adecuada para describir la tecnología SDK y Web API. La documentación del desarrollador a veces utiliza una terminología diferente a la de la interfaz de usuario de Power Apps. La siguiente tabla le ayudará a identificar algunas de las diferencias terminológicas entre la documentación del desarrollador y el resto de la documentación de Power Apps.

Interfaz de usuario de Power Apps SDK de Dataverse API web de Dataverse
Tabla Entity EntityType
Column Atributo Propiedad
Fila Grabar Grabar
Opciones Lista desplegable/OptionSet OptionSet
Sí/No Booleana Booleana