Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Essa documentação diz respeito aos blocos de programação Remover (Fonte de dados) e Remover, apesar de terem nomes parecidos, funcionam de formas diferentes.
Âncora | removerFonteDados | removerFonteDados | ||
---|---|---|---|---|
|
Bloco Remover (Fonte de dados)
Remove o registro em cursor atual da lista retornada pelo bloco Abrir consulta.
. Essa lista por vir do retorno do bloco Abrir consulta.
Image Added
Figura 1 - Bloco Remover (Fonte de dados)
Compatibilidade
- Bloco servidor: cronapi.database.Operations.remove()
Retorno
O bloco não possui retorno.
Parâmetros
Fonte de dados
Parâmetros
Lista contendo os registros
Compatibilidade
Image Removed Servidor
Exemplo
A função em destaque abaixo remove o registro em cursor contido na lista retornada do bloco Abrir consulta. No exemplo da figura 1 estamos excluindo o registro de um usuário baseado no atributo nome. A função faz uma iteração enquanto existir registros, verifica se o atributo "nome" é igual a "Maraisa" e exclui o registro, do contrário ela continuará avançando os registros utilizando o bloco Próximo registro.
Image Removed
Figura 1 - Bloco de programação Remover
Remover
Remove um registro do banco de dados, filtrando-o por seus campos ou objeto.
Parâmetros
Nome
Tipo
Doc
Objeto contendo o registro com os dados a serem excluídos, quando configurado via objetos
ou, campos, contendo um ou mais dados a serem excluídos, quando configurados via campos
no padrão do retorno do bloco Abrir consulta.
- Posição: 1
- Inglês: Datasource
- Tipo: Lista / List
- Exemplo: retorno do bloco Abrir consulta.
Exemplo
A função a seguir apresenta um exemplo de uso do bloco Remover (Fonte de dados). Neste exemplo, o bloco Abrir consulta foi configurado a partir da classe "Aluno" do Diagrama de dados. Em seguida, enquanto houver registros na consulta, os blocos de repetição e Existe registro verificarão, utilizando o bloco se faça, se o e-mail informado no bloco de texto é o mesmo encontrado no registro obtido pelo bloco Obter campo do. Se for o mesmo, o bloco Remover (Fonte de dados) irá excluir esse registro. A cada repetição o bloco Próximo registro permite avançar para o próximo registro disponível.
Image Added
Figura 2 - Exemplo de uso do bloco Remover (Fonte de dados)
As Figuras 2.1 e 2.2 apresentam os registros no banco de dados antes e depois da remoção, respectivamente. Observe que somente o registro que contém o e-mail informado (destaque 1 da Figura 2.1) foi removido.
Image Added
Figura 2.1 - Tabela "Aluno" antes da remoção do registro
Image Added
Figura 2.2 - Tabela "Aluno" depois da remoção do registro
Âncora | ||||
---|---|---|---|---|
|
Bloco Remover
Permite remover um ou mais registros vinculados ao Banco de dados ou gerar uma requisição DELETE a partir de uma Fonte de dados Cronapp.
Image Added
Figura 3 - Bloco Remover
Compatibilidade
- Bloco servidor: cronapi.database.Operations.remove()
Retorno
O bloco não possui retorno.
Características do bloco
Nota |
---|
Os parâmetros de entrada para função apresentam-se de acordo com os campos, ou o objeto, adicionados na tela de configuração do bloco de programação, o que significa dizer que cada campo definido representa um novo parâmetro da função. |
Configuração do bloco
É possível remover registros do banco de dados de duas formas diferentes, via campos ou por objeto, essa configuração é feita a partir do campo Tipo (destaque 2 da figura 1.1).Para configurar o bloco Remover, clique no símbolo da engrenagem, isso fará com que a janela Configurar Bloco de Programação seja exibida. Após informar a entidade (destaque 1 da figura 1.1), é possível criar a regra de exclusão a partir dos atributos do objeto (Tipo Campos) ou apenas passando o Objeto, nesse caso, não será possível configurar regras.
Image Removed
ícone de engrenagem (seta da Figura 4). Após esta ação, a janela do Assistente será exibida permitindo a configuração dos campos 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 do Assistente de consulta do bloco (Figura 4), consulte a documentação Assistente de consulta.
Image Added
Figura 4 - Configuração do bloco Remover
Destaques da Figura 4:
Figura 1.1 - Configuração do bloco Remover- Entidade: abre a janela de seleção de entidades.
- Tipos: define como será configurado a seleção de removido os registros:
- Campos: permite criar regras para remover um ou vários registros ao mesmo tempo;.
- Objeto: esta opção não permite definir regras, o bloco Remover exclui remove o registro com base no objeto informado. Veja o Exemplo 1 para mais detalhes de configuração.
- Regras: Possui Área regras: define o filtro dos registros que serão excluídos. Possui a mesma estrutura vista em Regrasno tópico "Regras" da documentação do Assistente de consulta.
- Botão Excluir: apaga as regras inseridas.
Acesse a figura 1.1 da Para informações das demais opções exibidas no Assistente do bloco Remover, consulte a documentação Assistente de consulta para obter informações sobre o campo Modo de consulta e os botões Testar Consulta, Editar Texto e Visualizar como Texto.
Compatibilidade
.
Parâmetros
Parâmetro "N"
Os parâmetros da função são exibidos de acordo com o objeto ou os campos adicionados na tela de configuração do bloco de programação no Assistente de consulta. Isso implica que a cada novo campo definido, cujo valor não seja estático, um parâmetro é apresentado no bloco da função.
- Posição: 1 ou mais
- Tipo: Depende do tipo do dado do atributo.
Âncora | ||||
---|---|---|---|---|
|
Exemplo 1 - Remoção
via camposNa figura 1.2 mostramos como remover um registro a partir do campo email da entidade selecionada (configuração tipo Campos, destaque 2 da figura 1.1). Todos os registros que tiverem o email "wesley@email.com" cadastrados, serão excluídos.
Image Removed
Figura 1.2 - Bloco de programação Remover configurado via campo
Exemplo 2 - Remoção via objeto
No exemplo da figura 1.3 estamos pegando o retorno da consulta do bloco Abrir consulta e excluindo um registro, via Objeto (destaque 2 da figura 1.1), pegando a primeira ocorrência dele utilizando o bloco na lista.
Image Removed
Figura 1.3 - Bloco de programação Remover configurado via objetopor objeto
A função a seguir apresenta um exemplo de uso do bloco Remover configurado com o Tipo "Objeto" (destaque 2 da Figura 4) a partir da classe "Aluno" do Diagrama de dados. Neste exemplo, o bloco Remover recebe o bloco na lista com o retorno do bloco Abrir consulta. Dessa forma, vamos excluir o primeiro registro da consulta que possui o e-mail informado.
Image Added
Figura 5 - Exemplo de uso do bloco Remover passando um objeto como parâmetro
Exemplo 2 - Remoção por campos
A imagem abaixo apresenta um exemplo de uso do bloco Atualizar configurado com o Tipo "Campos" (destaque 2 da Figura 4). O bloco foi configurado conforme a Figura 4. Por meio dele, removeremos os registros que possui o mesmo e-mail informado no parâmetro.
Image Added
Figura 6 - Exemplo de uso do bloco Remover utilizando o tipo "Campos"
Ao clicar no botão "Editar como Texto" (Figura 4), poderemos observar que a consulta definida ficará da seguinte forma:
Bloco de código | ||
---|---|---|
| ||
DELETE FROM Aluno WHERE email = :email |
Exemplo 3 - Utilizando uma Fonte de dados
A função abaixo apresenta um exemplo de uso do bloco Remover configurado com o Tipo "Campos" (destaque 2 da Figura 4) a partir da Fonte de dados "query156543". É importante destacar que, diferente dos exemplos anteriores, no qual ao selecionar uma classe é possível utilizar tanto o Tipo "Campos" como "Objeto", ao utilizar uma Fonte de dados apenas o Tipo "Campos" é permitido.
O bloco da função abaixo foi configurado conforme a Figura 4. Após a execução da função o registro será removido do banco de dados.
Image Added
Figura 7 - Exemplo de uso do bloco Remover configurado com uma Fonte de dados
Ao clicar no botão "Editar como Texto" (Figura 4), 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 | ||
---|---|---|
| ||
DELETE app/query156543(email=:email) |
Blocos de programação nesta página
Índice