FetchXMLBuilder

A FetchXMLBuilder classe fornece uma API fluente para construir e manipular consultas FetchXML programaticamente. Em vez de construir strings XML brutas, você pode usar métodos fortemente tipados para definir entidades, colunas, filtros, condições, ordens de ordenação e link-entities.

Nota de React

FetchXMLBuilder é uma utilidade Blazor do lado do servidor — não existe equivalente ao React. Os chamadores React compõem FetchXML como literais de string (strings de template) e os passam diretamente para ppp.retrieveRecordsAsync(fetchXml). O servidor ainda faz o trabalho pesado (fusão de filtros, paginação, ajuste de segurança) assim que o FetchXML chega.

Criando uma Consulta

Crie uma nova FetchXMLBuilder com uma consulta vazia, ou analise uma string FetchXML existente.

Seleção de Colunas

Adicione colunas individuais com AddColumn, ou defina AllColumns = true para recuperar todas as colunas. A configuração AllColumns remove quaisquer colunas adicionadas individualmente.

Adição de Filtros

Adicione filtros a uma entidade ou entidade-link com AddFilter, e então adicione condições ao filtro. Cada condição especifica uma coluna, um operador e um valor.

Juntando tabelas relacionadas

Use AddLinkEntity para juntar uma tabela relacionada. Defina as TableNamepropriedades , From, To, e Operator para definir a junção. Filtros podem ser adicionados às entidades de enlace assim como a entidade principal.

Resultados da Classificação

Use AddSortOrder para definir a ordem de ordenação. Você pode especificar o nome da coluna e se deseja ordenar em ordem decrescente.

Paginação

Controla paginação com , CountPage, e PagingCookie propriedades no Fetch elemento. Defina ReturnRecordCount = true para incluir a contagem total de recordes nos resultados.

Análise do FetchXML Existente

Passe uma string FetchXML existente para o construtor analisar e manipular. Isso é útil para modificar consultas de visualizações ou outras fontes.

Gerando a string FetchXML

Chamada ToString() para gerar a string FetchXML. A saída é deterministicamente ordenada: atributos, depois ordens de ordenação, depois filtros, e então entidades de link. Dentro de cada grupo, os elementos são ordenados alfabeticamente.