Introducción
Hay situaciones comunes en las que una regla o expresión pueden utilizarse en diferentes escenarios en un proyecto, para realizar una acción en específico.
Para evitar la necesidad de escribir la misma regla o expresión en cada uno de esos escenarios, Bizagi cuenta con las Reglas de librería.
Las Reglas globales, como también se les conoce, pueden ser reutilizadas a través de todas las aplicaciones y procesos contenidas en el mismo proyecto, en cada una de las situaciones. De esta manera, los usuario que desarrollan los procesos solo deben escribir la regla una vez y aplicarla siempre que sea necesaria.
Aplicabilidad y conceptos
Algunos ejemplos de esos escenarios son: obtener la fecha de hoy, obtener el ID del creador del caso, validar si una fecha es feriado, etc.
Las reglas de librería funcionan tal como las de negocio, pero no tienen un contexto asociado pues pueden ser invocadas desde cualquier parte del proyecto. Esto significa que las reglas de librería no tienen acceso al Modelo de datos, por lo que en ellas no se pueden usar XPaths.
Mantener las reglas de librería organizadas
En algunos proyectos puede necesitarse muchas reglas de librería, lo que potencialmente crea dificultades para identificar la regla específica que se necesita usar y también dificulta el mantenimiento de las reglas y el proyecto. Para mantener sus reglas organizadas, se recomienda usar Familias de expresiones, las cuales permiten crear grupos de reglas.
Por lo tanto, antes de empezar a usar las reglas de librería, debe primero crear una familia de expresiones.
Para usar esta opción, vaya a la Vista de experto, escoja la opción de Reglas de negocio y seleccione el nodo de Reglas de librería. Luego haga clic en Nueva familia de expresiones.
Saldrá una ventana pidiendo que ingrese un nombre para su Familia de expresiones.
Entre el nombre deseado y haga clic en OK.
Luego, en la ventana principal podrá ver la Familia de expresiones recién creada.
Por ejemplo, si el nombre entrado es "Date", el resultado será el siguiente.
En cada Familia de expresiones se puede añadir la cantidad de reglas que se desee.
Crear reglas de librería
Las reglas de librería se pueden crear independientemente o como parte de una Familia de expresiones existente. Para crear una regla sola, haga clic en Nueva regla de librería, al lado de la opción de Nueva familia de expresiones. Si desea añadir una regla como pare de una familia, haga clic derecho en la familia y seleccione la opción Nueva regla de librería que se muestra en el menú.
De cualquier manera, una ventana similar a la siguiente se mostrará.
Allí puede construir su regla, similar a lo que haría al construir una expresión.
Configure un nombre, descripción, la familia a la que va a pertenecer la regla, tipo de retorno y parámetros.
Luego construya su regla como lo haría normalmente en un editor de expresiones.
|
Recuerde que cuando construye reglas de librería no se tiene un contexto, lo que significa que no se puede navegar el Modelo de datos y que los Xpaths no pueden ser usados. Por ello debe evitar el uso de cualquier función XPath o Me como Me.getXPath, Me.newCollectionItem, o <count(XPath)> |
Usar reglas de librería
Cuando ya haya configurado una regla de librería, puede querer usarla en alguna parte de su proyecto. Es importante mencionar que siempre que las expresiones estén disponibles para ser utilizadas, se puede invocar una regla de librería. Para hacerlo, haga clic en la opción de Reglas de librería en el editor de expresiones, como se muestra abajo.
Saldrá una ventana con una vista de árbol con todas las reglas configuradas. Note que están organizadas por Familias de expresiones.
Seleccione la regla que desea añadir y haga clic en Ok. Saldrá una ventana emergente en donde debe especificar donde almacenar el valor retornado.
Hay dos formas diferentes de elegir cómo almacenar el valor de retorno de la regla de librería, dos lugares diferentes para almacenar la salida:
•El primero es el botón con un icono de lápiz, que le permite elegir una variable existente o crear una nueva.
Como se indicó, este le permite almacenar la salida en una variable para su uso posterior.
•Y el segundo, el botón con un icono de diagrama que fluye verticalmente, permite elegir un atributo del modelo de datos para almacenar el valor.
Éste le permite almacenar directamente la salida en un atributo de una entidad determinada de su modelo de datos.
|
El tercer botón limpiará lo que haya configurado previamente, úselo en caso de que desee arreglar un error o realizar un cambio. |
En cualquier caso, la configuración resultante se ve como una instrucción de asignación, tal como se manejan comúnmente en los lenguajes de programación.
Una instrucción de asignación donde, en su parte izquierda, muestra el atributo o variable del modelo de datos que almacena la salida.
Y en la parte derecha, presenta la invocación real de la regla de la biblioteca, mientras se le envían las entradas, entre paréntesis.
La siguiente imagen muestra un ejemplo, que tiene específicamente el objeto Me enviado como entrada y tiene su salida almacenada en una variable llamada vDate.
Ejemplos
Utilice los dos ejemplos siguientes para obtener orientación adicional.
Ejemplo 1 - Fecha de hoy
Suponga que usted trabaja en un banco. Se desea que cuando se realicé una solicitud para un crédito, la fecha de la solicitud quede definida por defecto. De esta forma se asegura que cuando se cree un nuevo caso, se asigne a la fecha de la solicitud la fecha de Hoy.
Otro ejemplo, en el Proceso de Solicitud de Compras es necesario configurar un valor de fecha mínima para realizar la entrega de los productos: Es necesario que la fecha sea después de hoy debido a que la entrega se hace al menos un día después.
Ya que pueden existir muchos escenarios que necesitan verificar la fecha actual (hoy), tiene mucho sentido crear una sola regla y utilizarla varias veces a través de los procesos.
Note que esta regla no necesita un contexto. No hay ninguna manipulación del modelo de datos, solo se necesita la fecha de hoy.
Por lo cual, hemos creado una regla Global que devuelve la fecha de Hoy utilizando una función de la categoría de Fechas y Tiempos.
En la vista de Experto, seleccione la opción Reglas de negocio. dé clic derecho en Expresiones de la clasificación de las Reglas de Negocio y dé clic sobre Nueva Expresión de Script.
Cuando se crea una nueva regla es posible ubicarla dentro de una familia de reglas, seleccione la familia de la lista desplegable si aplica, de lo contrario deje el espacio en blanco.
Vamos a utilizar esta regla en el Modelador de Formas de un proceso para definir el valor por defecto o una fecha mínima o máxima.
Abra el modelador de formas y seleccione el atributo donde se quiere incluir la regla. Seleccione la propiedad valor por defecto y luego asigne la regla.
Last Updated 2/1/2023 3:54:30 PM