getFormContext (referència de l'API del client)

Retorna una referència al formulari o a un element del formulari en funció d'on s'hagi cridat el mètode.

Sintaxi

ExecutionContextObj.getFormContext()

Valor de retorn

Tipus: Objecte

Descripció: retorna una referència al formulari o a un element del formulari, com ara una quadrícula editable, en funció d'on s'hagi cridat el mètode. Aquest mètode us permet crear controladors d'incidències comuns que poden funcionar en un formulari o en un element del formulari en funció d'on es truqui.

Exemple

El codi d'exemple següent mostra com podeu crear un mètode que defineixi la notificació en una columna de formulari o una cel·la de quadrícula editable en funció d'on hàgiu registrat l'script (incidència Column OnChange o esdeveniment OnChange de quadrícula editable):

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');
    }
}

Articles relacionats

Context d'execució
Context del formulari