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.

Nota

¿No está seguro de entidad frente a tabla? Vea Desarrolladores: comprender la terminología en Microsoft Dataverse.

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

Contexto de ejecución

Contexto de formulario

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).