Compter des lignes à l’aide de FetchXml

Utilisez l’attribut returntotalrecordcount de l’élément fetch pour spécifier que le résultat inclut un décompte de tous les enregistrements qui répondent aux critères de filtre, pouvant aller jusqu’à 5 000. Utilisez cet attribut lors de la récupération des résultats paginés pour estimer le nombre total de pages à afficher.

Vous ne pouvez pas appliquer l’attribut top de l’élément fetch avec returntotalrecordcount.

Le comportement que vous pouvez attendre dépend si vous utilisez le SDK pour .NET ou l’API Web.

SDK pour .NET

Lorsque la valeur de l’attribut returntotalrecordcount est true, la EntityCollection renvoyée par la méthode RetrieveMultiple inclut des valeurs pour les propriétés suivantes :

Propriété	Description
TotalRecordCount	Le nombre total d’enregistrements pouvant aller jusqu’à 5 000 ; sinon, la valeur est -1.
TotalRecordCountLimitExceeded	true si les résultats de la requête dépassent le nombre total d’enregistrements ; sinon, false.

API web

La définition de la valeur de l’attribut returntotalrecordcount sur true a le même résultat que la définition de l’option de requête $count d’OData. Vous pouvez ajouter &$count=true à votre requête FetchXml pour obtenir les mêmes résultats. En savoir plus sur l’option de requête $count d’OData.

Lorsque vous définissez l’attribut returntotalrecordcount (ou utilisez l’option de requête $count), les données renvoyées incluent l’annotation @odata.count avec le nombre total d’enregistrements correspondant aux critères de filtre, pouvant aller jusqu’à 5 000.

Si vous incluez l’un de ces en-têtes de demande :

Prefer: odata.include-annotations="Microsoft.Dynamics.CRM.totalrecordcount,Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded"
   OR for all annotations:
Prefer: odata.include-annotations="*"

Les annotations suivantes seront renvoyées :

Propriété	Description
@Microsoft.Dynamics.CRM.totalrecordcount	Le nombre total d’enregistrements pouvant aller jusqu’à 5 000 ; sinon, la valeur est -1. La valeur est la même que celle de l’annotation @odata.count.
@Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded	true si les résultats de la requête dépassent le nombre total d’enregistrements ; sinon, false.

La valeur (TotalRecordCountLimitExceeded ou @Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded) est utile lorsque vous devez calculer le nombre de requêtes paginées supplémentaires que vous devez envoyer pour obtenir tous les résultats lorsque (TotalRecordCount ou @Microsoft.Dynamics.CRM.totalrecordcount) est égal à 5 000.

Si la taille de votre page est inférieure à la valeur maximale et que (TotalRecordCount ou @Microsoft.Dynamics.CRM.totalrecordcount) est inférieur ou égal à 5 000, vous pouvez calculer le nombre de requêtes paginées supplémentaires que vous devez envoyer pour obtenir tous les enregistrements.

Lorsque (TotalRecordCountLimitExceeded ou @Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded) a la valeur true et (TotalRecordCount ou @Microsoft.Dynamics.CRM.totalrecordcount) est égal à 5 000, vous ne pouvez pas effectuer ce calcul.

Conseil

Si vous souhaitez obtenir un nombre total d’enregistrements sans filtre, utilisez le message RetrieveTotalRecordCount avec soit la fonction RetrieveTotalRecordCount de l’API web, soit avec la classe RetrieveTotalRecordCountRequest du SDK pour .NET. Les données récupérées proviendront d’un instantané au cours des dernières 24 heures.

Étapes suivantes

Découvrez comment optimiser les performances.

Optimiser les performances

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