Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: DI-2296

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.


Image Added

Figura 1 - Bloco Obter valor do campo

Obtém o valor do campo originário de uma fonte de dados ou de um campo da tela.


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 Grade.

Compatibilidade

  • Bloco servidor: cronapi.screen.Operations.getValueOfField()

Retorno

Retorna o conteúdo obtido do componente selecionado.

Características do bloco

Bloco do parâmetro Campo

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

Image Removed

Figura 1 - Bloco Obter nome do campo

Parâmetros

NomeTipoDocParâmetro 1stringnome do componente

Compatibilidade

Image Removed Servidor

Exemplo

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

 entradaTexto

entradaDeTexto" e alimenta a variável "item".

 Em

Em seguida,

no xibir

o bloco

 E

Exibir Notificação exibe uma notificação com o conteúdo da variável "item".

Image Removed


Image Added

Figura 2 -

Bloco Obter

Função que obtém o valor do campo do componente Entrada de texto


Após isso, a função

"Obter Valor"

é atribuída ao evento Ao Clicar do botão

 e

e ao clicá-lo na aplicação,

aparece

a notificação do tipo sucesso com o

valor digitado

valor digitado no componente Entrada de texto

 (Figura 3)

é exibida.

Image Removed


Image Added

Figura

3 (

2.1 - Retorno da função referente à Figura 2

Vincular formulário

Para selecionar Valor 

Exemplo 2 - Caixa de Seleção Múltipla

Neste exemplo, atribuímos o

ng-model

) de qualquer componente em um formulário, é necessário apontar a view desejada no campo Formulário de referência das configurações do Editor de Bloco de programação. Acesse a configuração do bloco (1 da figura 4), e seguida clique em "..." do campo Formulário de Referência (2) e selecione o formulário desejado (3). 

do componente visual Caixa de seleção múltiplaconfigurada 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.


Image Added

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".


Image Added

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.


Image Added

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.


Image Added

Figura 4 - Fonte de dados no bloco Obter valor do campo


A figura 4.1 exibe a quantidade de itens na grade.


Image Added

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.


Image Added

Figura 4.2 - Resultado da execução da função da figura 4

Nesta página

Índice

Image Removed

Figura 4 - Vinculando Formulário

Informações
titleMais sobre
Veja mais detalhes no tópico "Propriedades do Blockly" em Bloco de programação.