getFormContext (klient-API-referens)

Returnerar en referens till formuläret eller ett objekt i formuläret beroende på var metoden anropades.

Syntax

ExecutionContextObj.getFormContext()

Returvärde

Typ: Objekt

Beskrivning: Returnerar en referens till formuläret eller ett objekt i formuläret, till exempel redigerbart rutnät beroende på var metoden anropades. Med den här metoden kan du skapa vanliga händelsehanterare som kan fungera antingen på ett formulär eller ett objekt i formuläret beroende på var det anropas.

Example

Följande exempelkod visar hur du kan skapa en metod som anger meddelande för en formulärkolumn eller redigerbar rutnätscell beroende på var du registrerade skriptet (Kolumn OnChange-händelse eller redigerbart rutnät OnChange-händelse ):

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

Körningskontext
Formulärkontext