Interroger des données à l’aide de FetchXML

Effectué

FetchXML est un langage de requête développé par Microsoft pour vous permettre d’exécuter des opérations de requête complexes avec les données Microsoft Dataverse. Il fournit considérablement plus d’options de filtrage que les connecteurs OData et vous permet d’afficher les libellés des données de référence tels que les libellés du groupe d’options ou les champs de recherche.

Vous pouvez exécuter des requêtes FetchXML avec les méthodes suivantes :

  • API web Dataverse

  • service Organization

Vous pouvez également appliquer un filtre FetchXML personnalisé à un champ de recherche dans une application pilotée par modèle. Cette approche permet des scénarios de recherche plus complexes que vous ne pouvez pas réaliser facilement au départ. Pour en savoir plus sur l’implémentation de ce processus, consultez la Référence de l’API client addCustomFilter.

Exemple de requête FetchXML

L’exemple de requête suivant récupère les champs accountid et name de la table Compte :

<fetch mapping='logical'>
   <entity name='account'>
      <attribute name='accountid'/>
      <attribute name='name'/>
   </entity>
</fetch>

Si vous devez filtrer ces données, par exemple par état, vous pouvez faire comme dans l’exemple de requête suivant :

<fetch mapping='logical'>
   <entity name='account'>
      <attribute name='accountid'/>
      <attribute name='name'/>
      <filter type='and'>
        <condition attribute='address1_stateorprovince' operator='eq' value='WA' />
      </filter>
   </entity>
</fetch>

Outils vous permettant de créer vos requêtes

Si vous interrogez des données et disposez d’une application pilotée par modèle comprenant les tables que vous souhaitez interroger, la méthode la plus simple pour composer des requêtes FetchXML consiste à utiliser la recherche avancée, qui comporte une fonction Télécharger FetchXML. Vous êtes limité à l’IU sur les filtres et les données associées que vous pouvez extraire, mais c’est souvent un excellent premier pas pour ne pas avoir à composer le XML vous-même.

Capture d’écran de la fonction Télécharger FetchXML dans la recherche avancée.

Un autre outil notable créé par la communauté s’appelle FetchXML Builder. Avec cet outil, vous pouvez construire FetchXML d’une manière impossible avec la recherche avancée (agrégats, jointures externes, requêtes « sans » et attributs provenant d’entités liées à plusieurs niveaux). Il offre également une multitude d’autres fonctionnalités, que vous pouvez trouver à l’adresse suivante : FetchXML Builder.

Autres ressources

Pour en savoir plus sur le langage de requête FetchXML, consultez la section Interroger des données à l’aide de FetchXML, qui couvre plusieurs sujets avancés tels que la gestion de la pagination, l’interrogation de données hiérarchiques et bien plus encore.