Compartir vía

Ejemplo: Operaciones de archivo usando la API web de Dataverse

  • Artículo

Este ejemplo .NET 6.0 demuestra cómo realizar operaciones con columnas de archivo utilizando la API web de Dataverse.

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

Requisitos previos

  • Microsoft Visual Studio 2022
  • Accesa a Dataverse con Administrador del sistema o privilegios de personalizador del sistema.

Cómo ejecutar el ejemplo

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

  2. Abra el archivo PowerApps-Samples\dataverse\webapi\C#-NETx\FileOperations\FileOperations.sln usando Visual Studio 2022.

  3. 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 para desarrolladores para encontrar esto.
    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.

  4. Guarde el archivo appsettings.json

  5. Seleccione el proyecto que quiere ejecutar en el explorador de soluciones. Haga clic derecho en el proyecto y elija Establecer como proyecto de inicio.

  6. Presione F5 para ejecutar el ejemplo.

Salida de muestra

El resultado del ejemplo deberá ser ahora similar a esto:

Creating file column named 'sample_FileColumn' on the account table ...
Created file column named 'sample_FileColumn' in the account table.
Created account record with accountid:5fb4f993-7c55-ed11-bba3-000d3a9933c9
Uploading file Files\25mb.pdf ...
Uploaded file Files\25mb.pdf
Downloading file from accounts(5fb4f993-7c55-ed11-bba3-000d3a9933c9)/sample_filecolumn ...
Downloaded the file to E:\GitHub\PowerApps-Samples\dataverse\webapi\C#-NETx\FileOperations\FileOperationsWithActions\bin\Debug\net6.0//downloaded-25mb.pdf.
Deleted the file using FileId.
Deleted the account record.
Deleting the file column named 'sample_filecolumn' on the account table ...
Deleted the file column named 'sample_filecolumn' in the account table.

Demostraciones

Este ejemplo es una solución con tres proyectos. Cada proyecto realiza las mismas operaciones de manera diferente. Consulte los archivos LÉAME respectivos para obtener detalles sobre cada proyecto.

El código de cada proyecto se encuentra en el archivo Program.cs correspondiente.

Cada proyecto utiliza una clase Utility para realizar operaciones comunes. Esta clase está en el archivo Utility.cs.

En general, cada proyecto realiza estas operaciones:

Crear una columna de archivo

La función Utility.CreateFileColumn crea una columna de archivo llamada sample_FileColumn en la tabla de cuentas con un valor MaxSizeInKb de 10 MB.

Actualizar una columna de archivo

La función Utility.UpdateFileColumnMaxSizeInKB actualiza el valor MaxSizeInKb de la columna de archivo sample_FileColumn a 100 MB.

Consejo: Si desea crear algunos escenarios de error porque el tamaño de la columna del archivo es demasiado pequeño, comente esta línea.

Recuperar el valor MaxSizeInKb de la columna del archivo

Utility.GetFileColumnMaxSizeInKb recupera el valor MaxSizeInKb valor de la columna de archivo sample_FileColumn y la almacena en una variable llamada fileColumnMaxSizeInKb.

Crear un registro contable

Antes de que se pueda cargar un archivo en la columna de archivo, debe existir un registro.

Cargar un archivo

La función para cargar el archivo acepta un parámetro llamado fileColumnMaxSizeInKb y usa ese valor para probar el tamaño del archivo. Si el archivo es más grande que el límite configurado de la columna del archivo, arrojará un error.

Descargar el archivo

Si la carga del archivo tuvo éxito, la función para descargar el archivo lo guardará en el directorio actual. Puede intentar abrir el archivo para confirmar que se cargó y descargó correctamente.

Eliminar el archivo

Si la carga del archivo se realizó correctamente, el archivo se elimina.

Limpiar

Para dejar el sistema en el estado anterior a la ejecución del ejemplo, hace lo siguiente:

  • Eliminar el registro de cuenta
  • Eliminar la columna de archivo

Consulte también

Usar datos de columna de archivo
Ejemplo: Operaciones de archivo usando la SDK de Dataverse para .NET
Usar datos de columna de imagen
Ejemplo: Operaciones de imagen usando la API web de Dataverse

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).