getFormContext (Informazioni di riferimento sulle API client)

Restituisce un riferimento al form o a un elemento del form a seconda della posizione in cui è stato chiamato il metodo .

Sintassi

ExecutionContextObj.getFormContext()

Valore restituito

Tipo: Oggetto

Descrizione: restituisce un riferimento al modulo o a un elemento nel modulo, ad esempio una griglia modificabile, a seconda della posizione in cui è stato chiamato il metodo. Questo metodo consente di creare gestori eventi comuni che possono operare su una maschera o su un elemento nel form a seconda della posizione in cui è stato chiamato.

Example

Il codice di esempio seguente illustra come creare un metodo che imposta la notifica su una colonna di modulo o una cella della griglia modificabile a seconda della posizione in cui è stato registrato lo script (evento Column OnChange o griglia modificabile OnChange ):

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

Articoli correlati

Contesto di esecuzione
Contesto modulo