Guía rápida de Dataverse

En este artículo se presentan conceptos clave sobre Dataverse que los programadores de Python (y otros no .NET) deben saber tener éxito al trabajar con Dataverse. También proporciona vínculos a información más detallada. Las funcionalidades de Dataverse son amplias, pero puede explorar estas otras funcionalidades a su propio ritmo.

Los programadores que codifican en C#/.NET deben leer el extenso Dataverse Developer Guide.

Tablas y mensajes

Los datos se almacenan en tablas, que se organizan en filas y columnas. Los mensajes son las operaciones que actúan en tablas y datos de tabla. Las tablas también se conocen como entidades y las filas a veces se denominan registros en la documentación.

Tablas

Normalmente se usan tres tipos de tablas en Dataverse: sistema, personalizable y personalizado. Las tablas del sistema, también conocidas como tablas predefinidas, no se pueden cambiar y admiten la funcionalidad básica de Dataverse. Puede modificar de forma interactiva o mediante programación tablas personalizables y personalizadas si tiene los permisos adecuados.

Para crear o modificar una tabla de forma interactiva, use el Centro de administración de Power Platform (PPAC). Para crear o modificar una tabla mediante programación, modifique los metadatos de la tabla. El SDK para Python incluye funciones (en client.tables) que permiten trabajar fácilmente con metadatos de tabla.

Las filas de tabla de Dataverse, también conocidas como registros, se representan como diccionarios de Python con nombres de esquema de columna.

Para obtener más información, consulte Referencia de EntityType de la API web y Usar la API web con definiciones de tabla.

Mensajes

Los mensajes representan la operación de servicio web que se va a realizar. Los mensajes pueden ser operaciones más sencillas, como crear, recuperar, actualizar y eliminar (CRUD). Los mensajes también pueden invocar operaciones más complejas como book o win, lo que podría iniciar una combinación de otras operaciones.

La referencia de tipo de entidad enumera todas las tablas conocidas (nocustom) y los mensajes estándar que admite cada tabla. Al crear una tabla personalizada, hay disponible un conjunto predeterminado de mensajes para esa tabla.

Seguridad

El acceso a los datos del entorno de Dataverse se limita en función del rol de seguridad (o roles) que un administrador le asigna y los permisos de administración de datos de ese rol. El rol puede conceder acceso a toda una tabla o la seguridad podría restringir el acceso a una fila y columna específicas.

Para obtener más información, consulte Introducción a la seguridady acceso a datos.

Personalizaciones y extensiones

En esta sección se tratan algunas maneras de personalizar y extender Dataverse.

Más información sobre las tablas

Dataverse admite tablas personalizables y personalizadas. Una tabla personalizable es una tabla existente que se incluye con Dataverse que puede modificar, por ejemplo, para agregar o eliminar columnas, cambiar el nombre de la tabla y mucho más.

Las tablas personalizadas son tablas que tú (o un tercero) creas. Como se indicó anteriormente en este artículo, el SDK proporciona Python funciones que puede usar para crear y eliminar tablas personalizadas.

Important

Debe incluir un valor de prefijo de personalización para todas las operaciones en tablas y columnas personalizadas (por ejemplo, "new_MyTestTable", no "MyTestTable").

Use siempre los nombres de esquema de tabla ("account", "new_MyTestTable") y los nombres de esquema de columna ("name", "new_MyTestColumn") en las llamadas API del SDK.

Para obtener más información, vea Table definitions in Microsoft Dataverse.

Extensiones

Puede modificar la funcionalidad del procesamiento de datos de Dataverse mediante controladores de eventos (denominados complementos) y actividades de flujo de trabajo personalizadas. Estos objetos de código personalizado compilados se registran en una determinada tabla y combinación de mensajes. Una actividad de complemento o flujo de trabajo puede modificar los datos antes o después de la operación principal de procesamiento de datos de Dataverse. Si ve resultados de datos diferentes de los esperados, una de estas extensiones podría ser la causa.

Existen otras formas de personalizar y ampliar Dataverse, pero la lista completa está fuera del ámbito de este artículo.

API de la Web

El SDK proporciona una interfaz de programación de Python que llama internamente a la API web de Dataverse. La DataverseClient clase proporciona una interfaz simplificada para la autorización de OData 2.0 según lo requiera la API web.

Puede invocar funciones y acciones de API web directamente desde el programa de Python. Sin embargo, el SDK para Python proporciona una sintaxis de programación más natural para acceder a los datos de Dataverse según lo previsto por los desarrolladores y científicos de datos de Python.

Soluciones

Una solución es un contenedor de carpetas y archivos que extienden y personalizan Dataverse. Las soluciones son el mecanismo para empaquetar personalizaciones y extensiones en un único archivo comprimido para la exportación. Puede importar ese archivo de solución en otros entornos (también conocidos como organizaciones).

Las extensiones y las personalizaciones siempre existen en una solución. En Dataverse, hay una solución predeterminada. Si agrega extensiones o personalizaciones a su entorno sin agregarlas a una solución personalizada, la solución predeterminada las contiene automáticamente.

Puede crear, administrar, exportar e importar soluciones de forma interactiva mediante PPAC o mediante programación mediante la API web.

Para obtener más información, consulte Conceptos de solución.