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. Opcionalmente, configure regras para os dados consultados na guia Configurações adicionais .
9. Selecione Salvar para salvar sua consulta.

Configurações adicionais

Na guia Configurações adicionais , você pode configurar regras para os dados consultados.

A tabela a seguir descreve os elementos da guia Configurações adicionais .

Element	Description
Índice de início de página (ignorar)	Permite que você defina quantos registros serão ignorados antes de começar a retornar resultados. Por exemplo, se você inserir 10, a consulta começará a partir do 11º registro. Observação: definir um índice de início de página pode ser útil para paginação ao usar conjuntos de dados grandes.
Limite de páginas (acima)	Permite que você defina o número máximo de registros a serem retornados. Por exemplo, se você inserir 50, a consulta retornará as primeiras 50 linhas. Observação: definir um limite de páginas ajuda a controlar o tamanho da consulta.
Adicionar campo de classificação	Adiciona um campo de classificação que permite que você configure uma regra de classificação para os dados consultados. O campo Classificar por e a classificação de elementos crescentes são exibidos.
Classificar Por Campo	Permite que você insira o campo que será usado para classificar os dados.
Classificar em Ordem Crescente	Se verdadeiro, classifica os dados consultados em uma ordem crescente.
Projeção	Permite que você defina um campo específico da entidade que deve ser incluído apenas no conjunto de resultados. Observação: A planilha pode ser usada para simplificar os dados de saída. A planilha fica disponível apenas quando o Construtor de consultas é aberto a partir da regra Definir valor.

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