O construtor de consultas

O construtor de Consultas permite filtrar dados de entidades do Data Service, respeitando uma sintaxe predefinida.

Importante:

As funções Fetch, FetchOne, GetChoiceSet e GetChoiceSetValue são assíncronas e não suportam encadeamento.

To display entity records in a control, use an app variable and the Set Value rule. You can also bind the control data source to your entity using the Query builder.

Refer to Using the Fetch functions for practical examples.

Uso do Construtor de consultas

O construtor de Consultas usa a função Fetch() para avaliar e classificar suas entidades do Data Service.

Como pré-requisito, você deve fazer referência a entidades existentes do Data Service em seu aplicativo. Para usar o construtor de Consultas, prossiga com as seguintes etapas:

1. Para o controle desejado, selecione uma propriedade VB habilitada. Você pode identificar esses tipos de propriedades pelo campo Origem de dados VB na guia Geral.
   
2. Selecione construtor de Consultas. Isso abre a janela do construtor de Consultas.
3. Selecione a entidade para a qual você deseja criar a consulta.
4. Na guia Condições, clique:

   Opção	Description
   Adicionar condição	para adicionar uma única condição
   Adicionar grupo	para agrupar várias condições

   Quando você adiciona duas ou mais condições, a consulta avalia e retorna dados com base em operadores AND ou OR:

   • AND — retorna dados quando todas as condições são atendidas

   • OR — retorna dados quando qualquer condição é atendida

5. Selecione o campo de entidade do qual você deseja consultar dados.
6. Selecione o operador de avaliação.
7. Insira o valor para sua condição. O valor deve ser do mesmo tipo do tipo de campo. Por exemplo, use strings para campos de Texto, use números inteiros para campos de Número.
8. Na guia Configurações adicionais, é possível configurar regras de classificação para os dados consultados:

   Opção	Description
   Classificar Por Campo	Classifica os dados consultados pelo campo selecionado
   Classificar em Ordem Crescente	Se verdadeiro, classifica os dados consultados em uma ordem crescente.

9. Clique em Salvar para salvar sua consulta.

A função Buscar

O construtor de consultas usa a função Fetch() para recuperar e manipular dados de entidade. A função Fetch() é assíncrona e não é compatível com encadeamento.

A função Fetch() tem os seguintes parâmetros:

Parâmetro	Description
FilterGroup	Um grupo de filtros no Data Service
PaginationProps	Especifica o tamanho da página e o número de registros a ignorar.
SortOption[] sortOptions	Especifica a coluna a ser classificada e a ordem de classificação.
string[] selectedFields	Especifica os campos de entidade que devem ser retornados.
ExpansionFieldOption[] expansionFieldOptions	Especifica qual coluna de uma entidade de relacionamento deve ser expandida e retornada. O Apps permite expansões de nível um, o que significa que, se você tiver um campo de relacionamento, as expressões esperam que um nível de propriedades seja acessível. O construtor de consultas adiciona automaticamente essas propriedades, as quais são obrigatórias para as entidades fora do sistema.

The FetchOne() function

Enquanto Fetch() retorna um ListSource<T>, que é do mesmo tipo dos controles de lista, FetchOne() retorna um único registro do tipo T.

Como a funçãoFetch() , a função FetchOne() é assíncrona e não suporta encadeamento.

Para os seguintes cenários, você precisa modificar manualmente a função Fetch() para obter resultados mais personalizados:

Busca simples

Obtém o número de registros para uma entidade, por exemplo, SystemUsers.

Fetch(of SystemUsers)()

Buscar com a condição do filtro

Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10))

Buscar com a condição do filtro e a ordem de classificação (ascendente)

Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10), new SortOption(){addSortOption("Date")})

Buscar com a condição do filtro e a ordem de classificação (descendente)

Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10), new SortOption(){addSortOption("Date", true)})

Buscar com o PaginationProps estático

Fetch(of SystemUsers)(Nothing, new PaginationProps(0, 100))

Buscar com o título de controle PaginationProps

Por exemplo, para o controle Editar grade:

Fetch(of SystemUsers)(Nothing, new PaginationProps(MainPage.EditableGrid.PageStart, MainPage.EditableGrid.PageLimit))

Buscar com a projeção

Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10), Nothing, new string(){"Name"})