getFormContext (Referință API client)

Returnează o referință la formular sau la un element din formular, în funcție de locul unde s-a apelat metoda.

Sintaxă

ExecutionContextObj.getFormContext()

Valoare returnată

Tip: Obiect

Descriere: Returnează o referință la formular sau la un element din formular, cum ar fi grila editabilă, în funcție de locul în care a fost apelată metoda. Această metodă vă permite să creați rutine de tratare eveniment comune care pot opera fie pe un formular, fie pe un element din formular, în funcție de locul unde este apelat.

Exemplu

Următorul cod eșantion demonstrează cum puteți crea o metodă care setează notificarea într-o coloană de formular sau într-o celulă de grilă editabilă, în funcție de locul în care ați înregistrat scriptul (evenimentul Column OnChange sau de grila editabilă 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');
    }
}

Articole asociate

Contextul de execuție
Context formular