Habilita o modo de edição em uma fonte de dados.
Figura 1 - Bloco Entrar em modo de edição
Compatibilidade
- Bloco cliente: cronapi.screen.startEditingMode()
- Bloco servidor: cronapi.screen.startEditingMode() - executado a partir da chamada do bloco cliente.
Retorno
Bloco não possui retorno.
Parâmetros
Fonte de dados
Componente visual fonte de dados da página referenciada. Para selecionar uma fonte de dados, o bloco precisa estar associado a um formulário de referência que contenha o componente fonte de dados em questão. Acesse o tópico Propriedades do blockly, da documentação Bloco de programação, para mais detalhes.
- Posição: 1
- Inglês: Datasource
- Tipo: Fonte de dados / Datasource
- Exemplo: fonte de dados Aluno
Exemplo
A função abaixo alterna para o modo de edição a fonte de dados Aluno presente no formulário vinculado ao editor de bloco.
Figura 2 - Função que habilita o modo de edição da fonte de dados
Para que possamos editar um registro, primeiramente precisamos selecioná-lo para torná-lo ativo. Neste exemplo, fizemos a seleção clicando no segundo registro. A figura 2.1 exibe uma Grade vinculada a fonte de dados que está em modo de leitura.
Figura 2.1 - CRUD antes da ativação da função
Após a função ser acionada, a fonte de dados entra em modo de edição e o Formulário alterna a visualização dos componentes para a edição do registro ativo (active
). Para este exemplo, editamos o campo nota do segundo registro.
Figura 2.2 - Editando o registro
Após a edição ser realizada, o registro pode ser salvo com o novo dado alterado.
Figura 2.3 - CRUD após a edição