getFormContext (referencia de la API de cliente)
Devuelve una referencia al formulario o a un elemento del formulario dependiendo de dónde se haya llamado al método.
Sintaxis
ExecutionContextObj.getFormContext()
Valor devuelto
Tipo: Objeto
Descripción: Devuelve una referencia al formulario o a un elemento del formulario, como una cuadrícula editable, dependiendo de dónde se haya llamado al método. Este método le permite crear controladores de eventos comunes que pueden trabajar en un formulario o en un elemento del formulario en función de dónde se llame.
Ejemplo
El siguiente código de muestra demuestra cómo puede crear un método que establece notificaciones en una columna de formulario o celda de cuadrícula editable dependiendo de dónde registró el script (evento columna OnChange o la cuadrícula editable 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');
}
}