Eventos en formularios y cuadrículas en aplicaciones basadas en modelos

  • Artículo

Todo el código del lado cliente es iniciado por eventos. En las aplicaciones basadas en modelos, asocia una función específica a una biblioteca de JavaScript (Recurso web del script) para que se ejecute cuando se produzca un evento. Esta función se denomina controlador de eventos. Cada controlador de eventos especifica una sola función dentro de una biblioteca de JavaScript y los parámetros que pueden pasarse a la función.

Puede asociar controladores de eventos a solo algunos eventos mediante la interfaz de usuario. Para los eventos que no están disponibles para asociarlos a través de la interfaz de usuario, la API de cliente proporciona métodos que pueden usarse para vincular los controladores de eventos a dichos eventos.

Agregar o quitar funciones de controlador de eventos a eventos mediante la interfaz de usuario

Utilice la sección Controladores de eventos del cuadro de diálogo Propiedades de formulario para asociar su script con un evento para formularios y columnas.

Sección del controlador de eventos en las propiedades del formulario.

Formularios de edición masiva

De forma predeterminada, los controladores de eventos no se llaman cuando un formulario está en bloque modo de edición.

Para habilitar un controlador de eventos de forma masiva modo de edición, modifique el XML del formulario buscando el elemento event y creando/configurando el atributo BehaviorInBulkEditForm como Enabled. Actualmente, esto solo es compatible con Eventos OnLoad.

Para obtener más información sobre la personalización de formularios XML, consulte Cuándo editar el archivo de personalizaciones, Personalizar formularios y Formulario de esquema XML.

Para determinar cuándo se llama a un controlador de eventos en un formulario en modo de edición masiva, use el método getFormType.

Agregar o quitar funciones de controlador de eventos a eventos mediante el código

Use los siguientes métodos para agregar y quitar el controlador de eventos para los eventos que no se pueden asociar mediante la interfaz de usuario:

Eventos Controlador de eventos
Atributo OnChange Métodos addOnChange y removeOnChange
Formulario OnLoad Métodos formContext.ui addOnLoad y removeOnLoad
Datos de formulario OnLoad Métodos formContext.data addOnLoad y removeOnLoad
Formulario OnSave Métodos addOnSave y removeOnSave
Control de búsqueda PreSearch Métodos addPreSearch y removePreSearch
Control kbsearch OnResultOpened Métodos addOnResultOpened y removeOnResultOpened
Control kbsearch OnSelection Métodos addOnSelection y removeOnSelection
Control kbsearch PostSearch Métodos addOnPostSearch y removeOnPostSearch

Importante

El contexto de ejecución se pasa automáticamente como el primer parámetro a las funciones definidas con el código. Más información: Contexto de ejecución de la API del cliente

Canalización de eventos de formulario

Puede definir hasta 50 controladores de eventos para cada evento. Cada controlador de eventos se ejecuta en el orden en que se muestra en la sección Controladores de eventos de la ficha Eventos del cuadro de diálogo Propiedades del formulario.

Use los métodos setSharedVariable y getSharedVariable para pasar una variable común entre los controladores de eventos (funciones). Use el método getDepth del contexto de ejecución para conocer la secuencia en que se ejecuta un controlador de eventos en relación con otros controladores de eventos.

Comprender el modelo de objetos de API de cliente
Contexto de ejecución de la API de cliente
Eventos (referencia de la API de cliente)

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).