Sdílet prostřednictvím


getFormContext (referenční dokumentace k rozhraní API klienta)

Vrátí odkaz na formulář nebo položku ve formuláři v závislosti na tom, kde byla volána metoda.

Syntaxe

ExecutionContextObj.getFormContext()

Návratová hodnota

Typ: Objekt

Popis: Vrátí odkaz na formulář nebo položku ve formuláři, například upravitelnou mřížku v závislosti na tom, kde byla volána metoda. Tato metoda umožňuje vytvářet běžné obslužné rutiny událostí, které mohou pracovat buď ve formuláři, nebo v položce ve formuláři v závislosti na tom, kde je volána.

Example

Následující ukázkový kód ukazuje, jak vytvořit metodu, která nastaví oznámení ve sloupci formuláře nebo upravitelné mřížce v závislosti na tom, kde jste zaregistrovali skript (událost Column OnChange nebo upravitelná mřížka OnChange událost):

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

Kontext spuštění
Kontext formuláře