Compartir a través de

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

  • Artículo

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

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

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

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

  4. 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"
  }
}

Lea la siguiente información importante sobre el uso de una cadena de conexión en el código de la aplicación.

Importante

Microsoft recomienda utilizar el flujo de autenticación más seguro disponible. El flujo de autenticación descrito en este artículo requiere un alto grado de confianza en la aplicación y conlleva riesgos que no están presentes en otros flujos. Solo debe usar este flujo cuando otros flujos más seguros, como las identidades administradas, no sean viables.

Propina

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 IOrganizationServiceservice, esta función devuelve el valor maxuploadfilesize de entero de la tabla organization.

SetMaxUploadFileSize

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

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