Partage via

Exemple : opérations sur les fichiers avec des pièces jointes et des notes à l’aide du SDK Dataverse pour .NET

  • Article

Cet exemple .NET 6.0 montre comment effectuer des opérations à l’aide de données de fichier avec les tables Attachment (ActivityMimeAttachment) et Note (Annotation) en utilisant le SDK Dataverse pour .NET.

Cet exemple utilise la classe Microsoft.PowerPlatform.Dataverse.Client.ServiceClient.

Conditions préalables

  • Microsoft Visual Studio 2022
  • Accédez à Dataverse avec les privilèges d’administrateur système ou de personnalisateur du système.

Comment exécuter l’exemple

  1. Clonez ou téléchargez le référentiel Exemples PowerApps.

  2. Ouvrez le fichier PowerApps-Samples\dataverse\orgsvc\C#-NETCore\AttachmentAndAnnotationOperations\AttachmentAndAnnotationOperations.sln en utilisant Visual Studio 2022.

    Cette solution contient deux projets qui incluent des exemples :

    • ActivityMimeAttachmentOperations : montre comment utiliser des pièces jointes.
    • AnnotationOperations : montre comment utiliser des annotations.

    Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet que vous souhaitez exécuter et choisissez Définir comme projet de démarrage.

  3. Dans l’un ou l’autre des projets, modifiez le fichier appsettings.json. Définissez les paramètres Url et Username de la chaîne de connexion en fonction de votre environnement de test.

    L’URL de l’environnement se trouve dans le centre d’administration Power Platform. Il se présente sous la forme https://<environment-name>.crm.dynamics.com.

  4. Générez la solution, puis exécutez le projet souhaité.

Lors de l’exécution de l’exemple, vous serez invité dans le navigateur par défaut à sélectionner un compte d’utilisateur de l’environnement et à saisir un mot de passe. Pour éviter d’effectuer cette opération à chaque fois que vous exécutez un exemple, insérez un paramètre de mot de passe dans la chaîne de connexion du fichier appsettings.json. Par exemple : 

{
"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"
  }
}

Lisez les informations importantes suivantes sur l’utilisation d’une chaîne de connexion dans le code d’application.

Important

Microsoft vous recommande d’utiliser le flux d’authentification le plus sécurisé disponible. Le flux d’authentification décrit dans cet article nécessite un très haut degré de confiance dans l’application et comporte des risques qui ne sont pas présents dans d’autres flux. Vous ne devez utiliser ce flux que lorsque d’autres flux plus sécurisés, tels que les identités managées, ne sont pas viables.

Astuce

Vous pouvez définir une variable d’environnement utilisateur nommée DATAVERSE_APPSETTINGS sur le chemin d’accès du fichier appsettings.json stocké n’importe où sur votre ordinateur. Les exemples utiliseront ce fichier appsettings si la variable d’environnement existe et n’est pas nulle. Assurez-vous de vous déconnecter et de vous reconnecter après avoir défini la variable pour qu’elle prenne effet. Pour définir une variable d’environnement, accédez à Paramètres > Système > À propos de, sélectionnez Paramètres système avancés, puis choisissez Variables d’environnement.

Montre ce qui suit

Cet exemple est une solution avec deux projets. Consultez les fichiers LISEZMOI respectifs pour obtenir plus de détails sur chaque projet.

Classe Utility

Les deux projets utilisent une classe Utility partagée pour effectuer des opérations courantes. Cette classe contient trois méthodes statiques :

GetMimeType

Sur la base d’un paramètre FileInfo, cette fonction utilise Microsoft.AspNetCore.StaticFiles.FileExtensionContentTypeProvider pour essayer d’obtenir le type mime du fichier. S’il ne peut pas être déterminé, elle renvoie application/octet-stream

GetMaxUploadFileSize

En utilisant le paramètre IOrganizationServiceservice, cette fonction renvoie la valeur d’entier maxuploadfilesize de la table organization.

SetMaxUploadFileSize

En utilisant le paramètre IOrganizationServiceservice, cette fonction définit la valeur d’entier maxuploadfilesize de la table organization sur la valeur du paramètre d’entier maxUploadFileSizeInBytes.

Voir aussi

Utiliser des données de fichier avec des enregistrements de pièce jointe et de note
Exemple : opérations sur les fichiers de pièce jointe et de notes à l’aide de l’API web Dataverse