Versões comparadas

Chave

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

Obter valor do campo

Obtém o

valor do campo originário de uma

conteúdo de um campo do componente fonte de dados ou de

um campo da tela.

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. 

Image Removed

Figura 1 - Bloco Obter nome do campo

Parâmetros

Nome

Tipo

Doc

Parâmetro 1stringnome do componente

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


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

Compatibilidade

  • Bloco cliente: cronapi.screen.getValueOfField()

Retorno

Retorna o conteúdo obtido do componente selecionado.

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.

  • Posição: 1
  • Inglês: Field
  • Tipo: Objeto / Object
  • Exemplo: "vars.input197"

Exemplo

A função a seguir apresenta um exemplo de uso do bloco Obter valor do campo.

Compatibilidade

Image Removed Cliente

Exemplo

Após vincular um formulário de referência nas configurações do blockly, inserimos na variável "valorCampo" o bloco

 

Obter valor do

Campo recebe o conteúdo do componente  Entrada de texto "vars.entradaTexto" e alimenta a variável "valCampo"

campo e, nele, selecionamos, no parâmetro Campo, o valor (ng-model) de um componente entrada de texto presente no formulário. Em seguida,

no exibe

exibirá uma notificação

com

contendo o conteúdo da variável "

valCampo

valorCampo".

Image Removed


Image Added

Figura 2 -

Bloco

Exemplo de uso do bloco Obter valor do campo

Após isso, a função "Obter Valor" é atribuída ao evento Ao Clicar do botão e ao clicá-lo na aplicação, aparece a notificação do tipo sucesso com o valor digitado no componente Entrada de texto (Figura 3).

Image Removed

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

Vincular formulário

Para selecionar Valor (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). 

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.

Lista avançada e Grade

O bloco de programação Obter valor do campo pode ser utilizado tanto na Lista avançada quanto na Grade. Seu retorno depende de como a propriedade Obter valor do campo como está configurada na Grade e na Lista avançada, podendo ser Chave ou Objeto. Acesse o tópico Aba Geral das documentações oficiais citadas acima para mais detalhes.


A função da Figura 2 foi adicionada ao evento "Ao Clicar" do botão "Obter valor do campo". Ao clicar neste botão, o conteúdo do componente entrada de texto será obtido e exibido em uma notificação (Figura 2.1).


Image Added

Figura 2.1 - Resultado de execução da função da Figura 2

Nesta página

Índice