Obter valor do campo
valor do campo originário de uma um campo da tela.| Nota | ||
|---|---|---|
| ||
Para obtenção do campo da tela é necessário que a propriedade Campo do controle esteja preenchida. |
Parâmetros de Entrada
| Nome | Tipo | Doc |
|---|---|---|
| Parâmetro 1 | string | nome do componente |
Compatibilidade
Servidor
Cliente
Exemplo 1
A função abaixo obtém o valor do campo params.txtnome e atribui a variável valorCampo.
Utilização da função
A utilização da função obter nome do campo depende da forma correta de vinculação do bloco de programação ao formulário contendo os componentes com os quais se deseja interagir.
Para mais informações sobre como fazer tal vinculação acesse o link abaixo.
| Informações | ||
|---|---|---|
| ||
Sobre o bloco
O bloco obter valor do campo permite especificar a fonte a qual se deseja obter o nome do campo.
A tela Campo a ser alterado permite a escolha do campo e da fonte que se deseja obter o nome.
outro componente que possua a propriedade Valor (ng-model). Este bloco é utilizado em conjunto com o bloco Obter nome do campo.
Figura 1 - Bloco Obter valor do campo
| Informações |
|---|
Este bloco também pode ser utilizado para obter os valores dos componentes Lista avançada e Grade. Seu retorno depende de como a propriedade Obter valor do campo como está configurada nesses componentes, podendo ser como Chave ou Objeto. Para mais detalhes, acesse o tópico Aba Geral das documentações Lista avançada e Grade. |
Compatibilidade
- Bloco servidor: cronapi.screen.Operations.getValueOfField()
Retorno
Retorna o conteúdo obtido do componente selecionado.
Características do bloco
O bloco Obter nome do campo já vem conectado ao Parâmetro Campo e tem o objetivo de facilitar a seleção de um dos componente do formulário vinculado ao arquivo blockly.
Parâmetros
Campo
Valor (ng-model) do componente que terá o seu conteúdo obtido. Para selecioná-lo é necessário vincular o bloco de programação a um formulário de referência, confira no tópico Propriedades do Blockly da documentação Bloco de Programação para mais informações sobre como vincular o bloco a um formulário de referência.
- Posição: 1
- Inglês: Field
- Tipo: Objeto / Object
- Exemplo: "
vars.input197"
Exemplo 1 - Obtendo valor
Após vincular um formulário de referência nas configurações do blockly, o bloco Obter valor do Campo recebe o conteúdo do componente Entrada de texto "vars.entradaDeTexto" e alimenta a variável "item". Em seguida, o blocoExibir Notificação exibe uma notificação com o conteúdo da variável "item".
Figura 2 - Função que obtém o valor do campo do componente Entrada de texto
Após isso, a função é atribuída ao evento Ao Clicar do botão e ao clicá-lo na aplicação, a notificação do tipo sucesso com o valor digitado no componente Entrada de texto é exibida.
Figura 2.1 - Retorno da função referente à Figura 2
Exemplo 2 - Caixa de Seleção Múltipla
Neste exemplo, atribuímos o ng-model do componente visual Caixa de seleção múltipla, configurada para retornar Objeto, ao bloco Obter valor do campo. Este, por sua vez, alimenta a variável "item". Utilizamos um laço de repetição pra percorrer a lista e acessar todos os elementos selecionados na caixa de seleção múltipla e com a ajuda do bloco imprime e Obter campo do Json, exibimos o nome dos usuários no console do depurador.
Figura 3 - Componente Caixa de seleção múltipla em conjunto com o bloco Obter valor do campo
Ao executar o projeto, selecionamos os nomes dos alunos na caixa de seleção múltipla e, em seguida, acionamos a função através do evento Ao Clicar do botão "Obter valor do campo".
Figura 3.1 - Selecionando o nome dos alunos e chamando a função
O resultado da execução da função da figura 3 pode ser conferido abaixo.
Figura 3.2 - Resultado da execução da função da figura 3
Exemplo 3 - Obtendo o registro ativo
Ao clicar no ícone indicado pela seta na figura 4, é possível selecionar o objeto ativo da fonte de dados manualmente. Neste exemplo, selecionamos o objeto "Aluno" no parâmetro Campo, dessa forma, ao executar a função, o objeto ativo da fonte de dados será exibido no console do depurador.
Figura 4 - Fonte de dados no bloco Obter valor do campo
A figura 4.1 exibe a quantidade de itens na grade.
Figura 4.1 - Grade contendo os alunos
O resultado da execução da função da figura 4 pode ser conferido abaixo. Observe que somente o registro ativo na grade foi exibido no console do depurador.
Figura 4.2 - Resultado da execução da função da figura 4
Nesta página
Índice