Compartir a través de

Ejemplo: Operaciones de archivo usando la API web de Dataverse

En este ejemplo de .NET 6.0 se muestra cómo realizar operaciones con columnas de archivo mediante la API web de Dataverse.

Ver este ejemplo en Github

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

Requisitos previos

  • Microsoft Visual Studio 2022
  • Acceso a Dataverse con privilegios de administrador del sistema o 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 con Visual Studio 2022.

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

  4. Guarde el archivo

  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.

  • LÉAME: Operaciones de archivos de la API web con un ejemplo de acciones
  • Léame: Operaciones con archivos en la API web con ejemplo de trozos
  • LÉAME: Operaciones de archivos con la API web: ejemplo de flujo de datos

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

  • Program.cs: Operaciones de archivo de la API web con ejemplo de acciones
  • Ejemplo de operaciones de archivo con fragmentos en API web Program.cs
  • Program.cs: Operaciones de archivo de la API web con ejemplo de secuencias

Cada proyecto utiliza una clase 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 crea una columna de archivo llamada en la tabla de cuentas con un valor de 10 MB.

Actualizar una columna de archivo

La función actualiza el valor de la columna de archivo 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

El elemento recupera el valor de la columna de archivo y lo almacena en una variable llamada .

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 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
Sample: Operaciones de archivos mediante el SDK de Dataverse para .NET
Utilizar datos de la columna de imagen
Ejemplo: Operaciones de imagen usando la API web de Dataverse

  • Last updated on