getFormContext (Client-API-Referenz)

Gibt einen Verweis auf ein Formular oder ein Element im Formular zurück, für das die Methode aufgerufen wurde.

Syntax

ExecutionContextObj.getFormContext()

Rückgabewert

Typ: Objekt.

Beschreibung: Gibt einen Verweis auf ein Formular oder ein Element im Formular zurück, wie bearbeitbares Raster, je nachdem, von wo die Methode aufgerufen wurde. Diese Methode ermöglicht die Erstellung von gemeinsamen Ereignishandlern, die entweder für ein Formular oder ein Element auf dem Formular, je nachdem, von wo sie aufgerufen wurde.

Beispiel

Der folgende Beispielcode zeigt, wie Sie eine Methode erstellen können, mit der Benachrichtigungen für eine Formularspalte oder eine bearbeitbare Rasterzelle festgelegt werden, je nachdem, wo Sie das Skript registriert haben (Spalte OnChange Ereignis oder bearbeitbares Raster Bei Änderung Ereignis):

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

Ausführungskontext
Formularkontext

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).