Ejemplo de operaciones básicas de la API web (C#)

Artículo
02/01/2024

Este ejemplo .NET 6.0 demuestra cómo realizar operaciones de datos comunes utilizando la API web de Dataverse.

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 básicas de API web y utiliza las construcciones comunes de C# que se describen en Ejemplos de API web (C#).

Requisitos previos

Estos 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

Clonar o descargar el repositorio de ejemplos de PowerApps.
Localizar la carpeta /dataverse/webapi/C#-NETx/BasicOperations/.
Abrir el archivo BasicOperations.sln usando Visual Studio 2022

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

Property	Instrucciones
`Url`	La URL para su entorno. Reemplazar el valor de marcador de posición `https://yourorg.api.crm.dynamics.com` con el valor para su entorno. Consulte Ver recursos de desarrollador para encontrar la URL de su entorno.
`UserPrincipalName`	Reemplazar el valor de marcador de posición `you@yourorg.onmicrosoft.com` con el valor de UPN que usa para acceder al entorno.
`Password`	Reemplazar el valor de marcador de posición `yourPassword` con la contraseña que utiliza.

Guarde el archivo appsettings.json
Presione F5 para ejecutar el ejemplo.

Código

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

Demostraciones

Este ejemplo tiene cinco regiones:

Sección 1: Operaciones básicas para crear y actualizar

Operaciones:

Crear un registro de contacto.
Actualizar el registro de contacto.
Recuperar el registro de contacto.
Actualizar una sola propiedad del registro de contacto.
Recuperar una sola propiedad del registro de contacto.

Sección 2: Crear registro asociado a otro

Operaciones: Asociar un nuevo registro a uno existente.

Sección 3: Crear entidades relacionadas

Operaciones: Crear las siguientes entradas en una operación: una cuenta, su contacto principal asociado y tareas abiertas para ese contacto. Estos tipos de entidad tienen el siguiente Relaciones:

Accounts
    |---[Primary] Contact (N-to-1)
        |---Tasks (1-to-N)

Sección 4: Asociar y desasociar entidades existentes

Operaciones:

Agregar un contacto a la colección contact_customer_accounts de la cuenta.
Quitar un contacto de la colección contact_customer_accounts de la cuenta.
Asociar un rol de seguridad a un usuario usando la colección systemuserroles_association.
Quitar un rol de seguridad para un usuario usando la colección systemuserroles_association.

Sección 5: Eliminar entidades de ejemplo

Operaciones: se agregó una referencia a cada registro creado en esta muestra a una lista a medida que se creaba. Esta sección recorre esa lista y elimina cada registro.

Limpiar

De forma predeterminada, esta muestra elimina todos los registros creados en ella. Si desea ver los registros creados después de completar la muestra, cambie la variable deleteCreatedRecords a false 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#)
Crear una fila de tabla usando la API web
Actualizar y eliminar filas de tablas usando la API web
Recuperar una fila de tabla usando la API web
Ejemplos de la API web
Ejemplo de operaciones básicas de la API web
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 de esquema de tabla de 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#)