Partager via


Récupérer des données à l’aide de FetchXml

Vous pouvez utiliser FetchXml pour récupérer des données à l’aide du SDK pour .NET ou de l’API Web. Avec Power Automate, vous pouvez récupérer des données à l’aide de l’API Web en utilisant le paramètre Récupérer la requête Xml de la commande Répertorier les lignes.

Vous pouvez également utiliser les Outils de la communauté, comme le générateur FetchXML dans XrmToolBox.

La manière de récupérer des données dépend si vous utilisez le SDK pour .NET ou l’API Web Dataverse.

Utilisez la classe FetchExpression pour maintenir la requête FetchXml sous forme de chaîne. FetchExpression est dérivé du type commun de la classe QueryBase, vous pouvez donc l’utiliser lorsque ce type est un paramètre de méthode ou une propriété de classe.

Vous devriez utiliser la méthode IOrganizationService.RetrieveMultiple pour la plupart des cas.

static EntityCollection RetrieveMultipleExample(IOrganizationService service, string fetchXml)
{
   return service.RetrieveMultiple(new FetchExpression(fetchXml));
}

Vous pouvez également utiliser la classe RetrieveMultipleRequest avec la méthode IOrganizationService.Execute, mais il existe quelques scénarios où cela est nécessaire.

static EntityCollection RetrieveMultipleRequestExample(IOrganizationService service, string fetchXml)
{
   var request = new RetrieveMultipleRequest()
   {
         Query = new FetchExpression(fetchXml)
   };

   var response = (RetrieveMultipleResponse)service.Execute(request);

   return response.EntityCollection;
}

Démarrage rapide : exécuter une requête SDK pour .NET (C#)
En savoir plus sur l’utilisation de messages avec le SDK pour .NET

Les valeurs de colonne nulles ne sont pas renvoyées

Lorsqu’une colonne de table contient une valeur NULL, ou si la colonne n’a pas été demandée, l’enregistrement renvoyé n’inclut pas la valeur. Il n’existe ni clé pour y accéder ni une valeur à renvoyer. L’absence de l’attribut indique qu’elle est nulle. C’est le comportement à l’aide du Kit de développement logiciel (SDK) pour .NET. En savoir plus sur ce comportement

Les colonnes qui ne sont pas valides en lecture renvoient toujours des valeurs nulles. La définition de ces colonnes a la propriété AttributeMetadata.IsValidForRead définie sur false.

Étapes suivantes

Découvrez comment sélectionner les colonnes.

Essayer un exemple de code