getFormContext (referencia de la API de cliente)

Devuelve una referencia al formulario o a un elemento del formulario dependiendo de dónde se haya llamado al método.

Sintaxis

ExecutionContextObj.getFormContext()

Valor devuelto

Tipo: Objeto

Descripción: Devuelve una referencia al formulario o a un elemento del formulario, como una cuadrícula editable, dependiendo de dónde se haya llamado al método. Este método le permite crear controladores de eventos comunes que pueden trabajar en un formulario o en un elemento del formulario en función de dónde se llame.

Ejemplo

El código de ejemplo siguiente demuestra cómo puede crear un método que establece una notificación en un campo de formulario o en una celda de cuadrícula editable en función de dónde registró el script (evento Campo OnChange o evento de cuadrícula editable OnChange):

function commonEventHandler(executionContext) {
    var formContext = executionContext.getFormContext();    
    var telephoneAttr = formContext.data.entity.attributes.getByName('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.getByIndex(0);

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

Contexto de ejecución

Contexto de formulario