Desenvolvedor:APIs/JavaScript/latromi.formInstance

Conjunto de funções e propriedades para interação com o Formulário Dinâmico. A instância desse objeto deve ser obtido através da API formManager. Essa API fornece os seguintes objetos no lado do cliente:

Propriedades

Nome	Retorno	Descrição
id	Number	Obtém o ID do Formulário Dinâmico.
upgradeCode	String	Obtém o Código de Atualização (Chave Única) do Formulário Dinâmico.

Métodos

Nome	Retorno	Descrição
getElement()	Element	Obtém o Elemento HTML que envolve o Formulário Dinâmico.
getFieldValue(string)	Any	Obtém o valor atual de um campo.
setFieldValue(string, any)	Any	Atribui valor a um campo.

id

Propriedade que retorna o ID do cadastro do Formulário Dinâmico. Este ID é numérico, e não deve ser confundido com o ID do Elemento HTML.

upgradeCode

Propriedade que retorna o Código de Atualização do Formulário Dinâmico.

Exemplo:

function logProperties() {
   // Obtém a instância do formulário
   var form = latromi.formManager.getFormInstance();
   
   // Mostra no log o valor das propriedades
   console.log('Formulário com ID ' + form.id + 
               ' e Código de Atualização ' + form.upgradeCode);
}

setFieldValue()

Função que atribui valor a um campo. O valor especificado deve variar conforme o tipo de campo. Por exemplo, se form uma TextBox deve ser passado um valor do tipo String, mas se for uma CheckBox, deve ser um valor do tipo Booelan.

Parâmetro	Tipo	Descrição
fieldName	String	Nome do campo que reberá o valor.
value	Any	Valor a ser atribuído ao campo. O tipo de dados varia conforme o tipo de campo.

Exemplo:

function populateFields() {
   // Obtém a instância do formulário
   var form = latromi.formManager.getFormInstance();
   
   // Preenche os campos
   form.setFieldValue('txtFirstName', 'Bob').
   form.setFieldValue('txtLastName', 'Dylan').
   form.setFieldValue('chkIsInternational', true);
}

Ver Também

latromi.formManager