Générer des requêtes avec QueryExpression

Dans Microsoft Dataverse, vous pouvez utiliser la classe QueryExpression pour générer par programme une requête contenant des filtres de données et des conditions de recherche qui définissent la portée d’une recherche dans une base de données. Une expression de requête est utilisée pour les recherches à un seul objet (table). Par exemple, vous pouvez créer une recherche pour retourner tous les comptes qui répondent à certains critères de recherche. La classe QueryBase est la classe de base pour les expressions de requête. Il y a trois classes dérivées : QueryExpression, QueryByAttribute et FetchExpression. La classe QueryExpression prend en charge les requêtes complexes. La classe QueryByAttribute est un moyen simple de rechercher des lignes de table dans lesquelles les colonnes correspondent à des valeurs spécifiées.

Les expressions de requête sont utilisées dans les méthodes qui récupèrent plusieurs lignes, par exemple la méthode IOrganizationService.RetrieveMultiple , dans les messages qui effectuent une opération sur un ensemble de résultats spécifié par une expression de requête, par exemple BulkDeleteRequest, et lorsque l’ID d’un enregistrement spécifique n’est pas connu.

Pour enregistrer une requête afin de pouvoir la réutiliser, vous pouvez la convertir en FetchXML à l’aide du QueryExpressionToFetchXmlRequest et l’enregistrer en tant que requête enregistrée. Pour plus d’informations : Requêtes enregistrées

Alternatives à QueryExpression

Il existe deux autres méthodes permettant de créer des requêtes pour récupérer des enregistrements depuis Dataverse.

• FetchXML, le langage de requête propriétaire Dataverse , peut être utilisé pour effectuer certaines requêtes à l’aide de requêtes XML. Plus d’informations : Interroger des données à l’aide de FetchXml.
• Language-Integrated Query (LINQ) .NET. Pour plus d’informations : Générer des requêtes avec LINQ (.NET Language-Integrated Query).

Configuration pour recherche rapide

Dans les applications basées sur un modèle, il existe une fonctionnalité de recherche rapide. Si un utilisateur fournit des critères de recherche dans la recherche rapide qui ne sont pas assez sélectifs, le système détecte cela et arrête la recherche. Un formulaire plus rapide de recherche rapide est pris en charge et peut entraîner une différence de performances importante. Cela est contrôlé par la colonne QuickFindRecordLimitEnabled de la table d’organisation. Lorsque cette valeur de colonne Boolean est true, une limite est imposée aux requêtes de recherche rapide.

Contenu de la section

Utilisation de la classe QueryByAttribute
Utilisation de la classe QueryExpression
Utilisation de la classe ColumnSet
Utilisation de la classe ConditionExpression
Utilisation de la classe FilterExpression
Utilisez une jointure externe gauche dans QueryExpression afin de rechercher des enregistrements « pas dans »
Page de grands ensembles de résultats avec expression de requête et FetchXML
Exemple : extraire avec une relation un-à-plusieurs
Exemple : récupération multiple avec QueryByAttribute
Exemple : récupération multiple avec QueryExpression
Exemple : Utiliser QueryExpression avec un cookie de pagination

Référence

QueryBase
QueryExpression
QueryByAttribute
RetrieveMultiple
ColumnSet
ConditionExpression
FilterExpression
PagingCookie

Voir aussi

Exemple : Convertir des requêtes entre des expressions Fetch et Query