Versões comparadas
Versão antiga 2
changes.mady.by.user Usuário desconhecido (557058:4b1b311a-8636-4ab4-87d8-6a41e4d941bf)
Gravado em
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Permite criar e obter consultas a partir de um Banco de dados ou Fonte de dados utilizando Assistente de consulta.
Image Added
Figura 1 - Bloco Abrir consulta
Compatibilidade
- Bloco servidor: cronapi.database.Operations.query()
Retorno
Retorna uma lista com os objetos que representam o resultado da consulta.
Características do bloco
Para configurar o bloco Abrir consulta
Realiza consultas em um banco da dados.
Parâmetros de Entrada
Os parâmetros de entrada para função apresentam-se, clique no ícone de engrenagem (seta da Figura 2). Após esta ação, a janela do Assistente de consulta será exibida permitindo a configuração das consultas de forma visual, não necessitando de uma interação direta com códigos na linguagem JPQL ou SQL.
As consultas no Assistente podem ser configuradas a partir de uma Entidade, Fonte de dados ou SQL Nativo. Para mais detalhes da estrutura e definição de cada campo do Assistente de consulta do bloco (Figura 2), consulte o tópico Estrutura da Consulta da documentação Assistente de consulta. Além disso, é importante destacar que os campos exibidos no Assistente podem ter algumas diferenças a depender do tipo de Entidade selecionada. Para mais detalhes, consulte o tópico Diferença entre consultas da documentação correspondente.
Image Added
Figura 2 - Configuração do bloco Abrir consulta
Parâmetros
Parâmetro "N"
Os parâmetros da função são exibidos de acordo com as regras criadas no
Assistente de consulta
. Isso implica que a cada nova regra definida
, cujo valor não seja estático, um parâmetro é apresentado no bloco da função
. O Exemplo 2 apresenta o bloco Abrir consulta configurado com um parâmetro "nota".
- Posição: 1 ou mais
- Tipo: Depende do tipo do dado do atributo.
Compatibilidade
Exemplo 1
A função
Image Removed
a seguir apresenta um exemplo de uso do bloco Abrir consulta. Neste exemplo, o bloco configurado conforme a Figura 3.1, realizará uma consulta a partir da classe "Aluno" do Diagrama de dados. Em seguida, enquanto houver registros na consulta, os blocos de repetição e Existe registro irão imprimir o nome e a nota de cada aluno encontrado por meio dos blocos Obter campo. A cada impressão dos elementos da consulta, o bloco Próximo registro permite avançar para o próximo registro disponível. A parte inferior da Figura 3 exibe o resultado de execução da função no Console do Depurador.
Image Added
Figura 3 - Exemplo de uso do bloco Abrir consulta utilizando a classe Aluno
O bloco Abrir consulta foi configurado conforme a imagem abaixo.
Image Added
Figura 3.1 - Configuração do bloco Abrir consulta utilizando a classe Aluno
Ao clicar no botão "Editar como Texto" (destaque 1 da Figura 3.1), poderemos observar que a consulta definida ficará da seguinte forma:
Bloco de código | ||
---|---|---|
| ||
SELECT a FROM Aluno a |
Âncora | ||||
---|---|---|---|---|
|
Exemplo 2
No exemplo da função abaixo, estamos realizando uma consulta no bloco Abrir consulta a partir de uma Fonte de dados do tipo Consulta a Entidades. Observe que o bloco possui o parâmetro "nota" que foi obtido a partir do campo "Filtro" na configuração do bloco no Assistente de consulta (Figura 4.1). O resultado de execução da função exibirá, no Console do Depurador, informações dos alunos que possuem nota maior ou igual ao número "9".
Image Added
Figura 4 - Exemplo de uso do bloco Abrir consulta utilizando uma Fonte de dados
O bloco Abrir consulta da função foi configurado conforme a imagem abaixo. Ele retornará os nomes e as notas dos alunos que possuem, como configurado no campo "Filtro", nota maior ou igual a nota que será passada como parâmetro. Como já informado, o Assistente de consulta ao selecionar uma Fonte de dados possui algumas diferenças nos campos exibidos. Para mais informações, consulte o tópico Diferença entre consultas da documentação Assistente de consulta.
Image Added
Figura 4.1 - Configuração do bloco Abrir consulta utilizando a Fonte de dados Aluno
Ao clicar no botão "Editar como Texto" (destaque 1 da Figura 4.1), poderemos observar que a consulta definida gera a requisição REST abaixo. Para mais detalhes, consulte o tópico REST da documentação Assistente de consulta.
Bloco de código | ||
---|---|---|
| ||
GET app/query156543?$select=nome%2Cnota&$filter=%28nota%20ge%20%3Anota%29 |
Nesta página
Índice |
---|
Utilização da função
A utilização da função Desabilitar componente depende da forma correta de vinculação do bloco de programação ao formulário contendo os componentes com os quais se deseja interagir.
Para mais informações sobre como fazer tal vinculação acesse o link abaixo.
Informações | ||
---|---|---|
| ||