FetchXMLBuilder

La FetchXMLBuilder classe fournit une API fluide pour construire et manipuler des requêtes FetchXML de manière programmatique. Au lieu de construire des chaînes XML brutes, vous pouvez utiliser des méthodes fortement typées pour définir des entités, colonnes, filtres, conditions, ordres de tri et entités de lien.

Note de réaction

FetchXMLBuilder est un utilitaire Blazor côté serveur — il n’existe pas d’équivalent React de cette classe. Ce que React propose à la place, c’est le constructeur de requêtes FetchXML, un composant qui modifie visuellement une requête et vous transmet le FetchXML ; un appelant qui connaît déjà la requête la compose en tant que littéral de chaîne et la transmet à ppp.retrieveRecordsAsync(fetchXml). Le serveur continue de faire le travail lourd — fusion de filtres, pagination, réduction de sécurité — une fois que le FetchXML arrive.

Création d’une requête

Créez-en une nouvelle FetchXMLBuilder avec une requête vide, ou analysez une chaîne FetchXML existante.

Sélection des colonnes

Ajoutez des colonnes individuelles avec AddColumn, ou définissez AllColumns = true pour récupérer toutes les colonnes. Le paramètre AllColumns supprime toutes les colonnes ajoutées individuellement.

Ajout de filtres

Ajoutez des filtres à une entité ou entité de lien avec AddFilter, puis ajoutez des conditions au filtre. Chaque condition spécifie une colonne, un opérateur et une valeur.

Assembler les tables connexes

Utilisez AddLinkEntity pour rejoindre une table connexe. Définissez les TableNamepropriétés , From, To, et Operator pour définir la jointure. Des filtres peuvent être ajoutés aux entités de liaison tout comme à l’entité principale.

Résultats du tri

Utilisez AddSortOrder pour définir l’ordre de tri. Vous pouvez spécifier le nom de la colonne et indiquer s’il faut trier par ordre décroissant.

Pagination

Contrôlez la pagination avec le Count, , et PagingCookie les propriétés sur l’élément Fetch Page. Réglez ReturnRecordCount = true pour inclure le nombre total de records dans les résultats.

Analyse du FetchXML existant

Passez une chaîne FetchXML existante au constructeur pour qu’elle l’analyse et la manipule. C’est utile pour modifier des requêtes issues de vues ou d’autres sources.

Génération de la chaîne FetchXML

Appel ToString() pour générer la chaîne FetchXML. La sortie est déterministe : attributs, puis ordres de tri, puis filtres, puis entités lien. Dans chaque groupe, les éléments sont triés par ordre alphabétique.