getFormContext (referência da API do cliente)

Retorna uma referência ao formulário ou a um item no formulário, dependendo de onde o método foi chamado.

Sintaxe

ExecutionContextObj.getFormContext()

Valor de retorno

Tipo: Objeto

Descrição: retorna uma referência ao formulário ou a um item no formulário, como grade editável, dependendo de onde o método foi chamado. Esse método permite que você crie manipuladores de eventos comuns que podem operar em um formulário ou em um item no formulário, dependendo de onde ele foi chamado.

Example

O código de exemplo a seguir demonstra como você pode criar um método que define a notificação em uma coluna de formulário ou célula de grade editável, dependendo de onde você registrou o script (evento Column OnChange ou evento OnChange de grade editável):

function commonEventHandler(executionContext) {
    var formContext = executionContext.getFormContext();    
    var telephoneAttr = formContext.data.entity.attributes.get('telephone1');
    var isNumberWithCountryCode = telephoneAttr.getValue().substring(0,1) === '+';

    // telephoneField will be a form control if invoked from a form OnChange event;
    // telephoneField will be a editable grid GridCell object if invoked from editable grid OnChange event.
    var telephoneField = telephoneAttr.controls.get(0);

    if (!isNumberWithCountryCode) {
        telephoneField.setNotification('Please include the country code beginning with '+'.', 'countryCodeNotification');
    }
    else {
        telephoneField.clearNotification('countryCodeNotification');
    }
}

Artigos relacionados

Contexto de execução
Contexto do formulário