Ejemplo: operaciones de archivo con archivos adjuntos y notas mediante el Dataverse SDK para .NET

Artículo
03/14/2023

Este ejemplo de .NET 6.0 demuestra cómo realizar operaciones utilizando datos de archivo con las tablas Adjunto (ActivityMimeAttachment) y Nota (Anotación) usando el Dataverse SDK para .NET.

Este ejemplo usa la clase Microsoft.PowerPlatform.Dataverse.Client.ServiceClient.

Requisitos previos

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

Cómo ejecutar el ejemplo

Clonar o descargar el repositorio de ejemplos de PowerApps.
Abra el archivo PowerApps-Samples\dataverse\orgsvc\C#-NETCore\AttachmentAndAnnotationOperations\AttachmentAndAnnotationOperations.sln usando Visual Studio 2022.

Esta solución contiene dos proyectos que incluyen ejemplos:
- ActivityMimeAttachmentOperations: demuestra el uso de archivos adjuntos.
- AnnotationOperations: demuestra el uso de Anotaciones.
En Explorador de la solución, haga clic con el botón derecho en el proyecto que desea ejecutar y seleccione Establecer como proyecto de inicio.
En cualquier proyecto, edite el archivo appsettings.json. Establezca los parámetros Url y Username de la cadena de conexión según corresponda para su entorno de prueba.

La URL del entorno se pueden encontrar en el centro de administración Power Platform. Tiene la forma https://<environment-name>.crm.dynamics.com.
Cree la solución y luego ejecute el proyecto deseado.

Cuando se ejecute el ejemplo, se le solicitará en el navegador predeterminado que seleccione una cuenta de usuario del entorno e introduzca una contraseña. Para evitar tener que hacer esto cada vez que ejecuta un ejemplo, inserte un parámetro de contraseña en la cadena de conexión en el archivo appsettings.json. Por ejemplo:

{
"ConnectionStrings": {
    "default": "AuthType=OAuth;Url=https://myorg.crm.dynamics.com;Username=someone@myorg.onmicrosoft.com;Password=mypassword;RedirectUri=http://localhost;AppId=51f81489-12ee-4a9e-aaae-a2591f45987d;LoginPrompt=Auto"
  }
}

Consejo: puede establecer una variable de entorno de usuario denominada DATAVERSE_APPSETTINGS en la ruta del archivo appsettings.json almacenado en cualquier lugar de su ordenador. Los ejemplos utilizarán ese archivo de configuración de aplicaciones si la variable de entorno existe y no es nula. Asegúrese de cerrar la sesión y volver a iniciarla después de definir la variable para que surta efecto. Para establecer una variable de entorno, vaya a Configuración > Sistema > Acerca de, seleccione Configuración avanzada del sistema y luego elija Variables de entorno.

Demostraciones

Este ejemplo es una solución con dos proyectos. Consulte los archivos LÉAME respectivos para obtener detalles sobre cada proyecto.

Clase de utilidad

Ambos proyectos utilizan una clase Utility para realizar operaciones comunes. Esta clase contiene tres métodos estáticos:

GetMimeType

Basado en el parámetro FileInfo, esta función utiliza Microsoft.AspNetCore.StaticFiles.FileExtensionContentTypeProvider para tratar de obtener el tipo MIME del archivo. Si esto no se puede determinar, devuelve application/octet-stream

GetMaxUploadFileSize

Utilizando el parámetro IOrganizationService service, esta función devuelve el valor entero de maxuploadfilesize de la tabla organization.

SetMaxUploadFileSize

Utilizando el parámetro IOrganizationService service, esta función establece el valor entero de maxuploadfilesize de la tabla organization al valor el parámetro de entero maxUploadFileSizeInBytes.

Consulte también

Usar datos de archivo con registros de Adjuntos y Notas
Ejemplo: operaciones con archivos adjuntos y anotaciones utilizando 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).

Compartir vía