Introducción
El Validador de Reglas Dinámico (DRT por sus siglas en inglés) está embebido en Bizagi Studio, por lo tanto, sólo está disponible en el ambiente de Desarrollo. Para usar el DRT, abra el proyecto en Bizagi Studio, y seleccione la pestaña de Herramientas. Luego, dé clic en Validador de Reglas Dinámico (Dynamic Rules Tracer):
El DRT usa el protocolo OAuth 2.0 para autenticarse como un cliente del servidor de aplicación BPM. La primera vez que usted abre el DRT desde Bizagi Studio, Bizagi genera un nuevo par de llaves OAuth 2.0. Si usted quiere usar estas llaves o generarlas nuevamente debe abrir el Portal de Trabajo y abrir la sección de aplicaciones OAuth en el menú de Admin. Aquí encuentra las llaves asociadas al Validador Dinámico de Reglas:
Una vez que se generan las llaves OAuth la primera vez, el Validador de Reglas Dinámico se ejecuta. Le sugerimos abrir el Portal de Trabajo antes del DRT y tener el caso listo justo antes de que se ejecute la expresión que desea evaluar. Cuando se abre el DRT, puede registrar el número de caso relacionado con el proceso donde se ubica la regla. Al hacer clic en Buscar, se muestran todas las expresiones en Acciones de actividad. Seleccione la regla y haga clic en el botón Seleccionar:
|
El DRT puede solamente hacer traza de tareas de usuario o manuales. Otro tipo de tareas automáticas como de servicio o de tipo script no son consideradas. |
Hay tres áreas en la ventana del validador: opciones de validación, expresiones validadas y área de inspección.
1. Las opciones del validador descritas a continuación:
Botón |
Descripción |
|---|---|
Connect |
Aquí puede cambiar las credenciales de OAuth 2.0 para conectar la DRT con el servidor de aplicaciones. Si el icono no está activo, significa que la DRT ya está conectada. |
Go to case |
Abrir el Portal de Trabajo en el caso de la regla actualmente evaluada. |
Select rule |
Si el validador no ha sido iniciado, usted puede seleccionar otra regla. |
Start tracer |
Iniciar el validador para capturar la expresión e inyectar el código en el DRT. |
Stop |
Detener el validador ignorando los puntos de interrupción (breakpoints). |
Step over |
Ejecuta la expresión línea por línea. |
Run |
Ejecuta la expresión hasta el siguiente punto de interrupción (breakpoint) o la última línea de código. |
2. El código de la expresión rastreada es analizado por el DRT. Si la expresión contiene módulos gráficos de codificación como las declaraciones If, While o For, el código de la expresión se analiza en un solo código.
3. Área de inspección de variables y XPaths (Watchdogs): una vez que la DRT comienza a rastrear una regla, no se muestran todas las variables y XPaths de forma predeterminada. Se muestran a medida como la línea, donde se declara o asigna la variable, es ejecutada por el validador.
Antes de iniciar el validador, localice los puntos de interrupción necesarios en cualquier número de línea de la expresión en el lado izquierdo, excepto en las declaraciones de variables:
Asegúrese de que el estado del DRT esté conectado antes de iniciar la validación de la regla. Luego haga clic en Iniciar validador (Start Tracer):
Una ventana emergente se muestra, advirtiendo al desarrollador que debe ejecutar la regla en el Portal de Trabajo:
Luego de que se ejecuta la regla en el Portal de Trabajo las opciones de depuración son activadas:
|
Si inicia el validador, y la expresión no se activa en el Portal de Trabajo, la regla no se rastrea en la DRT. Una vez que el DRT comienza a rastrear una expresión, la expresión no se puede editar. |
Luego de que el DRT inicia la depuración de la regla, este se detiene en el punto de interrupción (breakpoint) previamente definido. Si no hay puntos de interrupción, el validador se detiene en la asignación de la primera variable o XPath dentro de la expresión:
Si la variable es un arreglo o un objeto, usted puede inspeccionar su contenido haciendo clic en el ícono de opciones que se ubica en la columna de valor, en el área de inspección:
Una vez que el DRT termina de rastrear la regla, el caso vuelve a su estado inicial. Esto significa que las variables y Xpaths vuelven a su estado inicial antes de que la DRT rastree la regla, y el Scope no se vea afectado, como si la regla nunca se ejecutara. Un mensaje de advertencia alerta al usuario de que el validador ha finalizado.
Evaluando valores de XPaths
Por defecto el Validador de Reglas Automático no detecta automáticamente los Xpath incluidos en la expresión. Si quiere ver los valores de Xpaths, tiene que escribir el Xpath en la parte inferior del área de inspección al costado derecho sin corchetes de diamante < >:
Usted solo puede evaluar XPaths si el validador ha sido iniciado y la regla ha sido ejecutada en el Portal de Trabajo, y capturada por el Validador de Reglas Dinámico.
|
Las funciones XPaths solo se pueden evaluar si la función inicia con los corchetes tipo diamante < >. Por ejemplo, <sum( )>. Otras funciones de otros objetos como CHelper o Me no se pueden evaluar en el Validador de Reglas Dinámico. |
Buenas prácticas y consideraciones en reglas evaluadas por el Validador Dinámico de Reglas
El Validador de Reglas Dinámico rastrea una expresión siempre que se valide correctamente en el diseñador de expresiones. Si hay errores de validación, la DRT no rastrea la regla. Además, hay algunas buenas prácticas y consideraciones que se deben tener en cuenta al utilizarlo.
1. Siempre use punto y coma al final de cada instrucción ejecutable:
Múltiples líneas separadas por punto y coma pueden ser evaluadas en el DRT:
Si usted declara variables en diferentes líneas sin usar el punto y coma, estas no son evaluadas por el DRT:
2. El DRT ignora espacios. Por ejemplo, estas líneas son equivalentes para el DRT:
3. El DRT identifica las diferencias en nombres usando letras mayúsculas. Por ejemplo, SegundoNombre y segundonombre son reconocidas como dos variables diferentes.
4. Siempre usar corchetes curvos { } en condicionales como por ejemplo If, While o For. Estas condicionales sin estos corchetes no son evaluados por el DRT:
5. Si usted declara dos veces la misma variable, esta va a ser considerada como otra variable en el área de inspección. Cuando la expresión asigna el valor a la variable, está se muestra dos veces en el área de inspección:
6. Si la expresión tiene la función Switch, solamente es posible inspeccionar las variables y XPaths después de que la expresión salga de la función Switch:
7. No use variables con caracteres especiales.
Validador de Reglas Dinámico ejecutado fuera de Bizagi Studio
En escenarios donde el desarrollador necesite validar una regla dinámicamente sin usar Bizagi Studio. El DRT puede ser ejecutado como un ejecutable que se encuentra en la siguiente ruta: C:\Program Files\Bizagi\Bizagi Studio\Studio
Cuando ejecuta el DRT las credenciales OAuth 2.0 son solicitadas:
Luego haga clic en el botón Conectar y puede usar el DRT como se describe en este artículo. Si las llaves OAUth no han sido generadas aun, usted debe crearlas en las Aplicaciones OAuth 2 en menú de Admin del Portal de Trabajo. El tipo de autorización (Grant type) debe ser All y el Scope permitido (Allowed Scope) LOGIN:
Reconectarse a otra URL
Dynamic Rules Tracer tiene la opción de volver a conectarse a una URL diferente. Por ejemplo, si configura sockets seguros para la URL de su portal de trabajo (de HTTP a HTTPS), la ventana DRT muestra la conexión actual, pero si necesita cambiar la URL, puede hacer clic en el botón Conectar.
Bizagi alerta que la conexión actual debe desconectarse.
Last Updated 1/23/2024 4:56:10 PM