Partager via

Exemple : opérations de fichier en utilisant l’API Web de Dataverse

  • Article

Cet exemple .NET 6.0 montre comment effectuer des opérations avec les colonnes de fichier en utilisant l’API Web de Dataverse.

Cet exemple utilise le code d’assistance commun dans 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\FileOperations\FileOperations.sln en utilisant Visual Studio 2022.

  3. 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. Enregistrer le fichier appsettings.json

  5. Sélectionnez les projets que vous souhaitez exécuter dans l’explorateur de solutions. Cliquez avec le bouton droit sur le projet et choisissez Définir comme projet de démarrage.

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

Sortie de l’exemple

La sortie de l’exemple doit ressembler à ce qui suit :

Creating file column named 'sample_FileColumn' on the account table ...
Created file column named 'sample_FileColumn' in the account table.
Created account record with accountid:5fb4f993-7c55-ed11-bba3-000d3a9933c9
Uploading file Files\25mb.pdf ...
Uploaded file Files\25mb.pdf
Downloading file from accounts(5fb4f993-7c55-ed11-bba3-000d3a9933c9)/sample_filecolumn ...
Downloaded the file to E:\GitHub\PowerApps-Samples\dataverse\webapi\C#-NETx\FileOperations\FileOperationsWithActions\bin\Debug\net6.0//downloaded-25mb.pdf.
Deleted the file using FileId.
Deleted the account record.
Deleting the file column named 'sample_filecolumn' on the account table ...
Deleted the file column named 'sample_filecolumn' in the account table.

Montre ce qui suit

Cet exemple est une solution avec trois projets. Chaque projet effectue les mêmes opérations d’une manière différente. Consultez les fichiers LISEZMOI respectifs pour obtenir plus de détails sur chaque projet.

Le code de chaque projet se trouve dans le fichier Program.cs respectif.

Chaque projet utilise une classe Utility partagée pour effectuer des opérations courantes. Cette classe se trouve dans le fichier Utility.cs.

À un niveau supérieur, chaque projet effectue ces opérations :

Créer une colonne de fichier

La fonction Utility.CreateFileColumn crée une colonne de fichier nommée sample_FileColumn dans la table des comptes avec une valeur MaxSizeInKb de 10 Mo.

Mettre à jour une colonne de fichier

La fonction Utility.UpdateFileColumnMaxSizeInKB met à jour la valeur MaxSizeInKb de la colonne de fichier sample_FileColumn sur 100 Mo.

Conseil : si vous souhaitez créer des scénarios d’erreur car la taille de la colonne de fichier est trop petite, commentez cette ligne.

Récupérer la valeur MaxSizeInKb de la colonne de fichier

La fonction Utility.GetFileColumnMaxSizeInKb récupère la valeur MaxSizeInKb de la colonne de fichier sample_FileColumn et la stocke dans une variable nommée fileColumnMaxSizeInKb.

Créer un enregistrement de compte

Avant qu’un fichier puisse être chargé dans la colonne de fichier, un enregistrement doit exister.

Télécharger un fichier

La fonction de chargement du fichier accepte un paramètre nommé fileColumnMaxSizeInKb et utilise cette valeur pour tester la taille du fichier. Si le fichier est plus volumineux que la limite configurée de la colonne de fichier, une erreur est générée.

Télécharger le fichier

Si le chargement du fichier a réussi, la fonction de téléchargement du fichier l’enregistrera dans le répertoire actuel. Vous pouvez essayer d’ouvrir le fichier pour confirmer qu’il a été chargé et téléchargé correctement.

Supprimer le fichier

Si le chargement du fichier a réussi, le fichier est supprimé.

Nettoyer

Pour laisser le système dans l’état antérieur à l’exécution de l’exemple, il effectue les opérations suivantes :

  • Supprimer l’enregistrement de compte
  • Supprimer la colonne de fichier

Voir aussi

Utiliser les données de colonne de fichier
Exemple : opérations de fichier en utilisant le SDK Dataverse pour .NET
Utiliser les données de colonne d’image
Exemple : opérations sur les images en utilisant l’API Web de Dataverse

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).