Compartir a través de

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

En este ejemplo de PowerShell versión 7.4.0 se muestra cómo realizar operaciones de datos comunes mediante la API web de 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.

Ver este ejemplo en Github

Esta muestra utiliza las 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

Este ejemplo debe 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 Nuevo terminal.

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

  4. Copie y pegue el siguiente script en la ventana de 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 del 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 mediante 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.
  • Recupere 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 las siguientes relaciones:

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

Sección 4: Asociación y desasociación de 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 añadió una referencia de cada registro creado de esta muestra a una lista a medida que se iba creando. 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
Quick Start Web API with PowerShell and 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

  • Last updated on