getFormContext (referência da API do cliente)

Retorna uma referência ao formulário ou 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 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 um item no formulário, dependendo de onde ele é 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