Exemple : opérations sur les fichiers de pièce jointe et de notes à l’aide de l’API web Dataverse

Cet exemple .NET 6.0 montre comment effectuer des opérations à l’aide de données de fichier avec activitymimeattachment et annotation types d’entités à l’aide de l’API Web Dataverse.

Cet exemple utilise le code d’assistance commun dans l’exemple de projet de la Bibliothèque de classes WebAPIService (C#).

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 PowerApps-Samples .

2. Ouvrez le fichier PowerApps-Samples\dataverse\webapi\C#-NETx\AttachmentAndAnnotationOperations\AttachmentAndAnnotationOperations.sln à l’aide de 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.

   Remarque : le projet WebAPIService est inclus afin que chacun des autres projets puisse dépendre du code d’assistance commun fourni par le service. Les exemples utilisent plusieurs classes du dossier WebAPIService/Messages.

   Dans Solution Explorer, cliquez avec le bouton droit sur le projet que vous souhaitez exécuter et choisissez Set en tant que projet de démarrage.

3. Dans l’un ou l’autre des projets, modifiez le fichier appsettings.json pour définir les valeurs de propriété suivantes :

   Propriété	Instructions
   Url	URL pour votre environnement. Remplacez la valeur https://yourorg.api.crm.dynamics.com de l’espace réservé par la valeur de votre environnement. Voir Afficher les ressources pour les développeurs pour trouver ça.
   UserPrincipalName	Remplacez la valeur you@yourorg.onmicrosoft.com du paramètre fictif avec la valeur UPN pour accéder à l’environnement.
   Password	Remplacez la valeur yourPassword de l’espace réservé avec le mot de passe que vous utilisez.

4. Enregistrez le fichier appsettings.json.

   Remarque : les deux projets font référence au même fichier appsettings.json ; vous n’avez donc besoin de le faire qu’une seule fois pour exécuter l’un ou l’autre des projets.

5. Appuyez sur F5 pour exécuter l’exemple.

Démontre

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

• Fichier README de l’exemple d’opérations Attachment (ActivityMimeAttachment) de l’API Web
• Fichier README de l’exemple d’Annotation (Note) des opérations de l’API Web

Classe utilitaire

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 WebAPIServiceServiceservice, cette fonction renvoie la valeur d’entier maxuploadfilesize de la table organization.

SetMaxUploadFileSize

En utilisant le paramètre WebAPIServiceServiceservice, 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
Sample : opérations de fichier avec des pièces jointes et des notes à l’aide du Kit de développement logiciel (SDK) Dataverse pour .NET