apps
2023.10
true
Importante :
A tradução automática foi aplicada parcialmente neste conteúdo.
Guia do usuário do Apps
Automation CloudAutomation Cloud Public SectorAutomation Suite
Last updated 19 de abr de 2024

O construtor de consultas

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

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.
    docs image
  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çãoDescription

    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çãoDescription

    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() tem os seguintes parâmetros:

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.
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)()Fetch(of SystemUsers)()

Buscar com a condição do filtro

Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10))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")})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)})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))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))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"})Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10), Nothing, new string(){"Name"})

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo White
Confiança e segurança
© 2005-2024 UiPath. Todos os direitos reservados.