Exemple : Convertir des requêtes entre FetchXML et QueryExpression

Cet exemple montre comment convertir des requêtes entre FetchXML et QueryExpression.

Comment exécuter cet exemple

1. Téléchargez ou clonez le référentiel Exemples pour avoir une copie locale.
2. (Facultatif) Modifiez le fichier dataverse/App.config pour définir une chaîne de connexion qui spécifie l’instance 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 chaîne de connexion dans le fichier dataverse/App.config, tout exemple que vous exécutez utilise ces informations de connexion.

Si vous ne spécifiez pas de chaîne de connexion dans le fichier dataverse/App.config, une boîte de dialogue s’ouvre chaque fois que vous exécutez l’exemple et vous devez entrer des informations sur l’instance Dataverse à laquelle vous souhaitez vous connecter et sur les informations d’identification que vous souhaitez 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.

Les 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 fichier dataverse/App.config.

En quoi consiste cet exemple

Les messages QueryExpression et fetchExpression sont destinés à être utilisés dans un scénario qui contient des requêtes dans une hiérarchie d’expressions et FetchXML respectivement.

Utiliser cet exemple

Afin de simuler le scénario décrit dans En quoi consiste cet exemple, l’exemple effectue les opérations suivantes :

Configuration

1. Vérifie la version actuelle de l′organisation.
2. La méthode CreateRequireRecords crée un compte et deux enregistrements de contact utilisés par l’exemple.
3. Le QueryExpression construit une QueryExpression à convertir en FetchXML.
4. La classe DoFetchXmlToQueryExpressionConversion crée une requête Fetch à convertir en une QueryExpression.
5. La conversionRequest méthode convertit l’ QueryExpression générée en FetchXML et vice versa.
6. Utilisez la requête convertie avec une demande RetrieveMultiple.

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.