Exemple d’opérations de base de l’API Web (C#)

Cet exemple .NET 6.0 montre comment effectuer des opérations de données communes à l’aide de l’API Web de Dataverse.

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

Conditions préalables

Les éléments suivants sont requis pour générer et exécuter cet exemple :

• Microsoft Visual Studio 2022.
• Accès à Dataverse avec les privilèges d′exécution des opérations de données.

Comment exécuter cet exemple

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

2. Localisez le dossier /dataverse/webapi/C#-NETx/BasicOperations/.

3. Ouvrir le fichier BasicOperations.sln en utilisant Visual Studio 2022

4. 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 développeurs pour trouver l’URL pour votre environnement.
   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.

5. Enregistrer le fichier appsettings.json

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

Code

Le code de cet exemple est ici : PowerApps-Samples/dataverse/webapi/C#-NETx/BasicOperations/Program.cs

Montre ce qui suit

Cet exemple comprend cinq régions :

Section 1 : Opérations de création et de mise à jour de base

Opérations :

• Créez un enregistrement de contact.
• Mettez à jour l’enregistrement de contact.
• Récupérez l’enregistrement de contact.
• Mettez à jour une seule propriété de l’enregistrement de contact.
• Récupérez une seule propriété de l’enregistrement de contact.

Section 2 : Créer un enregistrement associé à un autre

Opérations : Associez un nouvel enregistrement à un existant.

Section 3 : Créer des entités associées

Opérations : créez les entrées suivantes en une seule opération : un compte, son contact principal associé et les tâches ouvertes pour ce contact. Ces types d’entités ont les relations suivantes :

Accounts
    |---[Primary] Contact (N-to-1)
        |---Tasks (1-to-N)

Section 4 : Associer et dissocier des entités

Opérations :

• Ajoutez un contact à la collection contact_customer_accounts de compte.
• Supprimez un contact de la collection contact_customer_accounts de compte.
• Associez un rôle de sécurité à un utilisateur en utilisant la collection systemuserroles_association.
• Supprimez un rôle de sécurité pour un utilisateur en utilisant la collection systemuserroles_association.

Section 5 : Supprimer des entités

Opérations : une référence à chaque enregistrement créé dans cet exemple a été ajoutée à une liste lors de sa création. Cette section parcourt cette liste et supprime chaque enregistrement.

Nettoyer

Par défaut, cet exemple supprime tous les enregistrements qui y sont créés. Si vous souhaitez afficher les enregistrements créés une fois l’exemple terminé, remplacez la variable deleteCreatedRecords par false et vous serez invité à décider si vous souhaitez supprimer les enregistrements.

Voir aussi

Utilisation de l’API web Dataverse
Bibliothèque de classes WebAPIService (C#)
Créer une ligne de table à l’aide de l’API web
Mettre à jour et supprimer des lignes de table à l’aide de l’API web
Récupérer une ligne de table à l’aide de l’API web
Exemples d’API Web
Exemple d′opérations de base de l′API Web
Exemples de données de requête d’API web (C#)
Exemple d’opérations conditionnelles de l’API web (C#)
Exemple de fonctions et d’actions de l’API web (C#)
Exemple d’opérations de schéma de table de l’API web (C#)
Exemple d′opérations parallèles de l′API web WebApiService (C#)
Exemple d’opérations parallèles d’API Web avec des composants de flux de données TPL (C#)