Remover registro
um emParâmetros de Entrada
| Nome | Tipo | Doc |
|---|---|---|
| Parâmetro 1 | Fonte de dados | Fonte de dados a ser percorrida |
Compatibilidade
Servidor
Cliente
Exemplo 1
A função abaixo remove um registro de uma fonte de dados User.
Utilização da função
Para utilizar a função Remove registro é necessário que o bloco de programação saiba onde está a fonte de dados que será manipulado, dessa forma, acesse as propriedades do bloco de programação (ícone engrenagem do lado direito superior na tela) e no campo Formulário de Referência selecione a view onde está a fonte de dados.
Sobre o bloco
Para que se possa utilizar funções que dependam de fonte de dados, é necessário criá-las antecipadamente. Essa criação se dá através do controle Fonte de dados.
Controle Fonte de dados
Dentre suas propriedades está Nome, responsável por identificar unicamente a fonte de dados criada, deixando-a disponível para uso no seletor dos blocos que utilizam fontes da dados.
Fontes de dados criadas e com suas propriedades
Figura 1 - Bloco Remove registro
| Informações |
|---|
Este bloco pode ser utilizado com fonte de dados offline em aplicações mobile. Para mais informações sobre esse recurso, verifique o tópico "Suporte a dados offline (mobile)" da documentação Componente visual fonte de dados. |
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
Nesta página
| Índice |
|---|