Compartir a través de

Ejemplo de operaciones de esquema de tabla de API web (C#)

En este ejemplo de .NET 6.0 se muestra cómo realizar operaciones que crean y modifican definiciones de tabla, columna y relación mediante la API web de Dataverse.

Ver este ejemplo en Github

Esta muestra utiliza el código auxiliar común de la biblioteca de clases WebAPIService (C#).

Nota

Este ejemplo implementa las operaciones de Dataverse y la salida de la consola detalladas en el Ejemplo de operaciones de esquema de tabla de la API web y utiliza las construcciones comunes de C# que se describen en Ejemplos de API web (C#).

Requisitos previos

Los siguientes elementos son necesarios para compilar y ejecutar este ejemplo:

  • Microsoft Visual Studio 2022.
  • Acceso a Dataverse con privilegios para realizar operaciones de datos.

Cómo ejecutar esta muestra

  1. Clonar o descargar el repositorio de ejemplos de PowerApps.

  2. Localizar la carpeta /dataverse/webapi/C#-NETx/MetadataOperations/.

  3. Abra el archivo MetadataOperations.sln mediante Visual Studio 2022

  4. Editar el archivo para establecer los siguientes valores de propiedad:

    Propiedad Instrucciones
    Url La URL de su entorno. Reemplace el valor del marcador de posición con el valor para su entorno. Consulte Ver recursos para desarrolladores para encontrar esto.
    UserPrincipalName Reemplazar el valor de marcador de posición con el valor de UPN que usa para acceder al entorno.
    Password Reemplace el valor del marcador de posición con la contraseña que utiliza.

  5. Guarde el archivo

  6. Presione F5 para ejecutar el ejemplo.

Código

El código para este ejemplo está aquí: PowerApps-Samples/dataverse/webapi/C#-NETx/MetadataOperations/Program.cs

Demostraciones

Esta muestra tiene 11 regiones:

Sección 0: Crear un editor y una solución

Operaciones: crear un registro de solución y un registro de editor asociado.

Nota

Todos los componentes de la solución creados en este ejemplo se asociarán a la solución para que puedan exportarse. Para operaciones sin un mensaje con nombre, esta asociación se crea usando el encabezado de solicitud que establece el nombre único de la solución establecido como valor. Todos los componentes de la solución tienen sus nombres prefijados con el prefijo de personalización del publicador.

Sección 1: Crear, recuperar y actualizar una tabla

Operaciones:

  1. Crear una nueva tabla propiedad del usuario enviando una solicitud a .
  2. Recuperar la tabla creada enviando una solicitud a .
  3. Actualizar la tabla creada enviando una solicitud a .

Sección 2: Crear, recuperar y actualizar columnas

Operaciones:

  1. Crear una nueva columna booleana para la tabla enviando una solicitud a .
  2. Recuperar la columna booleana enviando una solicitud a .
  3. Actualizar la columna booleana enviando una solicitud a .
  4. Actualice las etiquetas de opción para la columna booleana mediante la acción UpdateOptionValue.
  5. Crear y recuperar una nueva columna de fecha y hora para la tabla.
  6. Crear y recuperar una nueva columna decimal para la tabla .
  7. Crear y recuperar una nueva columna de enteros para la tabla .
  8. Crear y recuperar una nueva columna de memo para la tabla.
  9. Crear y recuperar una nueva columna de dinero para la tabla .
  10. Crear y recuperar una nueva columna de opción para la tabla .
  11. Agregue una nueva opción a la columna usando la acción InsertOptionValue.
  12. Cambie el orden de las opciones de la columna usando la acción OrderOption.
  13. Elimina una de las opciones de la columna usando la acción DeleteOptionValue.
  14. Cree y recupere una nueva columna de selección múltiple para la tabla t.
  15. Cree una nueva opción de Estado para la tabla usando la acción InsertStatusValue.

Sección 3: Crear y usar OptionSet global

Operaciones:

  1. Cree una nueva opción global denominada enviando una solicitud a .
  2. Recupere la opción global enviando una solicitud a .
  3. Cree una nueva columna de elección para la tabla usando la elección global enviando una solicitud a y asociándola a la elección global.

Sección 4: Crear relación con el cliente

Operaciones:

  1. Cree una nueva columna de cliente para la tabla usando la acción CreateCustomerRelationships.
  2. Recupere la columna de cliente enviando una solicitud a .
  3. Recupere las relaciones creadas para la columna de cliente mediante el envío de solicitudes de GET a /RelationshipDefinitions(<id>)/Microsoft.Dynamics.CRM.OneToManyRelationshipMetadata".".

Sección 5: Crear y recuperar una relación de uno a muchos

Operaciones:

  1. Verifique que la tabla sea elegible para ser referenciada en una relación de 1:N usando la función CanBeReferenced.
  2. Verifique que la tabla sea elegible para referenciar otras tablas en una relación de 1:N usando la función CanBeReferencing.
  3. Identifique qué otras tablas puede referenciar la tabla en una relación de 1:N usando la función GetValidReferencingEntities.
  4. Cree una relación 1:N entre las tablas y enviando una solicitud a .
  5. Recupere la relación 1:N enviando GET solicitud a /RelationshipDefinitions(<id>)/Microsoft.Dynamics.CRM.OneToManyRelationshipMetadata.

Sección 6: Crear y recuperar una relación de muchos a uno

Operaciones:

  1. Cree una relación N:1 entre las tablas y mediante el envío de una solicitud a .
  2. Recupere la relación N:1 mediante el envío de una solicitud de GET a /RelationshipDefinitions(<id>)/Microsoft.Dynamics.CRM.OneToManyRelationshipMetadata.

Sección 7: Crear y recuperar una relación de muchos a muchos

Operaciones:

  1. Verifique que las tablas y sean elegibles para participar en una relación de N:N usando la función CanManyToMany.
  2. Verifique que las tablas y sean elegibles para participar en una relación de N:N usando la función GetValidManyToMany.
  3. Cree una relación N:N entre las tablas y enviando una solicitud a .
  4. Recupere la relación N:N enviando GET solicitud a /RelationshipDefinitions(<id>)/Microsoft.Dynamics.CRM.ManyToManyRelationshipMetadata.

Sección 8: Exportar una solución administrada

Operaciones: Exporte la solución creada en Sección 0: Crear editor y solución que contiene los elementos creados en este ejemplo usando la Acción ExportSolution.

Sección 9: Eliminar registros de muestra

Operaciones: Se añadió una referencia de cada registro creado de esta muestra a una lista a medida que se iba creando. En este ejemplo, todos los registros se eliminan mediante una operación .

Sección 10: Importar y eliminar una solución administrada

Operaciones:

  1. Importe la solución exportada en la Sección 8 usando la acción ImportSolution.
  2. Consulte la tabla de soluciones para obtener el detalle de la solución importada.
  3. Elimine la solución importada usando el .

Limpiar

Por defecto esta muestra eliminará todos los registros creados en ella. Si desea ver los registros creados después de completar la muestra, cambie la variable a y se le pedirá que decida si desea eliminar los registros.

Consulte también

Usar la API web de Dataverse
Biblioteca de clases WebAPIService (C#)
Utilizar la API web con definiciones de tabla
Ejemplos de la API web
Ejemplo de operaciones básicas de la API web (C#)
Ejemplo de datos de consulta de API web (C#)
Ejemplo de operaciones condicionales de la API web (C#)
Ejemplo de funciones y acciones de la API web (C#)
Ejemplo de operaciones en paralelo de la API web WebApiService (C#)
Ejemplo de operaciones paralelas de API web con componentes de flujo de datos TPL (C#)

  • Last updated on