FetchXMLBuilder

La FetchXMLBuilder clase proporciona una API fluida para construir y manipular consultas FetchXML de forma programática. En lugar de construir cadenas XML en bruto, puedes usar métodos fuertemente tipados para definir entidades, columnas, filtros, condiciones, órdenes de ordenamiento y entidades de enlace.

Nota de React

FetchXMLBuilder es una utilidad Blazor para el lado del servidor — no existe un equivalente a React. Los llamadores de React componen FetchXML como literales de cadena (cadenas de plantilla) y los pasan directamente a ppp.retrieveRecordsAsync(fetchXml). El servidor sigue haciendo el trabajo pesado (fusión de filtros, paginación, recorte de seguridad) una vez que llega el FetchXML.

Creación de una consulta

Crea una nueva FetchXMLBuilder con una consulta vacía, o analiza una cadena FetchXML existente.

Selección de columnas

Añade columnas individuales con AddColumn, o configura AllColumns = true para recuperar todas las columnas. Configurar AllColumns elimina cualquier columna añadida individualmente.

Añadir filtros

Añadir filtros a una entidad o entidad-enlace con AddFilter, y luego añadir condiciones al filtro. Cada condición especifica una columna, un operador y un valor.

Unir tablas relacionadas

Úsalo AddLinkEntity para unirte a una tabla relacionada. Establezca las TableNamepropiedades , From, To, y Operator para definir la unión. Se pueden añadir filtros a las entidades de enlace igual que la entidad principal.

Resultados de clasificación

Úsalo AddSortOrder para definir el orden de ordenación. Puedes especificar el nombre de la columna y si ordenar en orden descendente.

Paginación

Controla la paginación con el Count, , y PagingCookie propiedades en el Fetch elementoPage. Configura ReturnRecordCount = true para incluir el recuento total de récords en los resultados.

Análisis de FetchXML existente

Pasa una cadena FetchXML existente al constructor para que la analize y manipule. Esto es útil para modificar consultas desde vistas u otras fuentes.

Generación de la cadena FetchXML

Llamada ToString() para generar la cadena FetchXML. La salida está ordenada determinísticamente: atributos, luego ordenes de ordenación, luego filtros y finalmente entidades de enlace. Dentro de cada grupo, los elementos se ordenan alfabéticamente.