Guía – Entendiendo los disparadores del sistema de Validaciones B1.

Guía – Entendiendo los disparadores del sistema de Validaciones B1.
En este documento entraremos en detalle de cómo funcionan los disparadores del Sistema de Validación de
B1.
Datos de prueba.
Para probar un evento lo mejor sería que hiciera un ejemplo usted mismo. La mejor manera es creando las
siguientes dos configuraciones.
Las dos configuraciones es donde cambiaremos el método de ejecución para probar los diferentes tipos de
disparos de eventos.
Un Overview
Si le echamos un vistazo al cliente de SAP Business Oe, en general podemos ver que es una interfaz que
recibe información vía el Mouse y el Teclado, podemos ver cada una de estas cosas como disparadores
potenciales de eventos.
El sistema de disparos se puede considerar como un filtro de ciertas acciones de usuario que nos servirán
para agregar funcionalidad adicional y al configurar el sistema de validación de B1 podemos tomar estos
cientos de eventos para las funcionalidades que necesitemos.
El tipo de forma, campo, columna, fila y Menu Uid.
La primera parte está relacionada con el formulario, campo, columna, fila y Menu Uid.
SAP Business One consiste en cientos de ventanas pero al introducir el formulario de la ventana en la que
trabajaremos ya tenemos un filtro principal.
El siguiente filtro que tenemos que indicar es el campo con el que trabajaremos. Si no lo proporcionamos,
cada uno de los campos y eventos de esa ventana disparará el evento.
NOTA: Solo algunos pocos eventos como el abrir o cerrar el formulario no deben de tener un campo, pero el 95% de todos los
eventos deben de tener la combinación de formulario y campo.
Si el campo con el que está trabajando está a nivel línea tiene que proporcionar la columna con la que estará
trabajando (de no ser así el disparador se ejecutará con cualquiera de las columnas).
El último y menos usado es de fila de documento. Esto puede ser utilizado para hacer el filtro aún más
específico, por ejemplo definir que se ejecutará con las primeras 10 partidas.
Alternativamente, si trabajamos con el evento del MenuClic, la columna y la fila serán ignorados y solamente
se ejecutará cuando hagamos clic en un menú específico (Menu Uid).
Ejemplos
Trigger
Resultado
Cualquier lugar en la ventana de Datos Maestros de
Socios de Negocios en la que hagamos clic disparará
el evento.
Ahora reducimos el evento al campo 7 (el campo de
nombre).
Modo Formulario.
Lo siguiente que podemos configurar es el modo del formulario.
Esto hace posible que puedas tener el disparador solamente cuando la ventana se encuentre en cierto modo.
Podemos elegir entre las 6 diferentes combinaciones.
Ejemplos
Disparador
Resultado
Disparamos en cualquiera de los modos.
Modo buscar:
Modo agregar:
Ahora cambiamos el tipo de formulario a Add
(Guardar) y vetemos que el evento deja de
ejecutarse estando en modo Buscar/OK/Actualizar,
solamente se ejecutará en modo Guardar.
Los diferentes eventos.
A partir de la versión 4.0.0.0 hay 19 tipos de eventos que podemos cachar.
Evento
Click
Descripción
Este evento se ejecuta antes de todos los demás eventos y básicamente funciona
cada vez que presiona el botón derecho del mouse (inclusive antes de que suelte
el botón y aunque no presione un campo que normalmente presiona, como por
ejemplo una etiqueta).
El evento del Clic es normalmente confundido con el evento “Item pressed” o
campo presionado.
Combobox Select
Este evento ocurre cuando la selección de un Combo es realizada. Este evento
solo se disparará con combos a nivel línea o cabecera de documento.
Double Click
El Doble clic es el mismo evento del clic pero solo cuando se ejecuta dos veces
consecutivas.
Considere que si ya tiene un evento de un solo clic, siempre detendrá la acción y
jamás se disparará el evento del doble clic.
Form Load
Form Load siempre ocurre cuando se abre una ventana y no se ejecutará
nuevamente cuando estemos trabajando en ella.
NOTA: Este evento solo necesita el FormType o formulario, no requiere
configuración de un objeto o campo.
TIP: Esto es más usado con Funciones Universales de tipo creación de contenido.
Form Closing
Form Closing ocurre justo antes de que la ventana sea cerrada, si comparamos
con Form-Closed este evento ocurre una vez que la ventana se cerró (este es útil
si desea prevenir que la ventana sea cerrada).
NOTA: Este evento solo necesita el FormType o formulario, no requiere
configuración de un objeto o campo.
Form
Closed
(form Form unload es el equivalente a la aperture del formulario pero solo ocurre
unload)
cuando la ventana es cerrada.
Este evento es raramente usado.
Got Focus
Este evento ocurre cuando un campo de texto tiene el foco (cuando el cursor
parpadea en el o es cambiado a color amarillo).
Lost Focus
Este evento se ejecuta cuando se abandona un campo. Es muy similar al evento
validate, pero la diferencia es que el Lost Focus se ejecuta una vez que ya se dejó
el campo (el Validate se ejecuta antes de dejarlo).
Item Pressed
Este es uno e los eventos mayormente usado. Este evento se ejecuta cuando
presionamos Botones, Pestañas, Casillas de selección o Botones de ligas (flechas
naranjas).
Key Down
Este evento se ejecuta cuando una tecla es presionada, el modificador es para
incluir una combinación, como puede ser con ALT, CTRL o SHIFT.
Validate
Este evento es usado normalmente cuando se trata de abandonar un campo
(usado normalmente para validar la información introducida en el mismo).
Menu Clic
Este evento se ejecuta cuando un objeto del menú es presionado. Los tipos de
menú son desde la barra de menú, menú principal, Menú superior o menú de clic
derecho.
NOTA: Este evento se disparará aun cuando se utilice el atajo de CTRL+F.
NOTA: No es posible usar un evento de MenuClic si no se introduce un valor en el
MenuUid.
Data load
Este evento es similar a FormLoad pero solo se ejecuta cuando son mostrados
datos en la ventana. Por ejemplo si abre la ventana de Orden de Venta el evento
FormLoad se ejecutará, pero si abre una Orden de Venta existente entonces el
DataLoad event se disparará.
Data Add
Similar al evento DataLoad pero sólo cuando guarda información en el formulario
Colum link pressed
seleccionado (cuando presiona el botón Crear y los datos son guardados).
Similar a Data Add pero cuando actualizamos información.
Similar a Data Add y Data update pero solamente se ejecuta cuando se elimina
información (de la base de datos, no precisamente en modo buscar).
Ocurre cuando se presiona una flecha naranja a nivel línea.
Column Picker Pressed
Ocurre cuando se presiona un ícono dentro de una celda.
Data Update
Data Delete
Cuando
B1UP
terminado la cargar
ha Como el nombre lo indica, este evento se ejecuta una vez que B1 usability
Package se ha terminado de cargar totalmente. Esto es útil si desea ejecutar una
ventana al iniciar.
Hay muchas combinaciones aquí, se recomienda probarlas en un ambiente de prueba para revisar su
comportamiento y funcionamiento.
BeforeAction, ActionSucess, ItemChanged e Inner Event.
Estas son 4 opciones avanzadas que pueden ser configuradas como Verdad, Ignorar y Falso.
Opción
BeforeAction+ActionSuccess
ItemChanged
InnerEvent
Ejemplos.
Descripción
Esta opción en conjunto con las propiedades de ActionSuccess le
permiten determinar cuándo se disparará el evento comparado con la
forma en la que SAP Business One reacciona al mismo.
La mejor forma de describirlo es el ejemplo que se mencionará a
continuación.
Esto determina si solo desea que reaccione si el campo del evento ha
cambiado.
Los eventos de usuario son casos muy raros. Estos son llamados
InnerEvents. Esto a veces puede terminar en un Loop interminable. Esto
es mejor dejarlo con el valor Ignorar pero en casos muy raros tal vez
deberá cambiarlos.
NOTA: Por favor note que para estos eventos se necesita cambiar la función universal de prueba.
La propiedad de bloquear evento está ahora Activada (requerida para el ejemplo BeforeAction).
Ejemplo
Resultado
Aquí disparamos e evento cuando damos clic en el botón
Crear de la ventana de socios de negocios.
Si damos clic en el botón podemos observar que el evento
ocurre antes de que el socio de negocios sea guardado, por
lo cual bloqueamos el evento de SAP para que no ocurra.
Ahora probemos configurando el BeforeAction en Ignorar y
el ActionSuccess en verdad.
Ahora si presionamos el botón vea que el evento se ejecuta
una vez que el socio de negocios se ha guardado
(posteriormente a que el evento de SAP Business One se
ejecute).
Ahora probemos algo diferente. Vamos al disparar el evento
al cambiar el nombre del cliente (recuerde cambiar el
BeforeAction a Falso o será bloqueado y no podrá
abandonar el campo).
Si nos vamos al campo de nombre del cliente, introducimos
un valor y nos salimos obtendremos el evento.
Ahora si nos vamos nuevamente al campo y nos salimos sin
hacer cambio alguno obtendremos el mismo evento.
Ahora cambiamos el campo ItemChange a Verdad y con ello
cambiara el comportamiento.
Ahora ingresemos al campo sin realizar cambios, el evento
no se disparará.
Solo si ingresamos y realizamos cambios es cuando
obtendremos el evento.
Tecla pulsada y Modificado.
La parte final del Trigger es cuando una Tecla es pulsada y el Modificado. Estos solo son usados cuando una
tecla es presionada (si no son ignorados).
Básicamente lo que tiene que hacer es introducir el valor ASCII de la tecla que disparará este evento.
NOTA: Tome en cuenta que SAP usa muchos atajos de teclas, para que los add-ons no interfieran con ellos valide la tecla que utilizará.
Tabla de caracteres a presionar.
Ejemplos
Trigger
Resultado
El presionar el carácter 36 equivale al botón de Inicio y
el campo 5 es el Código de SN, así que si se posiciona en
ese campo y presiona la tecla de inicio se disparará el
evento.
Ahora, si cambiamos nuestro Trigger a que use el
modificador CTRL, el evento solo se ejecutará si
presionamos la tecla CTRL + Inicio.