Remove o registro ativo de uma fonte de dados.

Figura 1 - Bloco Remove registro

Compatibilidade

• Bloco cliente: cronapi.screen.removeRecord()
• Bloco servidor: cronapi.screen.removeRecord() - executado a partir da chamada do bloco cliente.

Retorno

Bloco não possui retorno.

Parâmetros

Fonte de dados

Nome da fonte de dados que terá um registro removido. Para selecioná-lo é necessário vincular o bloco de programação a um formulário de referência que contenha a fonte de dados desejada, confira no tópico Propriedades do Blockly da documentação Bloco de Programação.

• Posição: 1
• Inglês: Datasource
• Tipo: Objeto / Object
• Exemplo: "User"

Exemplo

A função a seguir apresenta um exemplo de uso do bloco Remove registro. Após vincular um formulário de referência nas configurações do blockly, selecionamos, no parâmetro Fonte de dados do bloco, o nome da fonte de dados presente no formulário vinculado. Na variável "removeUser", será atribuído o valor booleano true ou false do bloco Confirmar ação.

Em seguida, o bloco condicional se faça verificará o valor booleano da variável "removeUser", se for verdadeiro, o bloco Remove registro removerá o usuário selecionado e uma notificação será exibida. Essa função será atribuída ao botão de cada registro de um componente Grade.

Figura 2 - Exemplo de uso do bloco Remove registro

Na imagem a seguir, temos um componente Grade com três usuários registrados e cada registro possui um botão de exclusão. Ao clicar no botão associado ao registro "João Souza" (destaque 1 da Figura 2.1), a função da Figura 2 será executada e a pop-up de confirmação será exibida.

Figura 2.1 - Pop-up de confirmação em exibição

Ao clicar no botão "OK" da pop-up, o registro do usuário "João Souza" é removido e uma notificação será exibida (Figura 2.2).

Figura 2.2 - Grade após exclusão do registro selecionado