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.

Para exibir registros de entidade em um controle, use uma variável de aplicativo e a regra Definir valor . Você também pode vincular a origem de dados do controle à sua entidade usando o construtor de Consultas.

Consulte Como usar as funções Fetch para ver exemplos práticos.

Dica: para atualizar uma variável de entidade no carregamento de página ou no clique de botão, adicione uma regra Definir valor . Abra o Construtor de consulta na regra definir valor e adicione uma condição de filtro para UpdateTime <= agora( ).

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. Optionally, configure rules for the queried data on the Additional settings tab.
9. Select Save to save your query.

Configurações adicionais

On the Additional settings tab, you can configure rules for the queried data.

The following table describes the elements of the Additional settings tab.

Element	Description
Page start index (skip)	Enables you to define how many records to skip before starting to return results. For example, if you enter 10, the query starts from the 11th record. Note: Setting a Page start index can be useful for pagination when using large datasets.
Page limit (top)	Enables you to set the maximum number of records to return. For example, if you enter 50, the query returns the first 50 rows. Note: Setting a Page limit helps control query size.
Add sort field	Adds a sort field that allows you to configure a sorting rule for the queried data. The Sort by field and the Sort ascending elements display.
Classificar Por Campo	Enables you to enter the field you to use for sorting the data.
Classificar em Ordem Crescente	Se verdadeiro, classifica os dados consultados em uma ordem crescente.
Projection	Enables you to define a specific field from the entity that only should be included in the result set. Observação: Projection can can be used to simplify output data.

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"})