lunes, 7 de diciembre de 2015

WSO2 BRS: Uso de tablas de decisión en reglas de negocio.

image

La herramienta WSO2 BRS usa Drool como motor de reglas, lo que nos permite usar las funcionalidades de tablas de decisión basadas en documentos Excel en aquellos casos en que esta sea la mejor variante para implementar un servicio de reglas.

En una entrada de Chathurika Erandi aborda este escenario a partir de un documento excel que usa las mismas reglas descritas en la documentación de la herramienta. La entrada se puede consultar aquí.

Para probar el ejemplo de la entrada cree un documento excel a partir de la imagen plasmada en la entrada y que muestro a continuación.

newdtable

En este excel se definieron las siguientes reglas:
  • Una orden de la compañía A es aceptada si la cantidad es mayor que 10.
  • Una orden de la compañía B es aceptada si la cantidad es mayor que 200 y el precio es mayor que 50.
  • Una orden de la compañía C es aceptada si el precio es mayor que 100.
  • Una orden de la compañía A no es aceptada si la cantidad es menor o igual que 10.
  • Una orden de la compañía B no es aceptada si la cantidad es menor o igual que 200 y el precio es igual o menor que 50.
  • Una orden de la compañía C no es aceptada si el precio es menor o igual que 100.

El siguiente paso fue crear un proyecto en el WSO2 Developer Studio, muestro a continuación como se hace:

Se abre el WSO2 Dashboard y se selecciona la opción Business Rules Service Project.

image

Se selecciona la opción de crear un nuevo proyecto:

image


Y se llenan los datos solicitados del proyecto:

image


Al dar clic en Finish se crea un proyecto con la siguiente estructura. Tengan en cuenta que ya he creado un paquete y agregado las clases necesarias para representar los datos a manejar y las posibles respuestas a devolver por el servicio.


image


Cuando el proyecto es creado se abre automáticamente el fichero service.rsl tal como se muestra a continuación:

image


A continuación debemos proceder al llenado de la sección de Reglas, dando clic en el botón Add. Aquí debemos tener en cuenta que usaremos un fichero excel para definir las reglas, en forma de una tabla de decisión.

image

En la pestaña file damos clic en Browse y cargamos el excel que previamente debió haberse guardado en <Project>/src/main/ruleservice/conf, quedando como sigue:

image


Luego procedemos a crear la operación dando clic en el botón Add. Debe quedar como sigue:

image


Y eso es todo. De esa manera podemos tener ya listo nuestro servicio.

Para terminar esta parte solo resta ir a la raíz del proyecto y ejecutar el siguiente comando maven:
mvn clean install y con eso en la carpeta target tendremos creado el fichero .aar que se debe desplegar en el WSO2 BRS.

Una vez realizado el proyecto procedí a desplegarlo en el WSO2 BRS y me encontré con varios errores:

Error 1:
org.wso2.carbon.rule.common.exception.RuleConfigurationException: Error during creating rule set: [8,34]: [ERR 101] Line 8:34 no viable alternative at input '")
  
        quantity > 10

  
    then

  
        OrderAccept orderAccept = new OrderAccept(); orderAccept.setMessage("Accepted order for: " + placeOrder.getQuantity() + "stock of " + placeOrder.getSymbol() + " at$ " + placeOrder.getPrice()); insertLogical(orderAccept);

  
end 



// rule values at C11, header at C5



Error 2:


[18,11]: [ERR 102] Line 18:11 mismatched input '>' in rule "'AcceptRules' dialect 'mvel'_11"
  
[28,8]: [ERR 102] Line 28:8 mismatched input '>' in rule "'AcceptRules' dialect 'mvel'_12"

  
[37,11]: [ERR 102] Line 37:11 mismatched input '<=' in rule "'Rejectrules'_19"

  
[46,11]: [ERR 102] Line 46:11 mismatched input '<=' in rule "'Rejectrules'_20"

  
[56,8]: [ERR 102] Line 56:8 mismatched input '<=' in rule "'Rejectrules'_21"

  
[0,0]: Parser returned a null Package


Los problemas encontrados se pueden detallar como sigue:
  1. No hace falta que los símbolos estén entre comillas simples. Al inicio pensé que ese era el error y probé sin las comillas o con las comillas dobles y no fue la solución.

  2. Falta la definición del objeto que contiene a los atributos quantity y price.

  3. En el action de la tabla que contiene las reglas de rechazo se muestra una línea de codigo con el siguiente texto: “retract($placeOrder);” Fue necesario removerla para que se mostrada el mensaje de respuesta.

En el excel que muestro a continuación, solo una imagen parcial, ya estos problemas fueron resueltos. Pueden comparar el excel de la imagen del blog contra esta imagen o el excel que les comparto en el proyecto para que vean los ajustes a realizar.


image


 Para terminar les comparto el proyecto en la siguiente ubicación para que ustedes mismo creen el .aar y lo desplieguen en el WSO2 BRS.


En las pruebas que realicé luego de desplegar el proyecto pude apreciar que cuando se cumplía solo una de las condiciones de la regla para la compañía B no se devolvía un resultado y esto se debía a que en las reglas para devolver un resultado de no cumplimiento no se contemplaba esta posibilidad, solo devolvía resultado cuando se cumplían ambas reglas.


Para resolver este problema agregué 2 reglas y 2 condiciones nuevas como se puede apreciar a continuación.


image


De esta manera se puede de manera muy fácil manejar tablas de decisión usando en excel y la suite de WSO2.


Quisiera comentar que me fue de mucha utilidad durante el desarrollo modificar el excel en caliente con los cambios necesarios, esto llevaba a un redespliegue del servicio automáticamente y podía seguir probando.


Espero les sea de utilidad.

5 comentarios:

  1. Interesante este tema de reglas de negocio usando el business rules server de WSO2, ademas de su fácil desarrollo y mantenimiento.

    ResponderEliminar
  2. Muy buen trabajo Jorge, muy bien explicado.

    ResponderEliminar
  3. Ilustrativo ejemplo Jorge. Muchas gracias por compartirlo

    ResponderEliminar
  4. Hola, tengo una consulta.
    Al querer hacer el upload del servicio mediante el .aar luego de agregarlo en el log me aparece el siguiente mensaje "Your InputStream was neither an OLE2 stream, nor an OOXML stream" ¿cual podría ser la causa?

    ResponderEliminar
  5. Preguntas:

    1. Que versión del BRS estás usando?
    2. El proyecto es el mismo, no le has hecho cambios?

    Saludos.

    ResponderEliminar