Interroger des données à l’aide de FetchXml

  • Article

FetchXml est un langage de requête XML propriétaire utilisé pour récupérer des données de Dataverse. Consultez Référence FetchXml pour connaître les éléments utilisés pour récupérer des données.

Notes

FetchXml est également utilisé pour définir des vues pour les applications pilotées par modèle et certaines fonctionnalités de création de rapports. Les éléments et les attributs pour ces cas d’utilisation ne sont pas inclus ici. En savoir plus sur la personnalisation des vues des applications pilotées par modèle avec un code.

Composer une requête

Toutes les requêtes sont basées sur une seule table. L’élément racine est fetch. Utilisez l’élément entity pour sélectionner la table à partir de laquelle la requête récupère des données. L’exemple suivant représente une requête FetchXml simple :

<fetch top='5'>
  <entity name='account'>
      <attribute name='name' />
  </entity>
</fetch>

Cette requête renvoie la colonne Nom des cinq premières lignes de la table Compte, en utilisant le LogicalName de la table pour définir l’attribut name de l’élément entity.

Limiter le nombre de lignes

Pour limiter le nombre de lignes renvoyées, utilisez l’attribut top de l’élément fetch. Sans l’attribut top, Dataverse renvoie jusqu’à 5 000 lignes.

Sinon, spécifiez un certain nombre d’enregistrements à renvoyer en utilisant la pagination. N’utilisez pas l’attribut top lorsque vous demandez des pages de données. Découvrez comment demander des résultats paginés

Vous ne pouvez pas utiliser l’attribut top lorsque vous demandez un nombre de lignes en utilisant l’attribut returntotalrecordcount. Découvrez comment compter des lignes

Renvoyer des résultats distincts

Utilisez l’attribut distinct de l’élément fetch pour exiger que la requête exclue toutes les valeurs en double dans les résultats.

Si vous utilisez l’attribut distinct, vous devez ajouter au moins un élément order pour avoir une pagination cohérente.

Lorsque vous utilisez l’attribut distinct, les résultats renvoyés n’incluent pas les valeurs de clé primaire pour chaque enregistrement, car ils représentent une agrégation de toutes les valeurs distinctes.

Récupérer des données

Pour obtenir les résultats de votre requête, vous devez envoyer votre demande à Dataverse. Découvrez comment récupérer des données de Dataverse en utilisant FetchXml

Affiner votre requête

Après avoir sélectionné la table avec laquelle démarrer votre requête, affinez la requête pour obtenir les données nécessaires. Les articles suivants expliquent comment compléter votre requête.

Article Tâche
Sélectionner des colonnes Spécifiez les colonnes de données à renvoyer.
Joindre des tables Spécifiez les tables associées à renvoyer dans les résultats.
Trier des lignes Spécifiez l’ordre de tri des lignes à renvoyer.
Filtrer des lignes Spécifiez les lignes de données à renvoyer.
Paginer les résultats Spécifiez le nombre de lignes de données à renvoyer avec chaque requête.
Agréger des données Découvrez comment regrouper et agréger les données renvoyées.
Compter le nombre de lignes Découvrez comment obtenir un décompte du nombre de lignes renvoyées.
Optimisations des performances Découvrez comment optimiser les performances

Outils de la communauté

Le XrmToolBox FetchXmlBuilder est un outil gratuit pour composer et tester des requêtes FetchXML.

Notes

Les outils créés par la communauté ne sont pas pris en charge par Microsoft. Si vous avez des questions ou des problèmes avec les outils de la communauté, contactez l’éditeur de l’outil.

Utiliser FetchXml comme paramètre de message

Vous pouvez également utiliser FetchXml comme paramètre pour les opérations Dataverse telles que les messages suivants :

Nom du message Classe de requête du SDK pour .NET Opération de l’API Web
BackgroundSendEmail BackgroundSendEmailRequest Action BackgroundSendEmail
BulkDetectDuplicates BulkDetectDuplicatesRequest Action BulkDetectDuplicates
FullTextSearchKnowledgeArticle FullTextSearchKnowledgeArticleRequest Action FullTextSearchKnowledgeArticle
QueryExpressionToFetchXml QueryExpressionToFetchXmlRequest Action QueryExpressionToFetchXml
SendBulkMail SendBulkMailRequest Action SendBulkMail
Rollup RollupRequest Fonction de cumul

Étapes suivantes

Découvrez comment sélectionner les colonnes.

Sélectionner des colonnes

Découvrez comment récupérer des données avec FetchXml.

Récupérer des données avec FetchXml

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é).