Ejemplo de datos de consulta de API web (C#)

En este ejemplo de .NET 6.0 se muestra cómo realizar operaciones de datos comunes mediante la API web de Dataverse.

Esta muestra utiliza el código auxiliar común de la biblioteca de clases WebAPIService (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/QueryData/.

3. Abra el archivo QueryData.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/QueryData/Program.cs

Demostraciones

Esta muestra tiene 11 regiones:

Sección 0: Crear registros para consultar

Operaciones: Crear 1 registro con 9 registros relacionados. Cada uno tiene 3 registros relacionados.

Estos son los datos que se usarán en el ejemplo.

Sección 1 Seleccionar propiedades específicas

Operaciones:

• Utilizar frente a una entidad de contacto para obtener las propiedades que deseas.
• Incluir anotaciones proporciona acceso a valores formateados con la anotación

Sección 2 Uso de funciones de consulta

Operaciones:

• Uso de funciones de consulta estándar (, , ) para filtrar los resultados.
• Uso de funciones de consulta de Dataverse (, , , , )
• Uso de operadores de filtro y operadores lógicos (, , , , )
• Establecer prioridad usando paréntesis

Sección 3 Pedidos y alias

Operaciones:

• Usar
• Uso de alias parametrizados () con y

Sección 4 Limitar y contar los resultados

Operaciones:

• Limitar los resultados usando .
• Obtenga un valor de conteo usando .

Sección 5 Paginación

Operaciones:

• Use el encabezado de solicitud para limitar el número de filas devueltas.
• Use la URL devuelta con la anotación para recuperar el siguiente conjunto de registros.

Sección 6 Expandir resultados

Operaciones:

• con propiedades de navegación de un solo valor.
• con la propiedad del socio.
• con propiedades de navegación valoradas en colecciones.
• con múltiples tipos de propiedades de navegación en una sola solicitud.
• anidado.
• Entidad anidada que tiene tanto propiedades de navegación de valor único como de valor coleccionable.

Sección 7 Agregación de resultados

Operaciones: Uso de con , , y .

Sección 8: Consultas FetchXML

Operaciones:

• Envío de solicitudes con fetchXml usando
• Paginación usando los atributos y .

Sección 9 Utilizar consultas predefinidas

Operaciones:

• Uso de para devolver los resultados de una consulta guardada (vista del sistema)
• Uso de para devolver los resultados de una consulta de usuario (vista guardada)

Sección 10: 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 .

Consulte también

Consultar datos utilizando la API web
Ejemplo de datos de consulta de la API web
Usar la API web de DataverseEjemplo de operaciones básicas de la 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#)