Obtém o conteúdo de um campo do componente fonte de dados ou de 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

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 bloco Exibir 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