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. Les appelants React composent FetchXML sous forme de littéraux de chaînes (chaînes de chaînes) et les transmettent directement à ppp.retrieveRecordsAsync(fetchXml). Le serveur fait toujours le travail lourd (fusion de filtres, pagination, réduction de la 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.