Compartir a través de

Ejemplo de operaciones básicas de la API web (PowerShell)

  • Artículo

Este ejemplo de PowerShell versión 7.4.0 demuestra cómo realizar operaciones de datos comunes utilizando la API web Dataverse y Visual Studio Code. Este ejemplo implementa las operaciones Dataverse y la salida de consola detalladas en el Ejemplo de operaciones básicas de la API web.

Esta muestra utiliza el Funciones auxiliares de PowerShell de la Web API de Dataverse para gestionar la autenticación y proporcionar funciones reutilizables para realizar operaciones comunes. Se hace referencia a estos scripts utilizando abastecimiento de puntos con las siguientes líneas:

. $PSScriptRoot\..\Core.ps1
. $PSScriptRoot\..\TableOperations.ps1
. $PSScriptRoot\..\CommonFunctions.ps1

Nota

Esta muestra debería funcionar con Windows, Linux y macOS, pero solo se ha probado en Windows.

Requisitos previos

Antes de ejecutar este ejemplo, debe leer estos artículos que explican los conceptos y patrones utilizados en estos ejemplos:

Estos artículos tienen los mismos requisitos previos.

Instale o verifique que lo siguiente esté instalado

Verificar instalación

  1. Abra Visual Studio Code.

  2. En el menú Terminal, seleccione Nueva terminal.

  3. En el panel de navegación de Visual Studio Code, seleccione el icono para la extensión de PowerShell.

  4. Copie y pegue el script siguiente en la ventana de la terminal de Visual Studio Code:

    Write-Host 'PowerShell Version:'$PSVersionTable.PSVersion.ToString()
Write-Host 'PowerShell Az version:'(Get-InstalledModule Az).Version

  5. Presione Entrar. El resultado debería similar al siguiente:

    PowerShell Version: 7.4.0
PowerShell Az version: 11.1.0

Si no ve resultados como este, instale o actualice los requisitos previos.

También necesitará

  • Una cuenta de usuario válida para un entorno de Dataverse
  • La dirección URL al entorno de Dataverse al que quiere conectarse. Consulte Ver recursos para desarrolladores para saber cómo encontrarlo. Se parece a esto: https://yourorg.crm.dynamics.com/, donde yourorg.crm es diferente.
  • Comprensión básica de lenguaje de scripting PowerShell

Cómo ejecutar esta muestra

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

  2. Abra el archivo BasicOperations.ps1 usando Visual Studio Code

  3. Edite esta línea para usar la URL del entorno al que quiere conectarse:

    Connect 'https://yourorg.crm.dynamics.com/' # change this

  4. (Opcional) Configure la variable $deleteCreatedRecords a $false si no desea eliminar los registros que crea esta muestra.

  5. Presione F5 para ejecutar el ejemplo.

  6. La primera vez que ejecuta el ejemplo se abre una ventana del navegador. En la ventana del navegador, ingrese o seleccione las credenciales que desea usar para autenticarse.

Para conectarse como un usuario diferente, ejecute el Comando Disconnect-AzAccount e inténtelo de nuevo.

Código

El código para este ejemplo está en: PowerAppsSamples/dataverse/webapi/PS/BasicOperations/BasicOperations.ps1

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.

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: Asocie y desasocie registros

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 registros de muestra

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
Inicio rápido de la API web con PowerShell y Visual Studio Code
Use PowerShell y Visual Studio Code con la API web de Dataverse
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

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).