Partage via

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

  • Article

Cet exemple .NET 6.0 montre comment effectuer des opérations à l’aide de données de fichier avec des types d’entité activitymimeattachment et annotation à 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 Exemples PowerApps.

  2. Ouvrez le fichier PowerApps-Samples\dataverse\webapi\C#-NETx\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.

    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 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 pour définir les valeurs de propriété suivantes :

    Property Instructions
    Url URL pour votre environnement. Remplacez la valeur https://yourorg.api.crm.dynamics.com de l’espace réservé avec la valeur de votre environnement. Voir Afficher les ressources pour les développeurs pour trouver ça.
    UserPrincipalName Remplacez la valeur you@yourorg.onmicrosoft.com de l’espace réservé 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.

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 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
Exemple : opérations sur les fichiers avec des pièces jointes et des notes à l’aide du SDK Dataverse pour .NET