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.
Remover (Fonte de dados)
Remove o registro em cursor da lista retornada pelo bloco Abrir consulta.
Nesse contexto, um cursor é um indicador utilizado para sinalizar a posição atual do registro dentro de uma lista do retorno do bloco Abrir consulta. |
Parâmetros
| Nome | Tipo | Doc |
|---|---|---|
| Parâmetro 1 | Lista | Lista contendo os registros |
Compatibilidade
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.
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 |
|---|---|---|
| Parâmetro 1 | Objeto/campos | 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 |
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.
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 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 o registro com base no objeto informado.
- Área regras: define o filtro dos registros que serão excluídos. Possui a mesma estrutura vista em Regras.
- Botão Excluir: apaga as regras inseridas.
Acesse a figura 1.1 da 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
Servidor
Exemplo 1 - Remoção via campos
Na 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.
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.
Figura 1.3 - Bloco de programação Remover configurado via objeto
Blocos de programação nesta página