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 del lado del servidor — no existe un equivalente de React para la clase. Lo que React tiene en su lugar es el constructor de consultas FetchXML, un componente que edita una consulta visualmente y te entrega el FetchXML; un llamador que ya conoce la consulta la compone como un literal de cadena y se la pasa a ppp.retrieveRecordsAsync(fetchXml). El servidor sigue haciendo el trabajo duro — fusión de filtros, paginación, ajuste 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.