Eventos Lappiz

Espacios de ejecuión.

Los eventos son periodos de interrupción por código donde Lappiz permite ejecutar reglas de negocio en determinados momentos del uso del sistema de información. Para esto, Lappiz provee 11 (once) eventos, 10 (diez) de ellos tienen una ejecución puntual en el tiempo y 1 (uno) de estos se puede invocar desde los restantes.

Los eventos en los formularios están divididos en dos secciones, los eventos de formulario y los eventos de los controles que están en el formulario.

Eventos de formulario.

Para crear un evento de formulario, se debe modificar una entidad, posteriormente ir al apartado de eventos y dar clic en el botón "Crear". Lappiz abre un formulario para la creación de los eventos y solicita el tipo de evento, su descripción, implementación, orden de ejecución, isBackend y desactivar regla.

Todos los eventos tienen un único parámetro "e" el cual es un objeto con las propiedades necesarias para procesar el evento.

Creando elemento - ItemCreating

Es lanzado antes de crear el registro (En el botón guardar), las propiedades de "e" son las mismas que de ItemSaving.

Editando elemento - ItemEditing

Es lanzado antes de editar el registro (En el botón guardar), las propiedades de "e" son las mismas de ItemSaving.

Elemento cargado - ItemLoaded

Es lanzado cuando el formulario esta en modo edición y el registro ya esta cargado en la pantalla

• Propiedades de e:

  • entityId: nombre de la entidad sobre la cual estoy trabajando

  • entityCode: el código de la entidad sobre la cual estoy trabajando

  • isNew: true si el formulario está en modo nuevo (Siempre llega false aquí)

  • dataItem: registro cargado

Elemento creado - ItemCreated

Es lanzado cuando un registro es creado, las propiedades de "e" son las mismas de ItemSaved.

Elemento editado - ItemEdited

Es lanzado cuando un registro es editado, las propiedades de "e" son las mismas de itemSaved.

Elemento guardado - ItemSaved

Es lanzado cuando un registro es guardado

• Propiedades de e:

  • entityId: nombre de la entidad sobre la cual estoy trabajando

  • entityCode: el código de la entidad sobre la cual estoy trabajando

  • isNew: true si el formulario está en modo nuevo

  • dataItem:registro que se va a guardar (con las modificaciones en caso de estar el formulario en modo Edit, si esta en modo nuevo trae el registro tal cual como quedó en base de datos)

Eliminando elemento - ItemDeleting

Es lanzado cuando un registro es eliminado

• Propiedades de e:

  • entityId: nombre de la entidad sobre la cual estoy trabajando

  • entityCode: el código de la entidad sobre la cual estoy trabajando

  • isNew: true si el formulario está en modo nuevo

  • dataItem:registro que se va a guardar (con las modificaciones en caso de estar el formulario en modo Edit, si esta en modo nuevo trae el registro tal cual como quedó en base de datos)

Formulario cargado - FormLoaded

Es lanzado al inicio cuando el formulario ha sido cargado

• Propiedades de e:

  • entityId: nombre de la entidad sobre la cual estoy trabajando

  • entityCode: el código de la entidad sobre la cual estoy trabajando

  • isNew: true si el formulario está en modo nuevo

/*
Para que los componentes dentro del formLoaded carguen correctamente
cuando se tiene una cantidad considerable de código a ejecutar, se
recomienda inyecatar el código dentro una funcion setTimeOut
*/
setTimeout(() => {
    if(e.isNew)
        console.log('Creando nuevo elemento');
    else
        console.log('Editando elemento ya existente');
}, 100);

General

Crea un método que puede ser invocado dentro de otros eventos y permite una vinculación directa con las acciones.

Todo evento general debe estar asociado a una función. A diferencia de los demás métodos que se ejecutan en una clase global.

Los eventos generales permiten ejecutar sus funciones en otros eventos de la siguiente forma:

Evento General

//Siempre se inicia declarando una función
function sumValues(a, b){
    return a + b;
}

Llamado de función

//Cualquier evento de formulario
var a = e.dataItem.NumeroUno;
var b = e.dataItem.NumeroDos;
var result = sumValues(a, b);
console.log(result);

Guardando elemento - ItemSaving

Es lanzado antes de guardar un registro

• Propiedades de e:

  • entityId: nombre de la entidad sobre la cual estoy trabajando

  • entityCode: el código de la entidad sobre la cual estoy trabajando

  • isNew: true si el formulario está en modo nuevo

  • dataItem:Registro que se va a guardar (con las modificaciones en caso de estar el formulario en modo Edit)

  • cancel:Permite cancelar la operación de guardado, los posibles valores son false o true, en caso que se necesite cancelar el evento ponemos e.cancel = true

Lista cargada - ListLoaded

Es lanzado cuando la vista tipo lista es cargada.

Eventos de los controles.

Los eventos de controles son aquellos relacionados a controles (campos) en especifico, permiten inyectar código al control deseado, encontramos eventos como:

valueChanged

Es lanzado cuando el valor en el control cambia.

fieldLoaded

Es lanzado cuando el control ha sido cargado