Exemple : Exécuter plusieurs demandes

Cet exemple montre comment exécuter plusieurs requêtes de message d’organisation en utilisant un seul appel de méthode de service Web, en transmettant ExecuteMultipleRequest sous la forme d’un paramètre. La réduction du nombre de requêtes de message qui doivent être transmises sur le réseau augmente les performances de traitement des messages.

Comment exécuter cet exemple

1. Téléchargez ou clonez le dépôt Microsoft/PowerApps-Samples afin d’avoir une copie locale.
2. (Facultatif) Modifiez le fichier dataverse/App.config pour définir une connection string en spécifiant l’instance de Microsoft Dataverse à laquelle vous souhaitez vous connecter.
3. Ouvrez l’exemple de solution dans Visual Studio et appuyez sur F5 pour exécuter l’exemple. Après avoir spécifié une connection string dans dataverse/App.config, tout exemple que vous exécutez utilise ces informations de connexion.

Si vous ne spécifiez pas de connection string dans dataverse/App.config fichier, une boîte de dialogue s'ouvre chaque fois que vous exécutez l'exemple et que vous devez entrer des informations sur l'instance Dataverse à laquelle vous souhaitez vous connecter et les informations d'identification à utiliser. Cette boîte de dialogue met en cache les connexions précédentes afin que vous puissiez choisir une connexion déjà utilisée.

Ces exemples de ce référentiel qui nécessitent une connexion à une instance Dataverse pour s’exécuter incluent une référence liée au dataverse/App.config fichier.

En quoi consiste cet exemple

Le message ExecuteMultipleRequest est destiné à un usage dans un scénario contenant les données nécessaires pour exécuter une ou plusieurs requêtes de messages en tant qu’opération unique et pour renvoyer éventuellement un ensemble de résultats.

Comment cet échantillon fonctionne

Afin de simuler le scénario décrit dans En quoi consiste cet exemple, l′exemple procède comme suit :

Installation

Vérification de la version actuelle de l'organisation.

Démontrer

1. La méthode ExecuteMultipleRequest crée l’objet ExecuteMultipleRequest.
2. La méthode ExecutingMultipleSettings attribue les paramètres qui définissent le comportement d’exécution : poursuivre sur erreur, renvoyer des réponses.
3. La méthode OrganizationRequestCollection crée une collection de requêtes d’organisation vides.
4. La méthode CreateRequest est ajoutée pour chaque table à la collection de requêtes.
5. La classe GetCollectionOdEntitiesToUpdate met à jour les tables créées précédemment.

Nettoyer

Affichez une option pour supprimer les enregistrements créés lors de l’Installation. La suppression est facultative au cas où vous souhaiteriez examiner les tables et les données créées par l’échantillon. Vous pouvez supprimer manuellement l’enregistrement pour obtenir le même résultat.