Home

JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS

1. E Properties x m Resource packages mortgages Sample dri 2 Revision Date Author Comment El Property Value 5 2009 05 12T14 4 admin lt content from webdav gt Created 2009 05 11T07 43 44Z A 2009 05 12T14 4 admin lt content from webdav gt Last Moc 2009 05 12T14 45 23 3 2009 05 11T17 4 admin lt content from webdav gt Location packages mortgages Sar 2 2009 05 11T17 4 admin lt content from webdav gt Name Sample drl Bl a OOO OS 1ITIT A a rotor bdo Dl aa a Read Only Insert 16 9 at izre Figura 10 1 Perspectivas de exploraci n del repositorio Guvnor 10 2 Asistente de conexi n Guvnor Despu s de abrir la perspectiva Guvnor la primera tarea es realizar una conexi n a un repositorio Guvnor Esto lo maneja el asistente de conexi n Guvnor Este asistente aparece en varios lugares dentro de EGT como se detalla a continuaci n pero en esta secci n vamos a abordar solo los dos puntos de entrada m s b sicos El asistente de conexi n Guvnor se puede iniciar utilizando el men de Eclipse File New Other Guvnor Guvnor repository location o en el explorador Guvnor utilizando el men desplegable 7 x Delete S F3 Add gt Refresh Figura 10 2 Asistente de conexi n o el bot n en el men Figura 10 3 Asistente de conexi n El seleccionar cualquiera de estos iniciar el asistente de conexi n Guvnor 60 Cap tulo 10 Integraci n de JBoss Developer Studio New Guvnor connection Create a n
2. Commercial Mortgage Figura 4 1 Categorias Las categorias permiten etiquetar las reglas activos con cualquier nUmero de agrupamientos que usted defina Esto significa que luego puede ver una lista de reglas que coinciden con una categoria especifica Las reglas pueden pertenecer a cualquier numero de categorias En el diagrama anterior puede ver que se presenta como una carpeta explorador como una vista de activos Los nombres pueden ser como los quiera y los definen el administrador BRMS tambi n puede borrar agregar nuevas categorias solo puede borrarlas si actualmente no se encuentran en uso 15 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS Generalmente las categorias se crean con nombres significativos que coinciden con el area empresarial a la cual aplica la regla por lo tanto si la regla aplica a m ltiples reas se pueden adjuntar m ltiples categorias Las categorias tambi n se pueden utilizar para etiquetar reglas como parte de su ciclo de vida por ejemplo para marcar algo como borrador o por revisar Categories Home Ji rtgage Eligibility IT Y les Figura 4 2 Los activos pueden tener m ltiples categor as La vista anterior muestra la categor a Editor Vista que se puede ver cuando abre un activo En este ejemplo puede ver que el activo pertenece a dos categor as Esto significa que cuando cualquiera de las categor as se utiliza para mostrar una lista de activos entonces ver es
3. O redhat JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS Para desarrolladores de JBoss Rules escritores de reglas y analistas empresariales Edici n 5 2 0 Landmann JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS Para desarrolladores de JBoss Rules escritores de reglas y analistas empresariales Edici n 5 2 0 Landmann rlandmann redhat com Legal Notice Copyright 2010 Red Hat Inc This document is licensed by Red Hat under the Creative Commons Attribution ShareAlike 3 0 Unported License If you distribute this document or a modified version of it you must provide attribution to Red Hat Inc and provide a link to the original If the document is modified all Red Hat trademarks must be removed Red Hat as the licensor of this document waives the right to enforce and agrees not to assert Section 4d of CC BY SA to the fullest extent permitted by applicable law Red Hat Red Hat Enterprise Linux the Shadowman logo JBoss MetaMatrix Fedora the Infinity Logo and RHCE are trademarks of Red Hat Inc registered in the United States and other countries Linux is the registered trademark of Linus Torvalds in the United States and other countries Java is a registered trademark of Oracle and or its affiliates XFS is a trademark of Silicon Graphics International Corp or its subsidiaries in the United States and or other countries MySQL is a registered trademark of MySQL A
4. Text puede formatear los metadatos Guvnor que se agregan a los nombres de archivos si mostrar un indicador gt cuando el archivo local tiene cambios que no se han guardado en el repositorio Guvnor Si debe mostrar el n mero de la revisi n si debe mostrar el sello de fecha Cualquier cambio a estas preferencias tienen efecto de manera inmediata al hacer clic en los botones Apply u Ok 72 Cap tulo 11 Configuraci n de clientes para la firma de paquetes de reglas Cap tulo 11 Configuraci n de clientes para la firma de paquetes de reglas Lea esta secci n para aprender sobre la firma de paquetes de reglas y la configuraci n del almacenamiento de llaves La firma de paquetes de reglas asegura que los paquetes de reglas no se puedan da ar o alterar durante la descarga del servidor de JBoss Enterprise BRMS Platform para las aplicaciones clientes La firma de paquetes de reglas no est habilitada por defecto A mportante Red Hat recomienda que se habilite la firma de paquetes de reglas en entornos de producci n La firma de paquetes se implementa usando la criptograf a de llaves p blicas Se utiliza el comando JDK keytool para crear una llave privada y un certificado digital p blico correspondiente Los paquetes firmados con una llave privada s lo se pueden verificar con el certificado que coincida La llave privada se almacena en un archivo llamado keystore y el servidor lo utiliza para firmar autom ticament
5. a Current version number 5 Version history amp 4 modified on 4 20 10 2 50 AM more changes 3 modified on 4 20 10 2 50 AM another change 2 modified on 4 20 10 2 50 AM my change E View Figura 4 25 Versiones de activos Cada vez que realiza un cambio a un activo se crea un nuevo objeto en el historial de versiones Esto le brinda una funci n ilimitada para deshacer Puede mirar la historia de un activo individual como se puede ver en la lista anterior y luego verlo y reestablecerlo desde ese momento 4 7 Administraci n de implementaci n Las URLs son una parte central del proceso que rodea la manera en que se proporcionan los paquetes de conocimiento BRMS proporciona paquetes de conocimiento por medio de URLs para que el agente de conocimiento los utilice y los descargue Estas URLs tienen la forma http localhost 8080 jboss brms org drools guvnor Guvnor package lt packageName gt lt packageVersion gt lt packageName gt es el nombre que le dio al paquete lt packageVersion gt es el nombre o una toma de pantalla o LATEST si es LATEST entonces ser la ltima versi n constru da del paquete principal y no una toma de pantalla Puede utilizarlas en el agente o puede pegarlas en su navegador y las descargar como archivos estas URLs y las descargas binarias en su aplicaci n y la manera en que se pueden actualizar las reglas sobre la marcha 41 JBoss Enterprise BRMS Platform 5 Manual del u
6. Back Cance Figura 10 21 Importaci n Una vez termine el asistente copia los archivos seleccionados del repositorio Guvnor al espacio de trabajo local Si ya existe un archivo con el mismo nombre en el destino entonces el asistente usa la ventana est ndar de Eclipse prompt for rename Enter a new name for versionHistoryTest txt CopyOfversionHistoryTest txt OK Cancel Figura 10 22 Copiar 10 7 Preferencias plug in de Guvnor EGT brinda una p gina de preferencias en la categor a Guvnor ity pe filter text Guvnor oy gt General Repository Connections PANE Guvnor URL template http localhost 8080 jboss brms org drools guvnor Guvnor webdav gt Data Management oid dt dit Drools El Save passwords in platform key ring S Drools Flow node File Decoration Installed Drools F Icon decoration location Top right Y Drools Task Text FreeMarker Editor Include change indication gt guvno Y Include revision Help Y Include date time stamp HQL editor gt Install Update gt Java E Restore Defaults Apply lt r EX 5 gt OK Cancel Figura 10 23 Preferencias 71 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS Las preferencias cubren dos categorias las conexiones del repositorio Guvnor y las decoraciones de recursos del repositorio local Guvnor Preferencias de conexi n del repositorio Guvnor Hay dos preferencias que se pueden establecer para
7. p a OK a Sub prime aja 35 25 AA F a OK a Sub prime El 45 E 35 AA d a OK a Sub prime Save and close Add row Figura 4 15 Fusi n de celdas 4 3 10 1 2 Agrupamiento de celdas Las celdas que se han fusionado se pueden plegar en una sola fila El hacer clic en el cono 1 en la parte superior izquierda de una celda fusionada pliega las filas correspondientes en una sola entrada Las celdas en otras columnas que abarcan las filas plegadas que tienen valores id nticos se muestran sin ning n cambio Las celdas en otras columnas que abarcan las filas plegadas que tienen valores diferentes se resaltan y presentan el primer valor 31 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS Template Data x Template Data Smax_age Smin_age Scr HH E 25 E 20 AA m 5 i a le o 0 0 0 0 O0 O0 amp F 5 Save and close Add row Figura 4 16 Agrupamiento de celdas Cuando se altera el valor de una celda agrupada entonces tambi n se actualizan los valores de las celdas que se han plegado 4 3 10 2 DRL generado Aunque no es necesario los autores de reglas pueden ver el DRL que se generar para una plantilla de reglas y los datos asociados Esta funcionalidad y su operaci n no es diferente a la de otros activos Seleccione la Source y luego View Source de la pantalla del editor de activos Se puede ver el DRL ara todas las reglas 32 Capitulo 4 Concep
8. JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS z Description salience name age age i E w g Figura 4 13 Agrupamiento de celdas Cuando se altera el valor de una celda agrupada entonces tambi n se actualizan los valores de las celdas que se han plegado 4 3 9 6 Operaciones Otherwise Las columnas de condiciones definidas con valores literales que usan los operadores de igualdad o desigualdad pueden tomar ventaja del valor especial de la celda de la tabla de decisiones otherwise Este valor especial permite definir una regla que coincida con todos los valores no definidos expl citamente en todas las otras reglas definidas en la tabla Esto se ilustra mejor con un ejemplo when Cheese name not in Cheddar Edam Brie then end when Cheese name in Cheddar Edam Brie then end 4 3 10 Plantillas de reglas Las plantillas de reglas le permiten al usuario el definir una estructura de reglas con reservas de espacio para loa valores que se interpolan desde una tabla de datos Tambi n se puede seguir utilizando valores literales formulas y expresiones Las plantillas de reglas con frecuencia se pueden utilizar como una opci n para las tablas de decisiones Procedimiento 4 3 Creaci n de plantillas de reglas 1 Creaci n del activo de plantilllas de reglas Del men Knowledge Bases seleccione Create New y luego seleccione New Rule Template 26 Capitulo 4 Conce
9. acci n de borrar est habilitada para uno o m s archivos asociados del repositorio Guvnor Despu s 68 Cap tulo 10 Integraci n de JBoss Developer Studio de confirmar por medio de la ventana la acci n de borrar elimina los archivos en el repositorio Guvnor y borra los metadatos locales para la asociaci n del repositorio Guvnor Acci n de desconexi n La acci n de desconexi n est habilitada para uno o m s archivos asociados del repositorio Guvnor y borra los metadatos locales para la asociaci n del repositorio Guvnor Vista del historial de recursos Guvnor La vista del historial de recursos Guvnor muestra los detalles del historial de revisi n para los archivos seleccionados tanto locales como los que se encuentran en los repositorios Guvnor El estado inicial de esta vista es D Guvnor Resource History 3 Repository http localhost 8080 jboss brms org drools guvnor Guvnor Resource packages mortgages no NINJAs brl Revision Date Author Comment Figura 10 17 Historial La vista del historial de recursos Guvnor se llena por medio de las acciones Show History en el men de contexto Guvnor local o en el men de contexto para un archivo del repositorio Guvnor en el explorador del repositorio Guvnor Una vez que se realiza esta acci n la vista del historial de recursos Guvnor se actualiza para mostrar el historial de revisiones Repository http Mocalhost 8080 drools guvnor org drools guvnor Guvnor
10. brms rest packages mortgages source URL for package binary http localhost 8080 jboss brms rest packages mortgages binary URL for running tests http localhost 8080 iboss brms org drools guvnor Guvnor package mortgages LATEST SCENARIOS Change Set http localhost 8080 jboss brms org drools quvnor Guvnor package mortgages LATEST ChangeSet xml Model http localhost 8080 jboss brms org drools guvnor Guvnor package mortgages LATEST MODEL CIC Figura 4 23 Configuraci n de paquetes Una de las cosas m s importantes que tiene que hacer es configurar paquetes Esta tarea implica dos aspectos de la importaci n de clases que las reglas utilizan y luego definir variables globales Una vez que realiza un cambio es necesario guardarlo En ese momento el paquete est configurado y est listo para construir Por ejemplo puede agregar un modelo el cual tiene una clase llamada com something Hello Luego agregar a import com something Hello en su configuraci n de paquete y guardar a el cambio Build whole package gt Use built in selector gt Use custom selector Build binary package Build package Building a package will collect all the assets validate and compile into a deployable package Take snapshot Create snapshot for deployment Figura 4 24 Construcci n de paquetes Despu s de importar las clases del paquete y de definir sus variables globales se construye el paquete E
11. como objetos de hechos normales pero la manera de crearlos es diferente ya que no se encuentran en la ruta de clase de las aplicaciones Para crear estos objetos estan disponibles de la instancia KnowledgeBase Ejemplo 5 1 Manejo de tipos de hechos declarados por medio de la API obtienen una referencia a una base de conocimiento con un tipo declarado KnowledgeBase kbase obtiene el FactType declarado FactType personType kbase getFactType org drools examples Person maneja el tipo como sea necesario create instances Object bob personType newInstance establece los valores de los atributoss personType set bob name Bob DE personType set bob age 42 introduce el hecho en una session StatefulKnowledgeSession ksession ksession insert bob ksession fireAllRules lee los atributos String name personType get bob name int age personType get bob age El espacio de nombre del tipo declarado es el espacio de nombre del paquete en donde se declar es decir org drool1s examples en el ejemplo anterior 48 Capitulo 6 grupos de trabajo Capitulo 6 grupos de trabajo Los grupos de trabajo son una funcionalidad experimental disponible en BRMS 5 2 Los grupos de trabajo agrupan los hechos y definen restricciones comunes para ellos Los grupos de trabajo tambi n hacen posible el limitar las reglas que son visibles en el editor dirigido al escribi
12. cual los valores especificados por DSL provienen de un usuario y luego se presentar una casilla de modificaci n se parece a una forma Observe que esto es opcional y hay otro editor DSL A El editor dirigido actualmente no soporta el grupo completo de funcionalidades DSL Solo se soportan las secciones when y then de la configuraci n DSL El siguiente diagrama muestra las declaraciones DSL en acci n en el editor dirigido Save changes WHEN A template captures yajyes in a form style of input THEN Action sentence template options Figura 4 5 DSL en el editor dirigido 4 3 7 Reglas DSL Las reglas DSL son reglas textuales que utilizan un activo de configuraci n del lenguaje para controlar su apariencia when Policy has not been rejected There is a Driver age is atleast 30 has had exactly 0 prior claims then Approve Policy with the reason Driver is safe and mature 1872 Figura 4 6 Regla DSL Una regla DSL es una sola regla En la imagen anterior puede ver un editor de texto Puede utilizar los 21 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS iconos a la derecha para proporcionar listas de condiciones y acciones de las cuales escoger de otra manera presione las teclas control y espacio al mismo tiempo para que la lista aparezca 4 3 8 Hoja de c lculo de las tablas de decisi n Se pueden almacenar m ltiples reglas en una hoja de c lculo de Microsoft Exc
13. encuentren en ambos paquetes y en el Global Area Ser necesario importar de nuevo los activos modificados en el Global Area en los paquetes que los utilizan y borrar los activos importados anteriormente 5 2 Modelo JAR Procedimiento 5 1 Creaci n de un modelo Jar 1 Abra el men New model archive jar Del men Knowledge Bases seleccione Create New y luego seleccione Upload POJO Model JAR 44 Capitulo 5 El modelo de hechos el modelo de objetos JBoss BRMS Browse Find Knowledge Bases Name search Create New gt New Package 0 oa ES Packages New Spring Context wen coe AER New WorkingSet New Rule New Rule Template Upload POJO Model jar New Declarative Model New BPEL package 69 New Function New DSL R New RuleFlow AR New BPMN2 Process New Enumeration Y New Test Scenario Create a file amp Rebuild all package binaries 2 Creaci n de un activo modelo Jar Introduzca el nombre del modelo Jar la categor a y una descripci n Seleccione en que paquete crear el modelo o especifique que se debe agregar al Global Area Haga clic en OK cuando todos los detalles se han introducido New model archive jar x New model archive jar Create new 2 Import asset from global area Name Create in Package defaultPackage Y J Create in Global area Initial description ok 3 Carque la JAR en el activo 45 JBoss Enterprise BRMS Plat
14. http drools org drools 5 0 change set drools change set HO x SOM lt add gt lt resource source http localhost 9000 TEST pkg type PKG gt lt add gt lt change set gt El escaneo de recursos est habilitado por defecto Es un servicio y se debe iniciar y los mismo aplica para la notificaci n Esto se puede lograr por medio de ResourceFactory ResourceFactory getResourceChangeNotifierService start ResourceFactory getResourceChangeScamerService start Despu s se muestra la pantalla de implementaci n de la interfaz del usuario BRMS la cual proporciona las URLs y las descargas de los paquetes Navigate Find Snapshot TEST 9 Browse Viewing snapshot TEST EY Knowledge Bases For package mortgages Deployment URL click here to download binary or copy URL for deployment agent 2P QA Snapshot created on Tue 14 Apr 2009 12 58 09 PM EST Comment A Package snapshots Delete Copy Deploy v 3 EH mortgages Business rule assets Technical rule assets b Functions Bi Package snapshots E defaultPackage El mortgages TEST 2 DSL configurati ANOTHER ES configurations 30 Model ah Rule Flows geo Enumerations Y Test Scenarios P XML Properties Pf Other assets documentation Figura 8 1 Implementaci n de tomas de pantalla Puede ver la Package URI Esta es la URL que necesita incluir en el archivo change set xml para especificar que quiere este paquete Es
15. key ring o si no es v lida entonces el EGT le preguntar cuando tenga que acceder al respositorio Guvnor Guvnor Repository Log in E Guy Authentication required for repository http Aocalhost cal Password Save user name and password 2 OK Cancel Figura 10 5 Inicio de sesi n 61 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS Si la autenticaci n falla entonces el EGT volver a intentar una vez m s y luego emitir un error de fallo de autenticaci n Si reste error se presenta entonces puede volver a intentar la misma operaci n y brindar informaci n de autenticaci n diferente El EGT llama al repositorio Guvnor varias veces como cuando determina si hay actualizaciones de los recursos as que si utiliza autenticaci n de sesi n entonces la ventana de autenticaci n aparecer en momentos diferentes durante la sesi n de Eclipse dependiendo de las acciones que tome Para facilitar el uso recomendamos el guardar la informaci n de autenticaci n en la clave de Eclipse El archivo de clave de Eclipse es diferente de los archivos de claves que se encuentran en algunas plataformas tal como Mac OS X y muchas formas de Linux Por lo tanto algunas veces si accede un repositorio Guvnor por fuera del EGT los archivos de claves pueden des sincronizarse y se le pedir que se autentique en Eclipse Es una molesta pero sus credenciales usuales aplican aqu Una vez que se completa el asistente de conexi n Guvnor apa
16. la cual tiene un m todo getListOfAges el cual retorna una lista de cadenas y se encuentra en la ruta de clase Por supuesto que puede mezclar estas enumeraciones din micas con listas fijas Por ejemplo podr a cargarlas desde una base de datos usando JDBC Las enumeraciones de datos se cargan la primera vez que utilice el editor dirigido en una sesi n Si tiene alguna sesi n abierta del editor dirigido ser necesario que la cierre y vuelva a abrir la regla para poder ver el cambio Para verificar que la enumeraci n se ha cargado vaya a la pantalla de configuraci n del paquete Puede guardar y validar el paquete esto lo chequear y brindar cualquier comentario sobre los errores 4 3 15 Conceptos avanzados de enumeraci n Hay otras pocas tareas avanzadas que puede llevar acabo con enumeraciones de datos Listas desplegables dependientes de valores de campos Imag nese un modelo simple de hechos en el cual tiene una clase llamada Vehicle veh culo que tiene dos campos engineType y fuelType Quiere tener opciones para engineType de Petrol o Diesel Obviamente la opci n del combustible debe ser dependiente del tipo de m quina para gasolina tenemos ULP y PULP y para Diesel tenemos BIO y NORMAL Podemos expresar esta dependencia en una enumeraci n as Vehicle engineType Petrol Diesel Vehicle fuelType engineType Petrol ULP PULP Vehicle fuelType engineType Diesel BIO NORMAL Es
17. la misma columna haciendo clic en la primera y arrastrando el cursos o haciendo clic en la primera y haciendo clic sobre la extenci n del rango requerido presionando la tecla shift Opcionalmente se pueden utilizar las teclas para manejar el cursor y navegar en la tabla El presionar la tecla enter har que aparezca el editor correspondiente El rango se puede seleccionar presionando la tecla shift y extendiendo el rango con las teclas que mueven el cursor Se puede modificar el tama o de las columnas coloc ndose sobre el divisor correspondiente en el encabezado de la tabla El curso del rat n cambiar y luego se puede modificar el ancho de la columna para hacerla m s grande o m s peque a 22 Capitulo 4 Conceptos de BRMS Decision table HCondition columns Action columns options a Description salience age At 12345 30 E 40 12345 As Figura 4 8 Tabla de decisiones bu nie won i de de eb ooon 4 3 9 1 Componentes principales La tabla de decisiones se divide en dos secciones principales La secci n superior permite definir columnas de la tabla representando atributos de reglas meta datos condiciones y acciones La secci n inferior contiene la tabla en s en donde filas individuales definen reglas separadas Figura 4 9 Componentes principales 4 3 9 2 Configuraci n de columnas Las columnas pueden tener los siguientes tipos de restricci n Literal El valor en la celda s
18. las conexiones del repositorio Guvnor y estas se utilizan al crear nuevas conexiones La primera es una plantilla URL del repositorio Guvnor predeterminado la cual facilita crear m ltiples conexiones similares simplemente cambiando parte del campo tal como el nombre del host La segunda que por defecto se debe habilitar el guardar la informaci n de autenticaci n en la clave de la plataforma de Eclipse As como con la plantilla URL del repositorio Guvnor se puede determinar si el guardar una instancia especifica de la informaci n de autenticaci n en la clave de la plataforma Eclipse al crear la conexi n Es decir ambas preferencias son simplemente valores convenientes establecidos con valores predeterminados razonables Preferencias de decoraci n de recursos del repositorio Guvnor local La segunda categor a de preferencias que EGT proporciona se encarga de la manera en que se presenta la decoraci n de recursos locales asociados con recursos del repositorio Guvnor Ya que el repositorio Guvnor no es un substituto para SCM y ya que las herramientas SCM en Eclipse tienden a decorar recursos locales es til el poder controlar la manera en que EGT decora sus recursos locales para evitar conflictos con paquetes SCM En la secci n File Decoration de la p gina de preferencias puede seleccionar la ubicaci n superior izquierda o derecha o inferior izquierda o derecha del cono de decoraci n o puede escoger el no presentarla En la secci n
19. lo menos un modelo Este es para las reglas 38 Capitulo 4 Conceptos de BRMS JBoss BRMS Browse Find Knowledge Bases Name search Create New gt New Package wax a Packages gt New Spring Context sua Global Area New WorkingSet New Rule New Rule Template Upload POJO Model jar New Declarative Model New BPEL package 9 New Function New DSL R New RuleFlow AR New BPMN2 Process New Enumeration Y New Test Scenario amp Create afile amp Rebuild all package binaries Figura 4 22 Creaci n de nuevos activos Puede crear nuevas reglas o nuevos activos usando el explorador de paquetes Algunos activos s lo muestra los conos que inicial los asistentes para este prop sito 39 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS File Edit Source Status Attributes Edit Configuration Imported types Globals Advanced view de de ny i y y Category Rules 7 Validate configuration Build whole package 3 Use built in selector gt Use custom selector Build binary package Build package Building a package will collect all the assets validate and compile into a deployable package Take snapshot Create snapshot for deployment URL for package http localhost 8080 jboss documentation brms org drools guvnor Guvnor package mortgages LATEST documentation pdf URL for package source http localhost 8080 jboss
20. men de Mapa de caracteres escriba el nombre del car cter en el campo de B squeda y haga clic en Siguiente El car cter que busc ser resaltado en la Tabla de caracteres Haga doble clic en ese car cter resaltado para colocarlo en el campo de Texto a copiar y luego haga clic en el bot n Copiar Ahora regrese al documento y elija Modificar Pegar de la barra de men de gedit El texto anterior incluye nombres de aplicaci n nombres y elementos del men de todo el sistema nombres de men de aplicaciones espec ficas y botones y texto hallados dentro de una interfaz gr fica de usuario todos presentados en negrita proporcional y distinguibles por contexto It licas negrita monoespaciado o It licas negrita proporcional Ya sea negrita monoespaciado o negrita proporcional la adici n de italicas indica texto reemplazable o variable Las it licas denotan texto que usted no escribe literalmente o texto mostrado que cambia dependiendo de la circunstancia Por ejemplo Para conectar a una m quina remota utilizando ssh teclee ssh nombre de usuario0dominio nombre en un int rprete de comandos de shell Si la m quina remota es example com y su nombre de usuario en esa m quina es john teclee ssh john example com El comando mount o remount file system remonta el sistema de archivo llamado Por ejemplo para volver a montar el sistema de archivo home el comando es mount o remount home Para ver la versi n de un paquete actual
21. pagina del asistente le pide que escoja el repositorio Guvnor fuente y le da la opci n de crear una nueva conexi n del repositorio Guvnor en curo caso la segunda p gina es la mis ma que el asistente de conexi n de Guvnor descrito anteriormente Select Guvnor repository location Guv Select an existing Guvnor repository connection or create a new one O Create a new Guvnor repository connection Use an existing Guvnor repository connection http localhost 8080 jboss brms org drools guvnor Guvnor webdav o lt Back Next gt Finis Cancel Figura 10 19 Importaci n Una vez que se selecciona el repositorio Guvnor fuente el asistente le pide que escoja el recurso Select resources Select resources to copy from the Guvnor repository Guv Select resources v ohttp localhost 8080 jboss brms org drools guvnor Guvnor webda v packages v mortgages CheckBoxDsIRule brl Are they old enough scenario s MortgageModel model drl s No bankruptcies scenario e CreditApproval brl Good credit history only scenario lt Back Next gt Finish Cancel Figura 10 20 Importaci n Finalmente se escoge la ubicaci n destino en el espacio de trabajo local Capitulo 10 Integraci n de JBoss Developer Studio Select copy location Select the destination location Giy Select location mortgage gt amp guvnorinfo X gt amp bin gt src lt
22. un Fact field a una lista de valores Estos valores se utilizan para poblar una lista desplegable La lista puede ser literal o puede utilizar una clase de funcionalidad la cual pone en la ruta de clase para cargar las cadenas Las cadenas contienen un valor que se puede ver en un men desplegable o un mapeo desde el valor del c digo lo cual es lo que se termina utilizando en la regla y un valor de presentaci n vea el ejemplo a continuaci n que usa el Board type Short Long M Mini Boogie Person age 20 25 30 35 En la configuraci n de enumeraci n anterior la M indica un valor que se utilizar en la regla pero Mini es lo que se presenta en la interfaz gr fica del usuario Obtenci n de listas de datos de fuentes externas Es posible tener el c digo de llamada BRMS el cual cargar una lista de cadenas Para lograr esto necesitar un pedazo de c digo que retorne un java util List de cadenas que est en la ruta de 34 Capitulo 4 Conceptos de BRMS clase del BRMS En lugar de especificar una lista de valores en el BRMS mismo el c deigo puede retornar la lista de cadenas como siempre puede utilizar el signo dentro de las cadenas si quiere utilizar una valore de presentaci n diferente al valor de la regla Por ejemplo puede cambiar la l nea Person age as Person age new com yourco DataHelper getListOfAges Esto asume que tiene una clase llamada DataHelper
23. utilizando los valores literales las f rmulas y expresiones tal como en el editor dirigido est ndar Field value A e Field value Literal value _ Literal value O Template key Template key O Advanced options A formula _Newformula O Expression editor Expression editor O para la edad m xima del aplicante su edad m nima y su calificaci n de cr dito Las llaves de la plantilla se han definido como max_age min_age y cr respectivamente 28 Capitulo 4 Conceptos de BRMS Ejemplo 4 3 Plantilla de ejemplo File Edit Source Status Draft Attributes Edit Load Template Data WHEN There is an Applicant with a age less than _ max_age y a 1 age greater than or equal to xf min_age gt B UT creditRating equal to z Ser 2 There is a LoanApplication a Fig THEN 1 Modify value of LoanApplication a approved false vf a Fo show options Y 4 3 10 1 Definici n de datos de la plantilla Cuando complete la definici n de su plantilla de reglas necesita introducir los datos que se utilizar n para interpolar las reservas de espacio de la llave de la plantilla BRMS brinda la funcionalidad para introducir datos en una cuadr cula flexible dentro de la pantalla del editor dirigido El editor dirigido se puede iniciar presionando el bot n Load Template Data en la pantalla del editor dirigido La cuadr cula de datos de la plantilla de reglas es muy flexible con diferentes
24. webdav packages Resource JanotherPackage simpleRule dri Revision Date Author Comment 2008 07 15T15 37 34 john lt from webdav gt 2008 07 15T15 32 03 john 2008 07 15T10 28 35 john lt from webdav gt Figura 10 18 Historial Aqui vemos que el archivo simpleRule drl tiene tres revisiones Al hacer doble clic en una fila de revisi n o men de contexto Open Read only abre un editor de solo lectura en Eclipse con el contenido de la revisi n nota tambi n puede guardar con Save As cuando un archivo est abierto en un editor de s lo lectura para guardar una copia escribible local del contenido Sin embargo al hacer esto no se asociar el archivo creado con su fuente Guvnor 10 6 Importaci n de recursos del repositorio Guvnor Adem s del archivo de arrastre y suelte de la vista del explorador del repositorio Guvnor EGT tambi n incluye un asistente para copiar uno o m s archivos desde un repositorio Guvnor al espacio de trabajo local y establecer la asociaci n con el repositorio Guvnor Este asistente est disponible desde las opciones del men de Eclipse Import Guvnor Resource from Guvnor y Eclipse File New Other Guvnor Resource from Guvnor nota el asistentes es id ntico pero aparece en ambos lugares para 69 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS acomodar aquellos usuarios que tienden a ver esta funcionalidad como si estuviera en una sola categoria La primera
25. 1 Navegadores soportados 3 2 BRMS o Guvnor 3 3 Configuraci n inicial 3 4 Escritura de reglas 3 5 B squeda 3 6 Implementaci n Cap tulo 4 Conceptos de BRMS 0 ccc teens 4 1 Las reglas son activos 4 2 Categorizaci n 4 3 Autor a de reglas 4 3 1 El editor de activos 4 3 2 Reglas empresariales con el editor dirigido 4 3 3 Anatom a de una regla 4 3 4 Relevancia 4 3 5 Listas desplegables dirigidas por el usuario 4 3 6 Incremento con declaraciones DSL 4 3 7 Reglas DSL 4 3 8 Hoja de c lculo de las tablas de decisi n 4 3 9 tablas de decisi n dirigidas basadas en la web 4 3 9 1 Componentes principales 4 3 9 2 Configuraci n de columnas 4 3 9 2 1 Columnas de funcionalidades 4 3 9 2 2 Columnas de atributos 4 3 9 2 3 Columnas de meta datos 4 3 9 2 4 Columnas de condiciones 4 3 9 2 5 Columnas de acci n 4 3 9 3 Definici n de reglas 4 3 9 4 Fusi n de celdas 4 3 9 5 Agrupamiento de celdas 4 3 9 6 Operaciones Otherwise 4 3 10 Plantillas de reglas NOOOuAAAHA 00 N JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS 4 3 10 1 Definici n de datos de la plantilla 4 3 10 1 1 Fusi n de celdas 4 3 10 1 2 Agrupamiento de celdas 4 3 10 2 DRL generado 4 3 11 Flujo de reglas 4 3 12 Reglas t cnicas DRL 4 3 13 Funciones 4 3 14 Enumeraciones de datos Configuraciones de la lista desplegable 4 3 15 Conceptos avanzados de enumeraci n 4 4 Administr
26. 203 Se actulizaron los detalles para las bases de datos soportadas Revisi n 5 0 0 0 Mon 18 May 2009 Darrin Mison Creado para 5 0 0 75
27. B in the United States the European Union and other countries Node js is an official trademark of Joyent Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node js open source or commercial project The OpenStack Word Mark and OpenStack Logo are either registered trademarks service marks or trademarks service marks of the OpenStack Foundation in the United States and other countries and are used with the OpenStack Foundation s permission We are not affiliated with endorsed or sponsored by the OpenStack Foundation or the OpenStack community All other trademarks are the property of their respective owners Abstract Un manual para utilizar JBoss Enterprise BRMS Platform Table of Contents Prefacio hick 2 A ut A tt RD ce eee tk td eh het Ad Raed A sdk be 1 Convenciones del Documento 1 1 Convenciones tipogr ficas 1 2 Convenciones del documento 1 3 Notas y Advertencias 2 C mo obtener ayuda y hacer sus comentarios 2 1 Necesita ayuda 2 2 Necesitamos sus comentarios Cap tulo 1 Introducci n o ooccocccccc ene nees 1 1 Aspectos nuevos en esta edici n 1 2 Qu es un BRMS 1 3 Cu ndo se debe utilizar un BRMS 1 4 Qui n utiliza BRMS 1 5 Resumen de las funcionalidades Cap tulo 2 Arquitectura coso in A AAA 2 1 Componentes re utilizables 2 2 Versionamiento y almacenamiento Cap tulo 3 Manual de inicio r pido a an nnana aaua ccc 3
28. Description salience Person SP name age i p 0 1 1 Bil 30 o 2 2 o 3 3 G4 4 ajs 5 al so a a 7 7 Weed 40 e a a als 0 10 10 ou u olz 2 y A A Add row Otherwise Figura 4 11 Definici n de reglas 4 3 9 4 Fusi n de celdas El cono en la parte superior izquierda de la tabla de decisiones prende y apaga la fusi n de celdas Cuando las celdas se fusionan las que se encuentran en la misma columna con valores id nticos se fusionan en una sola celda Esto simplifica el cambio de valor de m ltiples celdas que compart an el nismo valor original Cuando las celdas se fusionan tambi n obtienen un cono en la parte superior izquierda de la celda que permite agrupar las filas que abarcan la celda fusionada Description salience name age age H is aji 1 Bill 30 El 12345 a gt oo d aj3 3 G 4 4 5 5 d B 6 6 Weed 40 El 12345 o A Figura 4 12 Fusi n de celdas 4 3 9 5 Agrupamiento de celdas Las celdas que se han fusionado se pueden plegar en una sola fila El hacer clic en el cono 1 en la parte superior izquierda de una celda fusionada pliega las filas correspondientes en una sola entrada Las celdas en otras columnas que abarcan las filas plegadas que tienen valores id nticos se muestran sin ning n cambio Las celdas en otras columnas que abarcan las filas plegadas que tienen valores diferentes se resaltan y presentan el primer valor 25
29. Figura 10 14 Comparaci n 67 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS Una vez que se escoge la revisi n entonces la acci n abre el editor de comparaci n de Eclipse s lo lectura Compare no NINJAs br 2 gt o Y Text Compare E Local no NINJAs brl krule gt lt rule gt lt name gt no NINJAs lt n lt name gt no NINJAs lt lt modelVersion gt 1 0 lt lt modelVersion gt 1 lt attributes gt lt attributes gt lt attribute gt lt attribute gt lt attributeName gt lt attributeNa lt value gt 10 lt valu lt value gt 10 lt v lt attribute gt lt attribute gt lt attributes gt lt attributes gt Figura 10 15 Comparaci n Este editor usa las t cnicas de comparaci n est ndares de Eclipse para mostrar las diferencias en las dos versiones En los casos en donde no hay diferencias el editor no abrir en lugar aparecer una ventana diciendo que no hay diferencias Cambio a la acci n de versi n La acci n de cambio de versi n est habilitada para un archivo asociado del repositorio Guvnor Primero la acci n de cambio de versi n le pide que seleccione una versi n Resource Versions Choose a version for no NINJAs brl pz Revision Date Author Comment h OK Cancel Figura 10 16 Versiones Una vez que se escoja la versi n la acci n de cambio de versi n reemplaza el contenido del archivo local con el de la revisi n seleccionada Acci n de borrar La
30. a continuaci n para obtener mayores detalles Por ejemplo aqu vemos que simpleRule drl est asociado con un recurso del repositorio Guvnor y la copia local se basa en la revisi n 3 con un sello de fecha 7 15 2008 15 37 34 Sin embargo el archivo deleteT est txt no est asociado con un archivo del repositorio Guvnor Puede encontrar mayores detalles sobre la asociaci n en la pagina de propiedades est ndar de Eclipse por medio de la opci n Properties del men de contexto ype filter text Guvnor ov Resource Repository http localhost 8080 jboss brms org drools guvnor Guvnor webdav FreeMarker Context Path packages mortgages no NINJAs brl Version 2008 10 02T07 32 16 Run Debug Settings Revision 4 X Restore Defaults Apply gt Figura 10 11 Propiedades El EGT contribuye una pagina de propiedades a la ventana de propiedades de Eclipse arriba puede ver su contenido Se puede ver el repositorio especifico Guvnor la ubicaci n dentro del repositorio la versi n fecha sello de fecha y el n mero de la revisi n 65 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS 10 5 Acciones para recursos locales Guvnor El EGT proporciona un n mero de acciones disponibles por medio del men de contexto de Guvnor en los archivos para trabajar con archivos ambos asociados con las copias maestras del repositorio Guvnor y las que no est n asociadas Las acciones son Actualizaci n Agre
31. a izquierda a la lista de la derecha Los tipos de hechos en la derecha estaran disponibles para el grupo de trabajo Find WorkingSets mortgages Working SetA File Edit Status Draft Attributes Edit WS Definition WS Constraints WS Custom Forms Available Facts WorkingSet Facts Applicant Bankruptcy IncomeSource LoanApplication gt lt 4 Agregar restricciones a los tipos de hechos en el grupo de trabajo Seleccione el Fact type del menu desplegable seleccione el valor Field y agregue la restricci n requerida Find Banking Set File Edit Status Draf Attributes Edit WS Definition WS Constraints WS Custom Forms Fact types Applicant v Field age Constraints Parameters Constraints Max value 100 RangeConstra nt T Min value 18 6 1 Verificaci n de restricciones de campos Las restricciones de campos se pueden verificar de dos maneras 50 Capitulo 6 grupos de trabajo Validaci n a demanda Validaci n en tiempo real La validaci n a demanda se realiza seleccionando verify de la barra de herramientas del editor dirigido Se ejecuta un reporte de verificaci n con los resultados de verificaci n La validaci n en tiempo real chequea posibles violaciones de restricciones de campos en tiempo real y marca las l neas en donde ocurrieron violaciones Para habilitar la verificaci n en tiempo real seleccione Administration luego Rules Verification y despu s selec
32. a pueden ser aut nomas contienen informaci n adicional 2 2 Versionamiento y almacenamiento En la base de datos se almacenan versiones de activos junto con los datos Cuando se crean tomas de pantalla se realizan copias de todo el paquete en un lugar separado en la base de datos JCR Para aquellos familiarizados con JCR y jackrabbit los archivos cnd se encuentran en la fuente para las definiciones de tipo de nodos ya que algunos desean verlas Un paquete es un folder y cada activo es un archivo un archivo puede ser textual o puede tener un anexo binario 11 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS Capitulo 3 Manual de inicio rapido Esta secci n proporcionar un tour rapido de funcionalidades de la plataforma JBoss Enterprise BRMS Se asume que la plataforma BRMS y su repositorio se encuentran instalados y configurados correctamente Welcome admin Sign Out Name search E Y Assets 7 7 Enter the name or part of a name Alternatively use the categories to browse 4 Find e A inbox O Incoming changes Find items with a name matching Include archived assets in results Search Recently Opened Recently Edited By Status Text search U sss By Category Search for Search Attribute search el Created by Format Subject Type External link Source Knowledge Bases PQA Package snapshots Description Last modified by Checkin comment Administ
33. abordado la administraci n de reglas Ahora aprenderemos sobre su uso en su aplicaci n Esta secci n aborda el uso del componente de implementaci n del agente de conocimiento que automatiza la mayor parte de este proceso por usted 8 1 El agente de conocimiento A y Importante El archivo README_DEPENDENCIES txt que se incluye en jboss brms engine zip contiene detalles espec ficos para las dependencias de cada componente El agente de conocimiento es un componente que est inclu do en la API de JBoss Rules 5 0 No se necesitan componentes adicional para usar el agente de conocimiento Si esta utilizando la plataforma JBoss Enterprise BRMS la aplicaci n s lo necesita inclu r las dependencias drools core en su ruta de clase es decir s lo las JARs drools y mvel No hay otras dependencias espec ficas de las reglas Tambi n hay una tarea ant drools ant de manera que pueda construir reglas como parte de un script ant y generar archivos pkg El escenario m s com n para esto en cuando las reglas se modifican en un IDE tal como JBoss Developer Studio sin usar la interfaz de usuario de BRMS Una vez que haya constru do sus reglas en un paquete en la plataforma BRMS o desde la tarea ant est listo para utilizar el agente en su aplicaci n destino El siguiente ejemplo construye un agente que construir una nueva KnowledgeBase desde los archivos especificados en la cadena de la ruta Sondear esos archivos cada 60 segundos el cua
34. aci n del estatus 4 5 Administraci n de paquetes 4 5 1 Importaci n de paquetes drl 4 6 Administraci n de versiones 4 7 Administraci n de implementaci n 4 8 Navegaci n del repositorio y ubicaci n de reglas Cap tulo 5 El modelo de hechos el modelo de objetos 5 1 El rea global 5 2 Modelo JAR 5 3 Modelo declarativo 5 3 1 Consumo de un modelo declarativo de Java Cap tulo 6 grupos de trabajo 6 1 Verificaci n de restricciones de campos Cap tulo 7 La perspectiva del usuario empresarial Cap tulo 8 Integraci n de reglas con sus aplicaciones 8 1 El agente de conocimiento 8 2 Implementaci n manual 8 3 WebDAV 8 3 1 WebDav y caracteres especiales 8 4 URLs Cap tulo 9 Buz n de entrada y comentarios 9 1 Comentarios 9 2 Buz n de entrada Cap tulo 10 Integraci n de JBoss Developer Studio 10 1 Sinopsis de las funcionalidades 10 2 Asistente de conexi n Guvnor 10 3 Explorador del repositorio Guvnor 10 4 Copias locales de archivos Guvnor 10 5 Acciones para recursos locales Guvnor 10 6 Importaci n de recursos del repositorio Guvnor 10 7 Preferencias plug in de Guvnor Cap tulo 11 Configuraci n de clientes para la firma de paquetes de reglas Historial d revisiones a a 29 30 31 32 33 33 34 34 35 36 37 40 41 41 42 44 44 46 47 50 52 53 53 54 55 55 55 57 57 57 59 59 60 62 64 66 69 71 Table of Contents JBoss Enterprise BRMS Platform 5 Manual
35. acteres especiales en nombres de reglas sin embargo si se utilizan caracteres especiales entonces el Web Connector se debe cambiar para que soporte Unicode Para agregar soporte para Unicode complete los siguientes pasos Procedimiento 8 1 Agregue soporte Unicode 1 Detenga el servidor de aplicaciones 2 Abra el archivo server xm1 Este archivo se encuentra en el directorio jbossweb sar 3 Agregue URIEncoding UTF 8 al conector web Por ejemplo para el c digo HTTP el c digo debe ser el siguiente lt Connector protocol HTTP 1 1 port 8080 address jboss bind address connectionTimeout 20000 redirectPort 8443 URIEncoding UTF 8 gt 4 Inicie el servidor de aplicaciones 8 4 URLS La URL de implementaci n del paquete mencionada en la secci n sobre el agente de conocimiento tambi n tiene otras funcionalidades Para obtener el DRL generado para ese paquete en lugar del paquete binario agregue drl al final de 55 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS podra ver el DRL generado para ese objeto incluso si no es un archivo DRL tal como package testPDSGetPackage LATEST SomeFile drl 56 Capitulo 9 Buz n de entrada y comentarios Cap tulo 9 Buz n de entrada y comentarios Importante Disponible s lo en JBoss Enterprise BRMS Platform versi n 5 1 0 y posteriores Las funcionalidades del buz n de entrada y los comentarios ayudan a los usuarios a administrar cambios en los objeto
36. ages Bankruptcy history knowledge Bases File Edit Source tas Oran Create New gt 7 Attributes Edit est Packages WHEN e defaultPackage 1 There is a LoanApplication a Fig Y mortgages The following exists Business rule assets There is a Bankruptcy with o e Technical rule assets any of the following 2 O O Functions yearOfOccurrence greater than 7 1990 0 y o 2 amountOwed greater than y 10000 Cy DSL configurations gretertia Ra Model THEN A Processes Set value of LoanApplication a approved 1 e Enumerations Set value of LoanApplication a explanation een bankrupt o Y Test Scenarios e 2 Retract LoanApplication a o ig show XML Properties options amp other assets documentation om WorkingSets td SpringContext s Global Area Figura 4 4 Vista del editor de activos 4 3 2 Reglas empresariales con el editor dirigido Al modificar reglas el editor de activos tambi n se conoce como el editor dirigido El editor dirigido se utiliza para modificar reglas en el formato del lenguaje de reglas empresariales BRL del ingl s Business Rules Language El editor dirigido le pide a los usuarios entradas con base en el modelo de objetos de la regla que se est modificando El acceso al paquete se debe configurar antes de poder utilizar el editor dirigido BRL 17 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS Yambi n hay un editor dirigido que se encuentra
37. apitulo 4 Conceptos de BRMS De manera opuesta a las categorias los activos solo pueden tener un estatus a la vez El uso de los estatus es completamente opcional Puede utilizar los estatus o las categor as para administrar el ciclo de vida de los activos x E change status Change status Cancel Figura 4 20 Estatus de los activos El diagrama anterior presenta un cambio en el estatus de un activo individual El cambio tiene efecto de manera inmediata y no se necesitar guardar por separado Tambi n puede cambiar el estatus de un paquete completo Esto establece la etiqueta del estatus en el paquete mismo y en todos los activos que pertenecen al mismo valor 4 5 Administraci n de paquetes En el BRMS tiene una base de conocimiento la cual contendr uno o m s paquetes de conocimiento En la interfaz del usuario los paquetes de conocimeinto con frecuencia se conocen simplemente como paquetes El configurar paquetes de conocimeinto usualmente es una tarea que s lamente se lleva a cabo una sola vez y que la realiza alguien con experiencia en desarrollo de reglas y modelos Muy pocas personas necesitar n configurar los paquetes de conocimiento y una vez que est n listos se pueden copiar sucesivamente si es necesario La configuraci n de paquetes es definitivamente una tarea t cnica que requiere experiencia con el desarrollo de reglas Todos los activos viven en paquetes en el BRMS Un paquete es como un sub direc
38. cionar un archivo en el repositorio Guvnor hace que la vista de propiedades de Eclipse se actualice con los detalles de ese archivo 62 Cap tulo 10 Integraci n de JBoss Developer Studio Properties x Bj BY oO Property Value Created 2009 09 07T04 21 51Z Last Modified 2008 10 02T07 32 16 Location packages mortgages no NINJAs brl Name no NINJAs brl Revision 4 Type file Figura 10 7 Propiedades El hacer doble clic en una carpeta directorio en el rbol har que ese directorio se expanda si est plegado o viceversa El hacer doble clic en un archivo en el rbol har que se abr un editor de s lo lectura en Eclipse mostrando el contenido de ese archivo Q no NINJAs brl Read 2 gt p Guided rule editor WHEN ra LoanApplication app x There is no x IncomeSource X THEN ri approved false a Set app X explanation no NINJAs Retract app x options ry salience 10 a Rule Builder BRL Source Generated DRL read only Figura 10 8 Contenido de archivos 63 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS 4 no NINJAs brl Read amp 3 H krule gt lt name gt no NINJAs lt name gt lt modelVersion gt 1 0 lt modelVersion gt lt attributes gt lt attribute gt lt attributeName gt salience lt attributeNa lt value gt 10 lt value gt lt attribute gt lt attributes gt lt lhs gt lt fact gt lt factType gt LoanApplication lt fac
39. cione la casilla Enable Esta es una funcionalidad experimental y est inhabilitada por defecto 51 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS Capitulo 7 La perspectiva del usuario empresarial Para los usuarios empresariales los formatos de reglas mas apropiados a utilizarse son los derivados al utilizar el editor dirigido las tablas de decisi n y las reglas DSL Tambi n puede utilizar algunas expresiones DSL en el editor dirigido de manera que proporcione formas en las que se pueden introducir valores Puede utilizar categor as para aislar reglas y activos de los usuarios no t cnicos S lo aparecer n los activos que se han asignado a una categor a en la vista Categorias Un desarrollador o persona t cnica tendr que realizar la configuraci n inicial de la plataforma BRMS Esta persona establecer los fundamentos para todas las reglas Tambi n puede crear plantillas las cuales son reglas que se pueden copiar usualmente se encuentran en un paquete ficticio bajo la categor a de plantilla Puede llegar a ser til el utilizar plantillas Los usuarios no t cnicos tampoco deben llevar a cabo la implementaci n Como lo mencionamos anteriormente en este manual las implementaciones se llevan acabo por medio del sistema paquetes 52 Cap tulo 8 Integraci n de reglas con sus aplicaciones Cap tulo 8 Integraci n de reglas con sus aplicaciones Hasta este momento el manual ha
40. d de datos Dicha cantidad no se podr a cargar En lugar las listas se podr an cargar dependiendo del pa s que se selecciona Esta situaci n se puede abordar de la siguiente manera Fact field dependentField1 dependentField2 new com yourco DataHelper getListOfAges dependentField1 dependentField2 Observe que solo se han especificado los campos que se necesitan Tambi n a la derecha del signo hay comillas alrededor de la expresi n Esta expresi n se evaluar solo cuando se necesite Cuando lo hace substituir los valores de los campos especificados Esto significa que puede utilizar los valores de los campos de la interfaz gr fica del usuario para dirigir una petici n a la base de datos y profundizar en los datos etc Cuando se carga la lista desplegable de reglas la lista se refrescar con base en esos campos depenentField1 y dependentField2 son nombres de campos en el tipo Fact Se utilizan para calcular la lista de valores que se van a ver en una lista desplegable como valores para el campo 4 4 Administraci n del estatus Cada activo y paquete en el BRMS tiene una etiqueta de estatus establecida Los valores para la configuraci n de etiquetas de estatus se encuentran en la secci n Administraci n del BRMS Aqu puede agregar sus propios nombres de estatus De manera similar a las categor as los estatus NO afectan la ejecuci n de ninguna manera S lo proporcionan informaci n 36 C
41. del usuario de BRMS File Edit Source Navigate Search Project Run Window Help Civ la S 4 a iv D Or E M GuvnorRe gt Seam I Guvnor Repositories 23 0 Q Samp Read onl 20 Project Explorer _ Navigator O x gt package com sample B Y a http 10 64 1 215 8080 jboss brm sH import com sample Message Y StestProject Y packages Y src mainjava rule Hello World D defaultPackage when D Ey com sample Y mortgages ae Message status Message HELLO Y 2 src main rules AgeCheck dsir System out println message Y com sample ApplicantDs ds m setMessage Goodbye cruel world Sample dri 5 2009 05 12T14 45 m setStatus Message GOODBYE Are they old enough scer update m D m JRE System Library java 1 5 0 sun 1 Bankruptcy historybrl end D BA Drools Library CheckBoxDsIRule brl rule GoodBye b src CreditApproval brl whel Message status Message GOODBYE credit ratings enumeratior then drools package System out printin message end Dummy rule drl Good credit history only sc 1 TM Mi E prigageModelmiode del Text Editor Rete Teel gt NINJAs scenario J Guvnor Resource History 23 gt Problems El Console Sm Repository http 10 64 1 215 8080 jboss brms org drools guvnor Guvnor webdav
42. del usuario de BRMS Prefacio 1 Convenciones del Documento Este manual utiliza varias convenciones para resaltar algunas palabras y frases y llamar la atenci n sobre ciertas partes espec ficas de informaci n Liberation Fonts tambi n se utilizan en ediciones de HT ML si est n instalados en su sistema Si no se muestran tipograf as alternativas pero equivalentes Nota Red Hat Enterprise Linux 5 y siguientes incluyen Liberation Fonts predeterminadas 1 1 Convenciones tipogr ficas Se utilizan cuatro convenciones tipogr ficas para llamar la atenci n sobre palabras o frases espec ficas Dichas convenciones y las circunstancias en que se aplican son las siguientes Negrita monoespaciado Utilizado para resaltar la entrada del sistema incluyendo los comandos de shell nombres de archivos y rutas Tambi n sirve para resaltar teclas y combinaciones de teclas Por ejemplo Para ver el contenido del archivo my_next_bestselling_novel en su directorio actual de trabajo escriba el comando cat my_next_bestselling_novel en el int rprete de comandos de shell y pulse Enter para ejecutar el comando El ejemplo anterior incluye un nombre de archivo un comando de shell y una tecla Todo se presenta en negrita monoespaciado y distinguible gracias al contexto Las combinaciones de teclas se pueden distinguir de las individuales con el signo m s que conecta cada partee de la combinaci n de tecla Por ejemplo Pulse Enter para ejecutar
43. delo de hechos el modelo de objetos New declarative model using guided editor x lt gt New declarative model using guided editor Create new 2 Import asset from global area e Create in Package defaultPackage Y J Create in Global area Initial description ok 3 Defina el modelo Haga clic en Add new fact type e introduzca el nombre del hecho en el campo name del men emergente Find MyPojoModel MyDeclarativeModel File Edit Source Status Draft Attributes Edit SF Add new fact type 4 Agregar campos de hechos Cree campos de hechos seleccionando el bot n Add field e introduciendo la informaci n en el men emergente Type java math BigDecimal Decimal number z ok x 5 Agregar anotaciones Cree anotaciones de hechos seleccionando el bot n Add annotation Los campos Name y Value de las anotaciones son obligatorios pero el campo Key es opcional Si no se especifica un valor Key entonces se asigna un valor predeterminado value os Name Key Value OK 5 3 1 Consumo de un modelo declarativo de Java Los tipos declarados se generan en el momento de la compilaci n de la base de conocimiento y como tal la aplicaci n s lo tendr acceso a estos en tiempo de ejecuci n de la aplicaci n Por lo tanto estas clases no est n disponibles para referencia directa de la aplicaci n 47 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS Los tipos declarativos se pueden usar
44. e 8 3 WebDAV El repositorio de segundo palno tambi n se puede acceder por medio de WebDav WebDAV es una interfaz de programaci n de aplicaciones del sistema de archivos basado en HTTP La mayor a de los sistemas operativos modernos incluyendo Microsoft Windows Apple MacOS X y Linux proporcionan soporte integrado para acceder WebDav Consulte la documentaci n de su sistema operativo para ver las instrucciones de configuraci n Tambi n hay muchos clientes WebDav de terceros disponibles para la mayor a de las plataformas La URL para acceder su repositorio usando WebDav es casi la misma que la de la interfaz web Simplemente reemplace Guvnor htm1 al final con webdav as como lo muestra este ejemplo http localhost 8080 jboss brms org drools guvnor Guvnor webdav Se requiere autenticaci n como siempre WebDav proporciona un directorio de paquetes y tomas de pantalla El directorio Snapshots es de s lo lectura y es esencialmente una vista de las tomas de pantalla creadas de los paquetes de conocimiento El directorio de paquetes contiene una lista de paquetes de conocimiento en el repositorio como directorios que a su vez contienen los activos individuales como archivos 8 3 1 WebDav y caracteres especiales BRMS soporta caracteres UT F 8 como parte de los nombres de las reglas sin embargo cuando las reglas se copian por medio de WebDav los caracteres multibyte se decodifican como ISO 8859 1 Red Hat no recomienda el usar car
45. e activo el bot n The view above shows the Category Editor Viewer that is seen when you open an asset In this example you can see the asset belongs to two categories This means that when either category is used to show a list of assets you will see that asset The y el cnono de la basura se utiliza para agregar y borrar cosas adicionales respectivamente En el ejemplo anterior la primera categor a Home se encuentra en el nivel superior La segunda Mortage Eligibility todav a es una sola categor a pero est anidada ya que las categorias son jer rquicas En otras palabras hay una categor a llamada Mortage la cual contiene una categor a llamada Eligibility La pantalla lo muestra como Mortage Eligibility Como lo puede ver es an logo a la estructura del directorio que tiene en el sistema de archivos de su disco duro aunque las reglas pueden aparecer en m ltiples lugares Cuando abre un activo con el fin de verlo o editarlo ver una lista de categor as a las cuales pertenece Si realiza un cambio borrar o agregar una categor a ser necesario que guarde el activo y esta acci n crear un nuevo objeto en le historial de versiones El cambio de categor as de una regla no afecta su ejecuci n Create new category under Rome Mortgage Eligibility rules Category name oK Figura 4 3 Creaci n de categor as La vista anterior muestra la pantalla de administraci n para la creaci n de categor as No
46. e cada paquete El certificado p blico se hace disponible para cada aplicaci n cliente en un almac n de llaves conocido como almac n de confianza El certificado en el almac n de confianza se utiliza para verificar la autenticidad de los paquetes firmados Los paquetes de reglas que est n corruptos o que se han modificado durante la descarga ser n rechanzados por el cliente ya que la firma ya no coincidir con el certificado El procedimiento a continuaci n describe el proceso de configuraci n de aplicaciones cliente para la firma de paquetes de reglas Esto implica el configurar varias propiedades en el cliente Las propiedades se puede establecer program ticamente usando el m todo System setProperty La clase org drools core util KeyStoreHelper contiene varias constantes que representan estas propiedades Antes de realizar esta tarea necesita Un servidor JBoss Enterprise BRMS Platform ya instalado y configurado correctamente para la firma de paquetes de reglas La URL para el almac n de confianza que contiene el certificado digital que el servidor JBoss Enterprise BRMS Platform utiliza La contrase a para el almac n de confianza si hay una establecida Procedimiento 11 1 Configuraci n de clientes para la firma de paquetes de reglas 1 Habilitar la firma Configure la propiedad drools serialization sign como true System setProperty KeyStoreHelper PROP_SIGN true 2 Configure la URL TrustStore Configure la
47. e comparar con el campo utilizando el operador Formula La expresio en la celda se evaluar y luego se comparar con el campo Predicado No se necesita ning n campo la expresi n se evaluar como verdadera o falsa Puede establecer un valor predeterminado pero normalmente si no hay un valor en la celda entonces esa restricci n no aplica 23 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS Decision table Condition columns a Yname 2 Page New column Action columns a Jage F New column options Add Attribute Metadata op Attributes Bsalience y Use row number 7 Reverse order Default value 0 Hide this column Figura 4 10 Configuraci n de columnas 4 3 9 2 1 Columnas de funcionalidades Por defecto se proporcionan dos columnas que contienen el n mero de la regla y la descripci n 4 3 9 2 2 Columnas de atributos Se pueden agregar cero o m s columnas de atributos que representan cualquiera de los atributos de reglas DRL Se brinda un pseudo atributo adicional en el editor de la tabla dirigida de decisiones para negar una regla Este atributo permite negar reglas completas Por ejemplo como se puede ver la siguiente regla simple se puede negar when c Cheese name Cheddar then end when not Cheese name Cheddar then end 4 3 9 2 3 Columnas de meta datos Se pueden definir cero o m s columnas de meta datos cada una representa la anotac
48. e de Red Hat y tecnolog a Encontrar un listado de las listas de correo disponibles al p blico en para acceder a los archivos de listados 2 2 Necesitamos sus comentarios Si encuentra algun error o si se le ocurre una manera de mejorar este manual nos encantar a escuchar sus sugerencias Complete un reporte en Bugzilla frente al producto JBoss Enterprise BRMS Platform 5 y el componente doc BRMS_User_Guide El siguiente enlace le llevar a un reporte de Llene la siguiente plantilla en el campo de Description de Bugzilla Sea tan especifico como le sea posible al describir el problema esto ayudar a asegurarnos de que lo podemos solucionar r pidamente URL del documento N mero de la secci n y nombre Describa el problema Sugerencias para mejorar Informaci n adicional Aseg rese de darnos su nombre para poder darle todo el cr dito por reportar el problema JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS Capitulo 1 Introduccion 1 1 Aspectos nuevos en esta edici n Tabla 1 1 Aspectos nuevos en esta edici n Funcionalidad Cambio Se agregaron detalles adicionales sobre las tablas de decisiones Se agreg una secci n sobre las plantillas de reglas Se agreg informaci n adicional sobre el modelo de hechos Se agreg un nuevo cap tulo sobre los grupos de trabajo Se agregaron instrucciones para utilizar caracteres multibyte en toda la WebDAV 1 2 Qu es un BRMS JB
49. e del nombre de un activo tambi n puede usar el Quick Find Para utilizarlo empiece a escribir el nombre de la regla y BRMS retornar una lista de coincidencias mientras escribe 3 6 Implementaci n Despu s de modificar algunas reglas en un paquete puede hacer clic en la funcionalidad Package abra el paquete que desee y constr yalo Si el proceso de construcci n tiene xito podr descargar un archivo de paquete binario el cual luego se puede implementar en un sistema en tiempo de ejecuci n Tambi n puede realizar una toma de pantalla de un paquete para la implementaci n Esto congela el paquete en ese justo momento de manera que ninguno de los cambios actuales no lo afectan Esto tambi n hace disponible el paquete en una URL de la siguiente forma http lt your server gt jboss brms org drools guvnor Guvnor packages lt packageName gt lt snapshotName gt 14 Capitulo 4 Conceptos de BRMS Capitulo 4 Conceptos de BRMS 4 1 Las reglas son activos Un activo es cualquier cosa que se pueda almacenar como una versi n en el repositorio Esto incluye reglas tablas de decisi n modelos pruebas y DSLs El t rmino regla con frecuencia se utiliza muy vagamente A veces se utiliza incorrectamente para referirse a activos que de hecho no son reglas 4 2 Categorizaci n Boss BRMS Browse Create New gt a Y Assets Find Y inbox a E By status sea By Category Home Mortgage
50. eate System out println Created Echo System out println Echo echo Hello echo echo Hello 1 3 Notas y Advertencias Finalmente utilizamos tres estilos visuales para llamar la atenci n sobre la informaci n que de otro modo se podr a pasar por alto Una nota es una sugerencia atajo o enfoque alternativo para una tarea determinada Ignorar una nota no deber a tener consecuencias negativas pero podr a perderse de algunos trucos que pueden facilitarle las cosas Importante Los cuadros con el t tulo de importante dan detalles de cosas que se pueden pasar por alto f cilmente cambios de configuraci n nicamente aplicables a la sesi n actual o servicios que necesitan reiniciarse antes de que se aplique una actualizaci n Ignorar estos cuadros no ocasionar p rdida de datos pero puede causar enfado y frustraci n Las advertencias no deben ignorarse Ignorarlas muy probablemente ocasionar p rdida de datos 2 C mo obtener ayuda y hacer sus comentarios 2 1 Necesita ayuda Si encuentra dificultades con alguno de los procedimientos descritos en este documento visite el Portal Oo Prefacio buscar o navegar a trav s de la base de art culos de soporte t cnico sobre productos de Red Hat enviar un caso de soporte a Servicios de Soporte Global de Red Hat GSS acceder a otra documentaci n del producto Red Hat alberga una lista grande de correos electr nicos para discutir sobre softwar
51. editores emergentes para los tipos de datos de los campos subyacentes Se puede modificar el tama o de las columnas y tambi n se pueden organizar y las celdas se pueden fusiinar y agrupar para facilitar la entrada r pida de datos Una fila de datos interpola las reservas de espacio Template Key para una sola regla de tal manera que una fila se convierte en una regla Si se dejan celdas en blanco entonces no se genera la regla para la fila aplicable 29 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS Template Data x Template Data Smax_age Smin_age Scr HIH a 25 20 AA 5 25 20 OK a 25 20 Sub prime 35 25 AA dp a 35 25 OK a 35 25 Sub prime a 45 35 AA dh 0 45 35 OK dh a 45 35 Sub prime Save and close Add row Figura 4 14 Plantilla de la cuadr cula de datos 4 3 10 1 1 Fusi n de celdas El cono en la parte superior izquierda de la cuadr cula prende y apaga la fusi n de celdas Cuando las celdas se fusionan las que se encuentran en la misma columna con valores id nticos se fusionan en una sola celda Esto simplifica el cambio de valor de m ltiples celdas que compart an el mismo valor original Cuando las celdas se fusionan tambi n obtienen un cono en la parte superior izquierda de la celda que permite agrupar las filas que abarcan la celda fusionada 30 Capitulo 4 Conceptos de BRMS Template Data x Template Data HH Smax_age Smin_age Scr aja 25 E 20 AA
52. el con formato de archivo X1s por medio del cual cada fila representa una regla Los detalles de la hoja de c lculo no los abordamos en este cap tulo o at Upload new version Browse Upload Download current version Download This is a decision table in a spreadsheet XLS Typically they contain many rules in one sheet View source Validate Figura 4 7 Tabla de decisiones en la hoja de c lculo misma ventana Con el fin de crear una nueva tabla de decisiones debe iniciar el Rule Wizard el asistente de reglas el cual contiene una opci n para este procedimiento y luego puede cargar el archivo xls 4 3 9 tablas de decisi n dirigidas basadas en la web La funcionalidad de las tablas de decisiones dirigidas permite modificar las tablas de decisiones en la web Esto funciona de manera similar al editor dirigido realizando una introspecci n de los hechos y campos disponibles para dirigir la creaci n de una tabla de decisiones Se pueden definir atributos de reglas meta datos condiciones y acciones en una formato tabular lo cual facilita la entrada r pida de grupos grandes de reglas relacionadas Las reglas de las tablas de decisiones basadas en la web se compilan en DRL como todos los otros activos de reglas Las celdas se pueden seleccionar de varias maneras Se puede hacer doble clic en celdas individuales y aparece un editor correspondiente la tipo de datos subyacente Se pueden seleccionar grupos de celdas en
53. el comando Pulse Ctr1 A1t F2 para pasar a una terminal virtual El primer ejemplo resalta una tecla particular a pulsar El segundo ejemplo resalta una combinaci n de teclas un set de tres teclas pulsadas simult neamente Si se discute el c digo fuente los nombres de las clase los m todos las funciones los nombres de variables y valores de retorno mencionados dentro de un p rrafo ser n presentados en Negrita monoespaciado Por ejemplo Las clases de archivo relacionadas incluyen filename para sistema de archivos file para archivos y dir para directorios Cada clase tiene su propio conjunto asociado de permisos Negrita proporcional Esta denota palabras o frases encontradas en un sistema incluyendo nombres de aplicaci n texto de cuadro de di logo botones etiquetados etiquetas de cajilla de verificaci n y bot n de radio t tulos de men y t tulos del submen Por ejemplo Seleccione Sistema Preferencias gt Rat n desde la barra del men principal para lanzar Preferencias de rat n En la pesta a de Botones seleccione la cajilla de rat n Prefacio de mano izquierda y luego haga clic en Cerrar para cambiar el bot n principal del rat n de la izquierda a la derecha adecuando el rat n para la mano izquierda Para insertar un car cter especial en un archivo gedit seleccione Aplicaciones Accesorios gt Mapa de caracteres de la barra del men Luego seleccione B squeda gt Buscar de la barra del
54. el logo de la cabecera y posteriormente introducir el nombre Tambi n tendr que escoger una categor a Las categor as proporcionan una manera de ver las reglas separado de los paquetes de conocimiento de hecho puede hacer que las reglas aparezcan en m ltiples paquetes de conocimiento Puede que le sea til el considerarlo como una etiqueta Seleccione los formatos Business Rule Guided Editor Esto abrir un modelador de reglas el cual es un editor dirigido Puede agregar y modificar condiciones y acciones con base en el modelo que se est utilizando en el paquete actual Tambi n estar disponible cualquier plantilla de oraciones DSL configurada para el paquete Cuando haya terminado de modificar las reglas puede guardar los cambios o tambi n puede escoger el validar o ver fuente para la fuente efectiva Tambi n puede agregar o borrar categorias del editor de reglas y puede modificar otros atributos tal como la documentaci n si no est seguro de qu hacer entonces escriba un documento con lenguaje normal que describa la regla y gu rdelo Despu s lo puede utilizar como una plantilla 3 5 B squeda Con el fin de navegar en el sistema puede utilizar la funcionalidad de las reglas la cual muestra las 13 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS cosas agrupadas por categor as o puede utilizar la funcionalidad para paquetes y ver por paquetes o tipo de reglas Si conoce el nombre o part
55. el repositorio Guvnor de destino y le da la opci n de crear una nueva conexi n del repositorio Guvnor en cuyo caso la segunda p gina es la misma del asistente de conexiones de Guvnor que describimos anteriormente Una vez seleccione el repositorio Guvnor de destino el asistente le pide la ubicaci n de la carpeta para agregar los archivos seleccionados Select folder h Select the target folder in the Guvnor repository Select folder v http localhost 8080 jboss brms org drools guvnor Guvnor webdav v packages CheckBoxDsIRule brl Are they old enough scenario MortgageModel model drl No bankruptcies scenario CreditApproval brl O lt Back Finish Cancel Figura 10 13 Agregar acci n Aqu seleccion la carpeta mortages como el destino El hacer clic en Finish agrega los archivos seleccionados al repositorio Guvnor y crea una asociaci n entre los archivos locales y los del repositorio Guvnor El asistente no le permitir sobreescribir archivos existentes del repositorio Guvnor al agregar nuevos archivos Compare con la acci n de versi n La acci n de comparaci n con versi n est habilitada para un archivo asociado del repositorio Guvnor Esta acci n primero abre un asistente que le pide la versi n para realizar la comparaci n con el contenido del archivo local Resource Versions Choose a version for no NINJAs brl Revision Date Author Comment III X OK Cancel
56. empresariales que se deben administrar de manera opuesta a las reglas Cap tulo 1 Introducci n t cnicas que ser n parte de una aplicaci n 1 4 Qui n utiliza BRMS Las siguientes personas con los siguientes cargos en su empresa son principalmente los que utilizar n el sistema de administraci n de las reglas empresariales Analistas empresariales Expertos en reglas Desarrolladores Administradores de reglas JBoss Enterprise BRMS Platform permite asignar diferentes roles a diferentes usuarios para controlar los activos y las funcionalidades que se exponen 1 5 Resumen de las funcionalidades El soporte para m ltiples idiomas en la interfaz de usuario web BRMS actualmente es ingl s de Estados Unidos japon s y chino simplificado Varios tipos de editores de reglas gr fico y basado en texto Control de versiones para activos hist ricos Categorizaci n Construcci n e implementaci n Almacenar m ltiples activos de reglas como un solo paquete JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS Capitulo 2 Arquitectura Este cap tulo cubre los aspectos t cnicos del dise o de la plataforma de JBoss Enterprise BRMS No es una lectura obligatoria para los usuarios de la aplicaci n BRMS Esta dirigido a los desarrolladores que integran la plataforma JBoss Enterprise BRMS con otros sistemas en que se integran y se implementan O Client Browser Application Server User Applications BRMS A
57. en el plug in de Eclipse La mayoria de los detalles en esta secci n tambi n aplican Ejemplo 4 1 El editor dirigido WHEN 1 There is a LoanApplication application Fig There is an Applicant with 5 2 age less than Y 21 0 95 THEN o Set value of LoanApplication application approved false v gt f 1 95 Set value of LoanApplication application explanation Underage gt 2 Retract LoanApplication application o LG show options 4 3 3 Anatom a de una regla Una regla tiene m ltiples partes When gt Then La parte Then de la regla es la acci n que se va a realizar cuando se ha cumplido con la parte es Then decline the loan because the applicant is under age Con el editor dirigido es posible agregar m s condiciones al When o la parte condicional de la regla y se pueden a adir m s acciones al Then o acci n de la regla Por ejemplo si un candidato menor de 21 a os tuviera un fiador para una aplicaci n de pr stamo es posible que el banco decida aprobar la modificar el When para incluir la condici n del fiador Ejemplo 4 2 Modificaci n de reglas File Edit Source Status Draft Attributes Edit WHEN E 1 There is a LoanApplication application There is an Applicant with all of the following 2 age less than Y 21 9 o 05 guarantor equal to Y false y0 THEN op a Set value of LoanApplication application approved false y o al L F237 Set value of LoanApplicati
58. ew Guvnor repository connection Location localhost Port 8080 Repository jboss brms org drools guvnor Guvnor webdav User Name Password Y Save user name and password NOTE Saved passwords are stored on your computer in a file that is difficult but not impossible for an intruder to read Figura 10 4 Asistente de conexi n Los valores predeterminados aparecen en los campos de ubicaci n puerto y repositorio consulte la secci n Preferencias para Guvnor a continuaci n para obtener mayores detalles sobre c mo cambiar estos valores predeterminados Por suspuesto cualquiera de estos campos se puede modificar escribiendo en la casilla correspondiente Arrastre y suelte o peque en el campo de la ubicaci n de un repositorio Guvnor t pico URL tal como http localhost 8080 jboss brms org drools guvnor Guvnor webdav Los resultados en la URL se analizan sint cticamente en los campos respectivos tambi n La informaci n de autenticaci n nombre del usuario y contrase a se pueden almacenar opcionalmente en el archivo clave del banco de trabajo de Eclipse basado en la selecci n de Guardar nombre de usuario y contrase a Si la informaci n no se almacena en el key ring entonces el EGT usa la autenticaci n de sesi n Esto significa que las credenciales proporcionadas se utilizan solamente durante el tiempo de vida de la instancia del banco de trabajo de Eclipse Si la informaci n de autenticaci n no se almacena en el
59. form 5 Manual del usuario de BRMS Cargue la JAR que contiene el modelo definido como paquetes y clases Java y en un archivo Java JAR normal File Edit Status Draft Attributes Edit EN MyPojoModel Upload new version Choose File No file chosen Upload Download currentversion Download 5 3 Modelo declarativo El utilizar un modelo declarativo tiene los siguientes beneficios Refuerza que el modelo pertenece a la base de conocimiento note la aplicaci n El modelo puede tener un ciclo de vida separado de las aplicaciones Los tipos Java se pueden enriquecer con anotaciones especificas de reglas Los archivos JAR se deben mantener sincronizados entre las reglas y las aplicaciones que las utilizan sin embargo no es necesario mantener sincronizado un modelo declarativo Los modelos declarativos pueden ser Una definici n aut noma de todo el modelo de hechos que se utiliza dentro de sus reglas Una definici n de hechos complementaria para soportar un modelo Java POJO Procedimiento 5 2 Creaci n de un modelo declarativo 46 1 Abra el men New Declarative Model Del men Knowledge Bases seleccione Create New y luego seleccione New Declarative Model 2 Creaci n de un nuevo modelo declarativo Introduzca un nombre para el nuevo modelo Seleccione el paquete en donde crear el modelo o especifique que se debe agregar al Global Area Haga clic en OK cuando se hayan introducido todos los detalles Capitulo 5 El mo
60. gar Guardar cambios Mostrar historial Comparar con la versi n Cambiar a la versi n Borrar gt Desconectar Cada una de estas acciones se describir n a continuaci n Actualizar acci n La acci n de actualizaci n est disponible para uno o m s recursos Guvnor que no est n en sincronizaci n con las copias maestras del repositorio Guvnor Estos recursos no estar an en sincronizaci n ya que una de las siguientes o ambas 1 hay cambios locales en estos recursos o 2 las copias maestras han cambiado en el repositorio Guvnor Al realizar la acci n de actualizaci n se reemplaza el contenido del archivo local con el contenido actual de las copias maestras del repositorio Guvnor equivalente a cambio de versi n para la ltima versi n Agregar acci n La acci n de agregar est disponible para uno o m s archivos locales que no est n asociados con una copia maestra del repositorio Guvnor El seleccionar la acci n de agregar inicia el asistente Add to Guvnor Select Guvnor repository connection E Select an existing Guvnor repository connection or create a new one O Create a new Guvnor repository connection Use an existing Guvnor repository connection http localhost 8080 jboss brms org drools guvnor Guvnor webdav Next gt Cancel Figura 10 12 Agregar acci n 66 Cap tulo 10 Integraci n de JBoss Developer Studio La primera p gina del asistente le pide que seleccione
61. hay categor as por defecto en el sistema Ya que las categor as pueden ser jer rquicas debe seleccionar la categor a padre para la cual quiere crear una sub categor a Desde aqu tambi n se pueden borrar 16 Capitulo 4 Conceptos de BRMS las categorias pero solo si no estan en uso por parte de cualquiera de los activos actuales Como regla general un activo solo debe pertenecer a una o dos categorias a la vez Las categor as son cr ticas en casos en donde tiene n meros grandes de reglas Las jerarqu as no necesitan ser muy profundas Red Hat las dise para ayudarle a descomponer reglas activos en partes administrables 4 3 Autor a de reglas La plataforma BRMS soporta varios formatos de activos regla Aqu se describen las que son clave Algunas de estas se cubren en otras partes del manual as que no vamos a repetir esos detalles 4 3 1 El editor de activos Las opciones disponibles en el editor de activos depender n del tipo de activo que se est editando El editor de activos se utilizar para modificar reglas y se puede utilizar para agregar borrar y re ordenar condiciones restricciones acciones campos y opciones El editor de activos tambi n le permite al usuario el trabajar con grupos validay y verificar reglas as como ver la fuente de reglas Vea los tips sobre las herramientas en el editor de activos para obtener mayores detalles Welcome admin Sign Out Browse Business rule assets mortg
62. i n de meta datos normal en las reglas DRL 4 3 9 2 4 Columnas de condiciones Las condiciones representan patrones de hechos definidos en el lado izquierdo o en la parte when de una regla Para definir una columna de condici n debe definir un enlace a una clase modelo o debe seleccionar una que se haya definido previamente Puede escoger el negar el patr n Una vez que se haya completado esto puede definir restricciones de campos Si dos o m s columnas se definen utilizando el mismo enlace de patr n de hechos las restricciones de campos se convierten en restricciones de campo compuestas en el mismo patr n Si define m ltiples enlaces para una sola clase modelo cada enlace se vuelve un modelo separado en el lado derecho de la regla 4 3 9 2 5 Columnas de acci n Las columnas de acci n se pueden definir para realizar operaciones simples en hechos enlazados dentro de la memoria de trabajo de la m quina de reglas o para crear hechos completamente nuevos Los nuevos hechos se pueden incluir l gicamente en la memoria de trabajo de la m quina de reglas y 24 Capitulo 4 Conceptos de BRMS por lo tanto esta sujeta a un mantenimiento de verdad como siempre Consulte JBoss Rules Reference Guide para obtener mayor informaci n sombre el mantenimiento de verdades e inserciones l gicas 4 3 9 3 Definici n de reglas Esta secci n permite definir reglas individuales utilizando las columnas definidas anteriormente name age i
63. l es el valor predeterminado para ver si se han actualizado Si se encuentran nuevos archivos entonces construir una nueva KnowledgeBase Si el grupo de cambios especifica un recurso que sea un directorio entonces su contenido se escanear en busca de cambios KnowledgeAgent kagent KnowledgeAgentFactory newKnowledgeAgent MyAgent kagent applyChangeSet ResourceFactory newUrlResource url KnowledgeBase kbase kagent getKnowledgeBase El KnowledgeAgent puede aceptar una configuraci n que permite cambiar algunos valores predeterminados Una propiedad de ejemplo es drools agent scanDirectories por defecto se escanean los directorios especificados en busca de nuevas adiciones pero es posible inhabilitar esto KnowledgeBase kbase KnowledgeBaseFactory newKnowledgeBase KnowledgeAgentConfiguration kaconf KnowledgeAgentFactory newKnowledgeAgentConfiguration kaconf setProperty drools agent scanDirectories false we don t scan directories only files KnowledgeAgent kagent KnowledgeAgentFactory newKnowledgeAgent test agent kaconf resource to the change set xml for the resources to add kagent applyChangeSet ResourceFactory newUrlResource url Este es un ejemplo de un change set xml 53 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS lt change set xmlns http drool1s org drools 5 0 change set xml1ns xs http www w3 org 2001 XMLSchema instance xs schemaLocation
64. mente instalado utilice el comando rpm q paquete ste entregar el resultado siguiente paquete versi n lanzamiento Observe que las palabras resaltadas en italicas nombre de usuario dominio nombre sistema de archivo paquete versi n y lanzamiento Cada palabra es un marcador de posici n ya sea de texto a ingresar cuando se ejecuta un comando o para un texto ejecutado por el sistema Aparte del uso est ndar para presentar el t tulo de un trabajo las it licas denotan el primer uso de un t rmino nuevo e importante Por ejemplo Publican es un sistema de publicaci n de DocBook 1 2 Convenciones del documento Los mensajes de salida de la terminal o fragmentos de c digo fuente se distinguen visualmente del texto circundante Los mensajes de salida enviados a una terminal se muestran en romano monoespaciado y se presentan as books Desktop documentation drafts mss photos stuff svn books_tests Desktop1 downloads images notes scripts svgs Los listados de c digo fuente tambi n se muestran en romano monoespaciado pero se presentan y resaltan de la siguiente manera JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS package org jboss book jca ex1 import javax naming InitialContext public class ExClient public static void main String args throws Exception InitialContext iniCtx new InitialContext Object ref iniCtx lookup EchoBean EchoHome home EchoHome ref Echo echo home cr
65. ntre m s activos tenga un paquete entonces tomar m s tiempo en constru rse Si la construcci n tiene xito entonces tendr la opci n de crear una toma de pantalla para la implementaci n En ese punto tambi n puede ver el drl que se genera cuando se construye el paquete 4 5 1 Importaci n de paquetes drl Tambi n es posible crear un paquete importando un archivo drl ya existente Cuando decide crear un nuevo paquete tiene la opci n de cargar un archivo dr1 BRMS tratar de comprender ese drl y crear autom ticamente un paquete por usted Las reglas en este se almacenar n como activos individuales aunque todav a ser n contenido de texto drl Note que para contruir el paquete necesitar cargar un 40 Capitulo 4 Conceptos de BRMS modelo apropiado como un jar frente al cual validar Este es un paso separado 4 6 Administraci n de versiones Tanto paquetes de conocimiento como activos individuales tienen versiones en el BRMS pero el mecanismo es un poco diferente para cada uno Los activos individuales se guardan como una version de un archivo en un sistema de control de fuentes tal como Subversion Sin embargo los paquetes de activos tienen versiones a demanda realizando una toma de pantalla Esta toma de pantalla es la que se utiliza para la implementaci n La siguiente secci n aborda la administraci n de la implementaci n y las tomas de pantalla con m s detalles Other meta data hd Version history
66. ogel Bn Da aes Draft 2008 Oct 2 07 32 16 Open W Processes bali te Enumerations DO isos Y Test Scenarios XML Properties e Other assets documentation Figura 4 28 Vista de paquete 43 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS Capitulo 5 El modelo de hechos el modelo de objetos Se necesita un modelo de hechos para dirigir las reglas de una aplicaci n basada en reglas El modelo de hechos usualmente coincide con el modelo de dominio de la aplicaci n pero en general se debe separar de este Esto hace m s f cil el administrar las reglas con el pasar del tiempo Hay dos maneras de definir un modelo de hechos gt Cargue un archivo JAR que contenga las clases Java que la aplicaci n y las reglas utilicen gt Declare un modelo dentro de BRMS que se pueda exportar como una KnowledgeBase y se utilice dentro de su c digo Java 5 1 El rea global Cuando se crean modelos de hechos se pueden importar en el paquete espec fico con el que se utilizar n o se pueden importar en el Global Area Es importante observar que los activos que se encuentran en el Global Area no est n disponibles globalmente se tienen que importar en los paquetes que los utilizar n El Global Area se debe utilizar como un lugar de almacenamiento para los activos que todav a no se est n utilizando o como punto central para los activos utilizados en m ltiples paquetes O NN Tenga cuidado al modificar los activos que se
67. on application explanation Underage al 2 Retract LoanApplication application a L show options Para agregar un fiador a la condici n primero es necesario el agregar el campo guarantor fiador al tipo de hecho de la aplicaci n para el modelo de cr dito hipotecario 18 Capitulo 4 Conceptos de BRMS Procedimiento 4 1 Agregar un campo a un tipo de hecho 1 Seleccionar el modelo Seleccione Knowledge Bases del panel de navegaci n en el lado izquierdo de la pantalla Expanda el paquete que contiene el modelo y seleccione model Abra el modelo de la lista haciendo clic en open 2 Agregue el campo Despliegue el tipo de hecho haciendo clic en el signo m s justo al lado y seleccione Add Field 3 Introduzca los detalles del campo Agregue los detalles en la ventana que aparece En este caso introduzca fiador en el campo Field name y seleccione True or False del men desplegable Type Field name guarantor Type Boolean True or False Guarde los cambios realizados al modelo seleccionando File y Save changes Ya que se agreg el campo del fiador al tipo de hecho del aplicante es posible modificar la regla para incluir un fiador Procedimiento 4 2 Agregar restricciones a las reglas 1 Borrar la restricci n actual Al modificar una regla existente puede ser necesafrio el borrar la restricci n actual Esto asegura que se seleccione el operador l gico correcto And u Or al tratar con m ltiples res
68. ono del l piz seleccione literal y luego haga clic en true para modificar el valor y seleccione falso 4 3 4 Relevancia La relevancia de una regla tambi n se puede modificar desde el editor dirigido bajo opciones La relevancia es un valor num rico que representa la prioridad de la regla DEL Value UI LUGIMAPPICAUOT APPICaLully 2 Retract LoanApplication application options Attributes salience 10 m 4 3 5 Listas desplegables dirigidas por el usuario Note que es posible el limitar los valores ce campos con solo cosas en una lista pre configurada Esta lista se configura como parte del paquete se utiliza una enumeraci n de datos para poblarlo con valores Estos valores pueden ser una lista fija o por ejemplo se pueden cargar desde una base de datos Esto es til para los c digos y otros campos en donde hay valores establecidos Tambi n es posible el tener lo que se puede ver en la pantalla en una lista desplegable y que sea diferente al valor o c digo utilizado en una regla Consulte la secci n sobre Enumeraci n de datos para obtener 20 Capitulo 4 Conceptos de BRMS mayor informaci n sobre la manera en que se configuran 4 3 6 Incremento con declaraciones DSL Si el paquete al cual pertenece la regla tiene una configuraci n DSL cuando agrega condiciones o acciones proporcionar una lista de declaraciones DSL de donde puede escoger cuando escoja una agregar una fila a la regla por medio de la
69. orio vac o y luego tome los siguientes pasos Si es un repositorio nuevo vaya a Admin y seleccione Manage Categories Agregue unas pocas categor as note que las categor as son s lo con el fin de la clasificaci n Las reglas necesitan un modelo de hechos tambi n conocido como un modelo de objetos con el cual trabajar Desde la funcionalidad Package Management tal como se esperar a se puede crear un nuevo paquete de conocimiento Los paquetes deben tener nombres significativos sin espacios Para cargar un modelo use un archivo jar que contenga el modelo de hechos API que estar utilizando en sus reglas y en su c digo Cuando se encuentre en la pantalla Model Editor puede cargar un archivo jar Para hacer esto seleccione el nombre del paquete de la lista que cre en el paso anterior Ahora modifique la configuraci n del paquete que acaba de crear con el fin de importar los tipos de hechos que ha cargado estas son las declaraciones de importaci n Guarde los cambios En este momento el paquete est configurado y est listo para utilizarse Note que tambi n puede importar un paquete DRL Drools Rule Language ya existente y las reglas se almacenar n en el repositorio como activos individuales 3 4 Escritura de reglas Una vez que tenga configurados una categor a y un paquete puede empezar a escribir reglas Hay m ltiples formatos de reglas pero BRMS los considera activos Puede crear una regla haciendo clic en
70. oss Enterprise BRMS es un sistema de administraci n de reglas empresariales JBoss Enterprise BRMS proporciona herramientas para administrar reglas empresariales de software en un entorno con m ltiples usuarios Es el punto nico de verdad para sus reglas empresariales lo que permite que los cambios tengan lugar de manera controlada utilizando una interfaz amigable para el usuario JBoss Enterprise BRMS Platform es una soluci n del lado del servidor basada en JBoss Rules para la administraci n almacenamiento modificaci n e implementaci n de reglas y otros activos de JBoss Rules Tambi n se proporciona una interfaz de usuario basado en la web as como integraci n para JBoss Developer Studio y otros entornos de desarrollo integrados basados en Eclipse A En varios lugares de JBoss Enterprise BRMS Platform y de su documentaci n se refiere a Guvnor JBosss Guvnor es el nombre del proyecto de c digo abierto sobre el cual se ha constru do JBoss Enterprise BRMS Platform Las referencias a Guvnor permanecen en la API las 1 3 Cu ndo se debe utilizar un BRMS Un sistema de administraci n de reglas empresariales es til en los siguientes escenarios Se necesita administrar un sistema para implementaci n y modificaci n de reglas M ltiples usuarios con diferentes niveles de habilidad necesitan acceder y modificar las reglas No existe una infraestructura para administrar las reglas BR WN PB Hay muchas reglas
71. pecifica una versi n exacta en este caso una toma de pantalla Cada toma de pantalla tiene su propia URL Si quiere la ltima versi n entonces reemplace NewSnapshot con LATEST Tambi n puede descargar un archivo de paquete PKG de aqu Ponga ese archivo en un directorio y use la funcionalidad file o dir del KnowledgeAgent Esto contactar de manera autom tica el servidor JBoss Enterprise BRMS Platform para las actualizaciones que no sean deseadas en algunos escenarios 8 2 Implementaci n manual Esta secci n es para usuarios avanzados que est n integrando la implementaci n en su propio mecanismo Normalmente debe utilizar el agente de conocimiento Para aquellos quienes no desean usar la implementaci n autom tica del KnowledgeAgent la implementaci n manual es bastante simple Los paquetes binarios que JBoss Enterprise BRMS Platform produce son objetos de paquetes serializados Puede des serializarlos y agregarlos a cualquier KnowledgeBase 54 Cap tulo 8 Integraci n de reglas con sus aplicaciones Desde JBoss Enterprise BRMS Platform los paquetes binarios se proporcionan desde la ltima versi n de un paquete una vez que el paquete se ha validado de manera exitosa y se ha constru do o desde las tomas de pantalla de la implementaci n Las URLs que JBoss Enterprise BRMS Platform expone proporcionan el paquete binario usando HTTP Tambi n puede emitir un comando HEAD para ver la ltima vez que se actualiz un paquet
72. pplication may be separate app servers drools compiler drools core drools repository JCR Jackrabbit datastore Figura 2 1 Diagrama arquitect nico BRMS se implementa como un WAR el cual proporciona interfaces de usuario a trav s de la web y paquetes binarios por medio de URLs Utiliza el est ndar JSR 170 para almacenamiento de datos JCR JBoss Seam se utiliza como el marco de trabajo del componente y GWT se utiliza como el kit de herramientas para construir la interfaz de usuario web basada en ajax 2 1 Componentes re utilizables BRMS usa una interfaz de servicio para separar la interfaz gr fica del usuario de la funcionalidad de segundo plano En este caso el segundo plano incluye el repositorio de activos as como las especificaciones del compilador para tratar con las reglas La interfaz principal es RepositoryService la cual se implementa en ServiceImplementation El plano principal ajax GWT le habla a esta interfaz usando el mecanismo de callback asincr nica de GWT El archivo de configuraci n Seam es components xml Esta interfaz de servicio la pueden re utilizar componentes opcionales o de primer plano 10 Capitulo 2 Arquitectura La interfaz de usuario GWT se puede volver a utilizar ya que GWT es solo una pagina html Guvnor htm1 Para aquellos familiarizados con GWT cada una de las funcionalidades se puede utilizar por separado La clase JBRMSFeature y las clases que la implementan en teor
73. propiedad drools serialization public keyStoreURL con la URL en donde se encuentra el TrustStore Si el TrustStore se encuentra en la ruta de clase del cliente entonces esto se puede lograr usando el m todo getClass getResource 73 74 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS Ejemplo 11 1 Cuando el TrustStore se encuentra en la ruta de clase del cliente URL trustStoreURL getClass getResource BRMSTrustStore keystore System setProperty KeyStoreHelper PROP_PUB_KS_URL trustStoreURL toExternalForm Ejemplo 11 2 Cuando el TrustStore se encuentra en un servidor web URL trustStoreURL new URL http brms intranet resources BRMSTrustStore keystore System setProperty KeyStoreHelper PROP_PUB_KS_URL trustStoreURL toExternalForm Ejemplo 11 3 Cuando el TrustStore se encuentra en el sistema local de archivos URL trustStoreURL new URL file mnt fileserve rules server BRMSTrustStore keystore System setProperty KeyStoreHelper PROP_PUB_KS_URL trustStoreURL toExternalForm 3 OPCIONAL Establezca la contrasefia del almac n de claves Configure la propiedad droo1s serialization public keyStorePwd con la contrase a para el almac n de confianza Esto s lo se necesita si se requiere una contrase a para acceder el almac n de confianza System setProperty KeyStoreHelper PROP_PUB_KS_PWD sekretPasswordHere Consulte el manual del administrador BRMS para ver las inst
74. ptos de BRMS Browse Find Business rule assets mortgages sscutedas manos refresh list fonen selected open selecte New gt 8 New Package a 2 New Spring Context uptcy history cep ES 5 New WorkingSet Approval as New Rule d credit checks Business rule assets New Rule Template pe Technical rule assets Upload POJO Model jar DsiRule 6 Functions New Declarative Model age DSL configurations New BPEL package ing Model New Function AR processes New DSL Enumerations 48 New RuleFlow Y Test Scenarios AR New BPMN2 Process amp XML Properties E A al Other assets documentation y Y New Test Scenario sf WorkingSets te SpringContext a Global Area al Create a file s Rebuild all package binaries SQA Definici n del activo Introduzca un nombre una categoria y una descripci n para la plantilla 27 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS New Rule Template x lt gt New Rule Template Create new O Import asset from global area Name template rule1 ay Be Home Mortgage initial category Commercial Mortgage a A Create in Package Mortgages zi O Create in Global area an example template rule Initial description ox 3 Definici n de la plantilla Use el editor dirigido para construir la regla Template keys son reservas de espacio dentro de la restricci n del campo y las secciones de acci n Se pueden seguir
75. r reglas Los grupos de trabajo se deben activar de manera manual desde el editor dirgido Procedimiento 6 1 Creaci n de un nuevo grupo de trabajo 1 Abra la ventana New WorkingSet Del men Knowledge Bases seleccione Create New y luego seleccione New WorkingSet JBoss BRMS Browse Find knowledge Bases Name search Create New gt f New Package a nan saa Packages N i 9 Y New Spring Context saa Global Area s amp s New WorkingSet x 19 New Rule ts New Rule Template len Upload POJO Model jar New Declarative Model New BPEL package 69 New Function Y New DSL R New RuleFlow AR New BPMN2 Process New Enumeration Y New Test Scenario amp Create a file amp Rebuild all package binaries Last modified by 2 Creaci n de un nuevo grupo de trabajo Introduzca un nombre y una descripci n para el grupo de trabajo Seleccione el paquete en donde crear el modelo o especifique que se debe agregar al Global Area Haga clic en OK cuando se hayan introducido todos los detalles 49 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS New WorkingSet es lt gt New WorkingSet Create new Import asset from global area Name e Create in Package defaultPackage Y J Create in Global area Initial description ok 3 Agregar tipos de hechos al grupo de trabajo Agregue los tipos de hechos al grupo de trabajo movi ndolos de la lista en l
76. ra que se presente la lista de ah viene la importancia del uso de categor as para una navegaci n r pida Para resumir aunque las reglas y activos en general peuden aparecer en cualquier n mero de categor as s lo viven en un paquete Si considera el BRMS como un sistema de archivos entonces cada paquete es un directorio y los activos viven en ese directorio como una lista de archivos Cuando crea una toma de pantalla de una implementaci n de un paquete est efectivamente copiando todos los activos de ese directorio en otro directorio especial La funcionalidad de administraci n de paquetes le permite ver una lista de paquetes de conocimiento y puede expandirlos para ver listas de cada tipo de activo hay muchos activos as que algunos de ellos se agrupan juntos Los tipos de activos Activos empresariales este muestra una lista de todos los tipos de reglas empresariales incluyendo tablas de decisiones reglas empresariales etc Activos t cnicos esta es una lista de cosas que se consideran como t cnicas tal como reglas DRL enumeraciones de datos y flujos de reglas Funciones en BRMS tambi n puede tener funciones definidas estos es opcional DSL del ingl s Domain Specific Languages lenguajes espec ficos de dominios tambi n se pueden almacenar como activos Si existen generalmente solo habr uno entonces se utilizar n junto con los GUls del editor apropiado Modelo un paquete requiere por
77. ration de JBoss Enterprise BRMS Platform El panel de navegaci n en la izquiera proporciona un r pido acceso a todas las reas principales de la interfaz de usuario web BRMS Estas reas son gt Info Esta es la pantalla inicial con enlaces a los recursos gt Reglas Esta es la categor a y la perspectiva del usuario empresarial y Paquete Aqu es donde se configuran y administran los paquetes de conocimiento Implementaci n aqu es donde se administran las tomas de pantalla de la implementaci n gt Admin funciones administrativas categor as estatus importaci n y exportaci n 3 1 Navegadores soportados Tabla 3 1 Navegadores soportados Sistema operativo Navegadores RHEL 5 x y posteriores FireFox 3 0 Microsoft Windows FireFox 3 0 Microsoft Windows Internet Explorer 7 Mac OSX 10 x FireFox 3 0 Mac OSX 10 x Safari 4 y 5 12 Capitulo 3 Manual de inicio rapido 3 2 BRMS o Guvnor En versiones previas de Drools BRMS con frecuencia se utilizaba para referirse a la interfaz web para las funcionalidades de administraci n drools Hoy en d a usamos BRMS para referirse a todo el paquete el tiempo de ejecuci n las herramientas web etc pero en algunos casos BRMS se puede entender como la consola web Guvnor y las herramientas asociadas 3 3 Configuraci n inicial Se requiere una configuraci n inicial para la primera vez La primera vez que el servidor inicia se crear un reposit
78. recer la nueva conexi n del repositorio en Guvnor Repository Explorer Luego puede expandir la vista de rbol para ver el contenido del repositorio 10 3 Explorador del repositorio Guvnor 0 Guvnor Repositories x x ri eg v o http localhost 8080 jboss brms org drools guvnor Guvnor webda v packages gt defaultPackage Y mortgages ApplicantDsl dsl Are they old enough scenario Bankruptcy history brl CreditApproval brl credit ratings enumeration drools package Figura 10 6 Explorador La vista del explorador del repositorio Guvnor contiene estructuras de arbol para el contenido del repositorio Guvnor Tal como se describi anteriormente hay acciones del men y de la barra de herramientas para crear conexiones del repositorio Guvnor La X roja en la barra de herramientas y Delete en el men borra una conexi n del repositorio Guvnor y la opci n Refresh del men vuelve a cargar el contenido del rbol para el nodo seleccionado Finalmente hay un n mero de opciones en la barra de herramientas y en el men para soportar la funcionalidad drill into en la barra de herramientas estas se representan por la casa return to top level home y las flechas go into back Drill down es til al trabajar con estructuras de rboles profundos y cuando desea concentrarse en una sola rama del rbol Hay un n mero de operaciones que se pueden realizar en los archivos del repositorio Guvnor El selec
79. rucciones sobre c mo configurar el la criptograf a de claves p blicas Historial de revisiones Historial de revisiones Revisi n 5 2 0 2 400 2013 10 31 R diger Landmann Rebuild with publican 4 0 0 Revision 5 2 0 2 2012 07 18 Anthony Towns Rebuild for Publican 3 0 Revisi n 5 2 0 0 August 4 2011 L Carlon Actualizado para 5 2 0 Se dividi el cap tulo 3 manual del usuario en los cap tulos 3 4 y 5 Se agreg informaci n adicional sobre las tablas de decisi n cap tulo 4 4 4 Se agreg informaci n adicional sobre el modelo de hechos cap tulo 5 Se agreg un cap tulo sobre grupos de trabajo cap tulo 6 Revisi n 5 1 0 0 Mon December 13 2010 David Le Sage Darrin Mison Actualizado para 5 1 0 El contenido sobre instalaci n y administraci n se movi al manual correspondiente Se agreg contenido para las nuevas funcionalidades del buz n de entrada y los comentarios secci n 3 9 Se agreg contenido para la configuraci n de clientes para la funcionalidad de la firma de paquetes de reglas cap tulo 5 Revisi n 5 0 2 0 Wed May 5 2010 Darrin Mison Actualizado para 5 0 2 BRMS 262 Se agreg contenido para la configuraci n de registros secci n 2 7 BRMS 233 Se actualizaron varias tomas de pantalla cap tulo 4 Revisi n 5 0 1 0 Fri Oct 32009 David Le Sage Darrin Mison Actualizado para 5 0 1 BRMS 227 Se agreg la secci n 2 3 sobre localizaci n Revisi n 5 0 0 1 Thu 16 Jul 2009 Darrin Mison BRMS
80. ry Open bos J Are they old enough Open Incoming changes ppm a Good credit history only Open Recently Opened J gt CheckBoxDslRule Open Recently Edited E By status a ES pag Open am By Category J template Open Home Mortgage 2 MortgageModel Open Eligibility rules a Underage Open Pricing rules 4 4 180f8 Test scenarios Figura 9 2 Buz n de entrada 57 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS El buz n de entrada tiene tres sub buzones Cambios entrantes Aqu se listan los cambios que un usuario haya realizado en un objeto Abierto recientemente Aqu se listan los ltimos 100 objetos que el usuario ha abierto para tener acceso r pido Modificado recientemente Aqu se listan los ltimos 100 objetos que el usuario ha modificado para facilitar el acceso r pido 58 Cap tulo 10 Integraci n de JBoss Developer Studio Cap tulo 10 Integraci n de JBoss Developer Studio EGT del ingl s Eclipse Guvnor Tools proporciona una interfaz para que los desarrolladores puedan leer escribir agregar y borrar activos de un servidor JBoss Enterprise BRMS Platform usando JBoss Developer Studio 4 EGT le brinda a los desarrolladores una interfaz similar a los sistemas de control tradicionales tal como Subversion A pan mportante JBoss solo proporciona soporte para esta funcionalidad en JBoss Developer Studio versiones 4 El repositorio de BRMS Platform
81. s proporcionando una fuente adicional de documentaci n para los objetos y un sistema de notificaci n para los cambios en los objetos 9 1 Comentarios Cualquier usuario puede agregar un comentario a cualquier objeto en la secci n de comentarios a continuaci n debajo de la casilla de documentaci n del objeto Cada comentario se registra junto con la identidad del usuario que realiza el comentario y la fecha y hora en que se realiz el comentario Los administradores pueden borrar todos los comentario en un objeto dado pero los otros usuarios solo pueden agregar comentarios File Edit Source Status Draft Attributes Edit Metadata Other meta data Version history Description Discussion Comment by admin on Mon Sep 12 15 22 57 GMT 1000 2011 This will need to be updated next year when we expand into new areas as different regions have different laws about minimum age Add a discussion comment Erase all comments D Figura 9 1 Comentarios 9 2 Buz n de entrada El buz n de entrada se encuentra en el rea de navegaci n en el panel de navegaci n Brinda acceso r pido a los objetos en los que el usuario ha trabajado recientemente as como las notificaciones de los cambios a los objetos que el usuario modific anteriormente Browse Find Recently Opened Create New gt refresh list open selected open selected to single tab M Y Assets Format Name Open s Find Bankruptcy histo
82. sentido para su organizaci n 42 Browse Create New gt a Y Assets A Find 4 inbox a 2 By Status sa By Category Home Mortgage Eligibility rules Pricing rules Test scenarios Technical Commercial Mortgage Figura 4 27 Vista de categoria Capitulo 4 Conceptos de BRMS El diagrama anterior muestra la funcionalidad de categor a en acci n Si es posible limite el n mero de reglas en cada categor a a m ximo unas pocas docenas La vista opcional usa el explorador de paquetes Esta vista muestra los activos de una manera que refleja c mo est n de hecho almacenados en la base de datos Tambi n separa reglas en paquetes de conocimiento y su tipo o formato 2 Browse Find Model mortgages Business rule assets mortgages Underage Status Manag knowledge Bases refresh list open selected open selected to single tab l m Create New gt Format Name Status Last modified Open sss Packages y 6 Bankruptcy history Draft 2008 Oct 1 12 55 07 Open o E wee com J 8 CreditApproval Draft 2008 Oct 22 02 35 55 Open 8 defaultPackage x J 6 Guarantor Draft 2011 Sep 9 13 31 09 Open mortgages Biciness tue asset i 8 No bad credit checks Draft 2008 Oct 1 12 55 21 Open amp Technical rule assets B Pricing loans Draft 2008 Oct 1 13 46 07 Open Functions 8 RegexDsiRule Draft 2008 Oct 23 05 41 28 Open DSL configurations EN Underage Draft 2008 Oct 1 12 54 34 Open Py M
83. suario de BRMS Y Browse Find Snapshot ANOTHER Misnowedge Bases Viewing snapshot ANOTHER 3 PFOA EO For package mortgages Package snapshots Deployment URL click here to download binary or copy URL for deployment agent Create New gt Snapshot created on 2011 09 12 15 06 i Comment ss Package snapshots Delete Col a EH com x Compare to TEST Compare defaultPackage as mortgages a mortgages TEST Business rule assets ANOTHER amp Technical rule assets Functions DSL configurations Model A Processes te Enumerations Y Test Scenarios XML Properties Other assets documentation ES WorkingSets SpringContext Figura 4 26 Tomas de pantallas de implementaciones La imagen anterior muestra la vista Deployment Snapshots En la izquierda hay una lista de paquetes de conocimiento Al hacer clic en un paquete en especifico en esa lista podr ver todas las tomas de pantalla para este si hay alguna Desde all puede copiar borrar o ver una toma de pantalla Cada toma de pantalla est disponible para descargarse o para accederla por medio de una URL Una vez descargada se pueden implementar 4 8 Navegaci n del repositorio y ubicaci n de reglas Las dos maneras principales de ver el repositorio es utilizar la categorizaci n dirigida por el usuario tambi n conocida como etiquetaci n y la vista Package Explorer La vista de categor as le brinda una manera de navigar sus reglas que tengan
84. tType gt lt boundName gt app lt boundName gt lt fact gt lt compositePattern gt lt type gt not lt type gt lt patterns gt lt fact gt lt factType gt IncomeSource lt factType lt fact gt lt patterns gt lt compositePattern gt lt lhs gt lt rhs gt Y gt Rule Builder BRL Source Generated DRL read only Figura 10 9 Contenido de archivos El arrastrar un archivo del rbol del repositorio Guvnor en una carpeta en un proyecto local de Eclipse por ejemplo en la vista del navegador de recursos de Eclipse har que se realice una copia de ese archivo en el espacio de trabajo local de Eclipse nota tambi n puede utilizar Save As cuando un archivo est abierto en un editor de s lo lectura para guardar una copia local escribible del contenido Sin embargo al hacer esto no se asociar el archivo creado con su fuente Guvnor Finalmente puede ver el historial de revisiones de un archivo seleccionado en el rbol usando la opci n Show History del men de contexto los detalles del historial del recursos se discute a continuaci n 10 4 Copias locales de archivos Guvnor Como lo mencionamos en la Introducci n el prop sito principal del EGT es el permitir el desarrollo usando recursos que se mantienen en un repositorio Guvnor Hay dos m todos de obtener copias locales de recursos del repositorio Guvnor 1 Arrastre y suelte del explorador del repositorio Guvnor tal como se describi anteriormen
85. te Cuando se crean copias locales de los archivos del repositorio Guvnor el EGT establece una 64 Cap tulo 10 Integraci n de JBoss Developer Studio asociaci n entre la copia local y el archivo maestro en el repositorio esta informaci n se mantiene en el directorio guvnorinfo normalmente escondido en el proyecto local y como todos los metadatos los usuarios no lo deben cambiar Esta asociaci n permite operaciones tal como la actualizaci n y el guardar cambios en sincronizaci n con la copia maestra que se mantiene en el repositorio Guvnor El EGT decora los recursos locales asociados con copias maestras del repositorio Guvnor Esta decoraci n aparece en las vistas de Eclipse que cumplen con los requerimientos del navegador com n de Eclipse tal como el navegador de recursos de Eclipse y el explorador de paquetes Java La imagen a continuaci n muestra la decoraci n en el navegador de recursos de Eclipse Y 3 anotherproject E versionHistoryTest txt 6 2008 07 17T15 41 51 amp test amp temp B delete Test txt Y simpleRule drl 3 2008 07 15T15 37 34 2 testRefresh txt 1 2008 07 16T15 15 21 E versionHistoryTest txt 6 2008 07 17T15 41 51 Figura 10 10 Navegador Note el cono Guvnor en la parte superior derecha de las im genes de archivo y los detalles de revisi n de Guvnor que se agregan a los nombres de los archivos se puede cambiar la presencia ubicaci n de estos consulte Guvnor Preferences
86. to muestra como es posible realizar selecciones dependientes en otros valores de campos Note que una vez seleccione el engineT ype se determina la lista seleccionada para el fuelType Carfa de enumeraciones program ticamente En algunos casos se querr cargar los datos de enumeraci n desde una fuente de datos externa como una base de datos relacional Para lograr esto puede implementar una clase que retorne un mapa La clave del mapa es una cadena la cual es el nombre Fact field que vimos anteriormente El valor es una java util List de cadenas 35 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS public class SampleDataSource2 public Map lt String gt List lt String gt gt loadData Map data new HashMap List d new ArrayList d add valuei d add value2 data put Fact field d return data En la enumeraci n en el BRMS ponga lo siguiente new SampleDataSource2 loadData El signo le dice que cargue los datos ejecutando su c digo Enumeraciones avanzadas En los casos que vimos anteriormente los valores en las listas se calculan por adelantado Esto es muy adecuado para cantidades de datos relativamente est ticos o peque os Sin embargo imag nese un escenario en donde tiene listas de pa ses y cada pa s tiene una lista de estados cada estado tiene una lista de localidades cada localidad tiene una lista de calles etc Podr ver que esto puede llegar a una gran cantida
87. torio y tambi n sirve como un espacio de nombre Es el equivalente a una carpeta de inicio en la cual viven los activos de reglas Las reglas en particular necesitan saber la naturaleza del modelo de hechos y el espacio de nombres 37 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS Browse Find Model mortgages Business rule assets mortgages Underage Status Manag refresh list open selected open selected to single tal a Knowledge Bases fresh list aaa AT le tab Create New gt Format Name Status Last modified Open su Packages EN Bankruptcy history Draft 2008 Oct 1 12 55 07 Open com 8 CreditApproval Draft 2008 Oct 22 02 35 55 Open a Y defaultPackage By Guarantor Draft 2011 Sep 9 13 31 09 Open tE mortgages Business rue assets En No bad credit checks Draft 2008 Oct 1 12 55 21 Open amp Technical rule assets E Pricing loans Draft 2008 Oct 1 13 46 07 Open Functions J EN RegexDsiRule Draft 2008 Oct 23 05 41 28 Open DSL configurations 8 Underage Draft 2008 Oct 1 12 54 34 Open 5 J Model EN PONS s Draft 2008 Oct 2 07 32 16 Open A Processes pa 1 80f8 gt tel Enumerations Y Test Scenarios XML Properties 2 Other assets documentation Figura 4 21 El explorador de paquetes La figura anterior muestra el explorador de paquetes Al hacer clic en un tipo de activos mostrar una lista de coincidencias para los paquetes con miles de reglas y puede que tome varios segundos pa
88. tos de BRMS Viewing source for template rulel x 0 Viewing source for template rule1 rule template rulel_8 dialect mvel when Applicant age lt 45 age gt 35 creditRating Sub prime a LoanApplication then a setApproved false update a end l l l l l l l 3 10 1 rule template rule1_7 dialect mvel when l Applicant age lt 45 age gt 35 creditRating OK l a LoanApplication then l a setApproved false update a 8 Y O land Figura 4 17 DRL generado 4 3 11 Flujo de reglas Flujo de reglas el flujo de reglas le permite describir visualmente los pasos a tomar as que no todas las reglas se eval an al mismo tiempo sino que hay un flujo de la l gica En este cap tulo no abordamos los flujos de reglas pero puede utilizar el IDE para dibujar gr ficos de flujos de reglas y cargar el archivo rfm en el BRMS De manera similar que las hojas de c lculo puede cargar descargar archivos de flujos de reglas el IDE de eclipse tiene un editor gr fico para estos Los detalles de los flujos de reglas no se discuten aqu 4 3 12 Reglas t cnicas DRL Las reglas t cnicas DRL se almacenan como texto y se pueden administrar en el BRMS Un archivo DRL puede contener una o m s reglas Si el archivo contiene solo una regla entonces el paquete importa y no se requieren las declaraciones de reglas Simplemente puede utilizar when
89. tricciones En este caso haga clic en el s mbolo de menos al lado de la condici n de la edad 2 Modificaci n de restricciones Abra Modify Constraints Dialogue haciendo clic en el texto There is an Applicant Seleccione la restricci n del men desplegable Add a restriction on a field En este caso seleccione Age Del men deplegable Multiple field constraints seleccione A11 of and 19 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS Modify constraints for Applicant x Modify constraints for Applicant Add a restriction on a field Multiple field constraint k O Advanced options i z z Modify constraints for Applicant Add a new formula style expression New formula Expression editor Expression editor Variable name Set 3 Especifique la primera restricci n Haga clic en el texto all of the following para abrir la ventana Add fields to this constraint y agregue la restricci n En este caso seleccione Age Del men desplegable seleccione less than y modifique el valor literal haciendo clic en el cono del l piz seleccione literal y luego haga clic en Value para introducir el valor apropiado en este caso 21 4 Especifique la segunda restricci n Haga clic en el texto all of the following para abrir la ventana Add fields to this constraint y agregue la restricci n Esta vez seleccione guarantor Del nuevo men desplegable seleccione equal to y modifique el valor literal haciendo clic sobre el c
90. y then para marcar las secciones de Condici n y Acci n respectivamente Normalmente utilizar a el entorno de desarrollo integrado para modificar archivos raw DRL ya que tiene todas las herramientas avanzadas ayuda de contenido y funcionalidad de depuraci n Sin embargo hay ocasiones en las que una regla tenga que tratar con algo m s bien t cnico en un paquete en BRMS En cualquier paquete t pico de reglas generalmente necesita algunas reglas t cnicas Puede mezclar todos los tipos de reglas claro est 33 JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS salience 100 this can short circuit any processing when a Approve p Policy then p setApproved true System out printin APPROVED a getReason Figura 4 18 Regla t cnica DRL 4 3 13 Funciones Las funciones son otro tipo de activo No son reglas y solo se deben utilizar cuando sea necesario El Editor de funciones es un editor textual function lt returnType gt funcName lt args here gt code goes in here Figura 4 19 Funci n 4 3 14 Enumeraciones de datos Configuraciones de la lista desplegable Las enumeraciones de datos son un tipo opcional de activo que se puede configurar para proporcionar listas desplegables para el editor dirigido Se almacenan y se modifican como cualquier otro activo y solo se aplican al paquete al cual pertenecen El contenido de una configuraci n de enumeraci n es el mapeo de
91. y EGT no tienen la intenci n de reemplazar un sistema de control fuente dedicado en su entorno de desarrollo sino que brinda una manera conveniente de acceso para los desarrolladores OP importante 7 Importante Guvnor es el nombre del proyecto de c digo abierto sobre el cual se ha constru do JBoss Enterprise BRMS Platform Eclipse Guvnor Tools se desarrollaron con esto en mente En cualquier lugar en donde EGT se refiera a Guvnor se puede considerar como equivalente a BRMS Platform Para evitar confusi n en lo que queda de este cap tulo utilizaremos el t rmino Guvnor 10 1 Sinopsis de las funcionalidades EGT tiene dos vistas Explorador del repositorio e historial de versiones son el punto central de gran parte de la interacci n con el repositorio Guvnor La perspectiva Guvnor Repository Exploring se brinda como la distribuci n sugerida Se puede acceder desde la ventana Open Perspective Window gt Open Perspective gt Other En el lado izquierdo se encuentran las vistas Guvnor Repository Explorer y Eclipse Properties la vista Guvnor Resource History se encuentra en la parte inferior y el Eclipse Resource Navigator est en el lado derecho El Guvnor Repository Explorer propociona acceso a los recursos del repositorio Guvnor en un formato de rbol navegable La vista Guvnor Resource History muestra revisiones de recursos especificos disponibles en el repositorio JBoss Enterprise BRMS Platform 5 Manual

JBoss Enterprise BRMS Platform 5 Manual del usuario de BRMS

Contents

Download Pdf Manuals

Related Search

Related Contents