Suite BPM JBoss de Red Hat 6.0 Guía de inicio
Anuncio
Suite BPM JBoss de Red Hat 6.0 Guía de inicio La guía de inicio para BPMS JBoss Red Hat Kanchan Desai Doug Hoffman Red Hat Content Services Eva Kopalova Suite BPM JBoss de Red Hat 6.0 Guía de inicio La guía de inicio para BPMS JBoss Red Hat Kanchan Desai [email protected] m Do ug Ho ffman Eva Ko palo va Red Hat Co ntent Services Legal Notice Co pyright © 20 14 Red Hat, Inc. This do cument is licensed by Red Hat under the Creative Co mmo ns Attributio n-ShareAlike 3.0 Unpo rted License. If yo u distribute this do cument, o r a mo dified versio n o f it, yo u must pro vide attributio n to Red Hat, Inc. and pro vide a link to the o riginal. If the do cument is mo dified, all Red Hat trademarks must be remo ved. Red Hat, as the licenso r o f this do cument, waives the right to enfo rce, and agrees no t to assert, Sectio n 4 d o f CC-BY-SA to the fullest extent permitted by applicable law. Red Hat, Red Hat Enterprise Linux, the Shado wman lo go , JBo ss, MetaMatrix, Fedo ra, the Infinity Lo go , and RHCE are trademarks o f Red Hat, Inc., registered in the United States and o ther co untries. Linux ® is the registered trademark o f Linus To rvalds in the United States and o ther co untries. Java ® is a registered trademark o f Oracle and/o r its affiliates. XFS ® is a trademark o f Silico n Graphics Internatio nal Co rp. o r its subsidiaries in the United States and/o r o ther co untries. MySQL ® is a registered trademark o f MySQL AB in the United States, the Euro pean Unio n and o ther co untries. No de.js ® is an o fficial trademark o f Jo yent. Red Hat So ftware Co llectio ns is no t fo rmally related to o r endo rsed by the o fficial Jo yent No de.js o pen so urce o r co mmercial pro ject. The OpenStack ® Wo rd Mark and OpenStack Lo go are either registered trademarks/service marks o r trademarks/service marks o f the OpenStack Fo undatio n, in the United States and o ther co untries and are used with the OpenStack Fo undatio n's permissio n. We are no t affiliated with, endo rsed o r spo nso red by the OpenStack Fo undatio n, o r the OpenStack co mmunity. All o ther trademarks are the pro perty o f their respective o wners. Abstract Esta guía le ayuda a lo s usuario s a instalar y co nfigurar BPMS JBo ss de Red Hat po r primera vez. T able of Cont ent s T able of Contents .Prefacio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3. . . . . . . . . . 1. Co nvenc io nes d el Do c umento 3 1.1. Co nvenc io nes tip o g ráfic as 3 1.2. Co nvenc io nes d el d o c umento 4 1.3. No tas y Ad vertenc ias 5 2 . Có mo o b tener ayud a y hac er s us c o mentario s 5 2 .1. ¿Nec es ita ayud a? 2 .2. ¡Nec es itamo s s us c o mentario s ! 5 6 . .apít C . . . ulo ...1 . .. .Int . . roducción . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7. . . . . . . . . . 1.1. So b re la Suite BPM JBo s s d e Red Hat 7 1.2. Co mp o nentes d e la s uite BPM JBo s s d e Red Hat 7 1.3. Ejemp lo d e us o : s o luc io nes b as ad as en p ro c es o s en la ind us tria d e p rés tamo s 7 . .apít C . . . ulo ...2 . .. .Inicio . . . . .rápido . . . . . . con . . . .Red . . . .Hat . . . .JBoss . . . . . BPM . . . . .Suit . . . .e. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1. 0. . . . . . . . . . . .apít C . . . ulo . . . 3. ..O . .pciones . . . . . . . de . . . inst . . . .alación . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1. 1. . . . . . . . . . 3 .1. La ins talac ió n ag rup ad a EAP6 11 3 .1.1. Des c arg a d el p aq uete EAP6 3 .1.2. Ins talac ió n d el p aq uete EAP6 11 11 3 .1.3. Definic ió n d e ro les 3 .1.4. Creac ió n d e us uario s 13 13 3 .2. La ins talac ió n ag rup ad a g enéric a imp lementab le 3 .2.1. Des c arg a d el p aq uete imp lementab le g enéric o 3 .2.2. Ins talac ió n d el p aq uete imp lementab le g enéric o 14 14 15 3 .2.2.1. Co nfig urac ió n d el ad minis trad o r d e trans ac c io nes p ara Red Hat JBo s s Web Server 2.0 (To mc at 7) 15 Ins tale el g es to r d e trans ac c io nes . 16 3 .2.2.2. Co nfig urac ió n d e una c entral emp res arial p ara Red Hat JBo s s Web Server 2.0 (To mc at 7) 18 3 .2.2.3. Co nfig urac ió n d e Das hb uild er p ara Red Hat JBo s s Web Server 2.0 (To mc at 7) 3 .3. Inic io d el s ervid o r 3 .4. Ad minis trad o r d e s eg urid ad Java y g es tió n d e rend imiento 21 22 23 . .apít C . . . ulo ...4 . .. .Inicio . . . . .de . . .sesión . . . . . .en . . .la. .cent . . . .ral . . empresarial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2. 5. . . . . . . . . . . .apít C . . . ulo . . . 5. . . Proyect . . . . . . .o . .Hello . . . . .World . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2. 6. . . . . . . . . . 5 .1. Creac ió n d e una es truc tura d e rep o s ito rio 26 . .apít C . . . ulo ...6 . .. .Proceso . . . . . . . Hello . . . . . World . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2. 9. . . . . . . . . . 6 .1. Creac ió n d e p ro c es o s emp res ariales 29 6 .2. Mo d elad o d e p ro c es o s emp res ariales 6 .3. Definic ió n d e p ro p ied ad es d el elemento 6 .4. Co ns truc c ió n e imp lementac ió n 6 .5. Ins tanc iac ió n d e p ro c es o s emp res ariales 6 .6 . Canc elac ió n d e p ro c es o s emp res ariales 29 30 31 32 33 . .apít C . . . ulo ...7 . .. .Reglas . . . . . . empresariales . . . . . . . . . . . . .Hello . . . . .World . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 ........... 7 .1. Creac ió n d e la reg la emp res arial 34 7 .2. Ag reg ac ió n d e la tarea d e reg las emp res ariales 35 7 .3. Co ns truc c ió n e imp lementac ió n 36 7 .4. Ins tanc iac ió n d e p ro c es o s emp res ariales 37 . .apít C . . . ulo ...8 . .. .BAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 ........... 8 .1. Ac c es o al c o ns truc to r d e p áneles d e la s uite BPM JBo s s Red Hat 39 1 Suit e BPM JBoss de Red Hat 6 .0 G uía de inicio 8 .1. Ac c es o al c o ns truc to r d e p áneles d e la s uite BPM JBo s s Red Hat 8 .2. Mo nito riz ac ió n d e ins tanc ias 39 39 . .apít C . . . ulo ...9 . .. .Est . . .udio . . . . del . . . desarrollador . . . . . . . . . . . . JBoss . . . . . . de . . .Red . . . .Hat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4. 0. . . . . . . . . . 9 .1. Central d e JBo s s 40 9 .2. Ins talac ió n d e lo s p lug ins d el es tud io d el d es arro llad o r JBo s s 41 9 .3. Co nfig urac ió n d el tiemp o d e ejec uc ió n Dro o ls 9 .4. Co nfig urac ió n d el tiemp o d e ejec uc ió n jBPM 9 .5. Co nfig urac ió n d el s ervid o r d e la s uite BPM JBo s s 9 .6 . Imp o rtac ió n d e p ro yec to s d es d e un rep o s ito rio G it a JBo s s Develo p er Stud io 41 42 42 43 9 .7. Creac ió n d e un p ro yec to Dro o ls 9 .8 . Creac ió n d e un p ro yec to jBPM 45 45 . .apít C . . . ulo ...1 . .0.. .Planificador . . . . . . . . . . .de . . recursos . . . . . . . . .empresariales . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4. 7. . . . . . . . . . 10 .1. Ins talac ió n d el p lanific ad o r d e rec urs o s emp res ariales 47 10 .2. Ejec uc ió n d e lo s ejemp lo s d el p lanific ad o r d e rec urs o s emp res ariales 47 . . . . orial Hist . . . . de . . . revisiones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4. 9. . . . . . . . . . 2 Prefacio Prefacio 1. Convenciones del Document o Este manual utiliza varias convenciones para resaltar algunas palabras y frases y llamar la atención sobre ciertas partes específicas de información. En ediciones PD F y de papel, este manual utiliza tipos de letra procedentes de Liberation Fonts. Liberation Fonts también se utilizan en ediciones de HTML 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 t ipográficas Se utilizan cuatro convenciones tipográficas para llamar la atención sobre palabras o frases específicas. D ichas convenciones y las circunstancias en que se aplican son las siguientes: Neg ri ta mo no espaci ad o 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_bestsel l i ng _no vel en su directorio actual de trabajo, escriba el comando cat my_next_bestsel l i ng _no vel 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 el comando. Pulse C trl +Al t+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 Neg ri tamo no espaci ad o . Por ejemplo: Las clases de archivo relacionadas incluyen fi l ename para sistema de archivos, fi l e para archivos y d i r para directorios. Cada clase tiene su propio conjunto asociado de permisos. N eg rit a p ro p o rcio n al 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 Sist ema → Pref eren cias → R at ó n desde la barra del menú principal para lanzar Pref eren cias d e rat ó n . En la pestaña de Bo to nes, seleccione la cajilla de rató n d e mano i zq ui erd a y luego haga clic en C errar para cambiar el botón principal del ratón de la izquierda a la derecha (adecuando el ratón para la 3 Suit e BPM JBoss de Red Hat 6 .0 G uía de inicio mano izquierda). Para insertar un carácter especial en un archivo g ed it , seleccione Ap licacio n es → Acceso rio s → Map a d e caract eres de la barra del menú. Luego, seleccione B ú sq u ed a → B u scar… de la barra del menú de Map a d e caract eres, escriba el nombre del carácter en el campo de Búsq ued a y haga clic en Si g ui ente. El carácter que buscó será resaltado en la T abl a d e caracteres. Haga doble clic en ese carácter resaltado para colocarlo en el campo de T exto a co pi ar y luego haga clic en el botón C o pi ar. Ahora regrese al documento y elija Mo d if icar → Peg ar de la barra de menú de g ed it . 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 itálicas 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 usuario@ dominio.nombre en un intérprete de comandos de shell. Si la máquina remota es exampl e. co m y su nombre de usuario en esa máquina es john, teclee ssh jo hn@ exampl e. co m. El comando mo unt -o remo unt file-system remonta el sistema de archivo llamado. Por ejemplo, para volver a montar el sistema de archivo /ho me, el comando es mo unt -o remo unt /ho me. Para ver la versión de un paquete actualmente instalado, utilice el comando rpm -q paquete. Éste entregará el resultado siguiente: paquete-versión-lanzamiento. Observe que las palabras resaltadas en itálicas — 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 document o 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 ro mano mo no espaci ad o y se presentan así: bo o ks bo o ks_tests D eskto p D eskto p1 do cum entatio n do wnlo ads drafts im ages m ss no tes pho to s scripts stuff svgs svn Los listados de código fuente también se muestran en ro mano mo no espaci ad o , pero se presentan y resaltan de la siguiente manera: static int kvm _vm _io ctl_deassign_device(struct kvm * kvm , struct kvm _assigned_pci_dev * assigned_dev) 4 Prefacio { int r = 0 ; struct kvm _assigned_dev_kernel * m atch; m utex_lo ck(& kvm -> lo ck); m atch = kvm _find_assigned_dev(& kvm -> arch.assigned_dev_head, assigned_dev-> assigned_dev_id); if (! m atch) { printk(KER N_I NFO "%s: device hasn' t been assigned befo re, " "so canno t be deassigned\n", __func__); r = -EI NVAL; go to o ut; } kvm _deassign_device(kvm , m atch); kvm _free_assigned_device(kvm , m atch); o ut: m utex_unlo ck(& kvm -> lo ck); return r; } 1.3. Not as y Advert encias Finalmente, utilizamos tres estilos visuales para llamar la atención sobre la información que de otro modo se podría pasar por alto. Nota 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. Aviso Las advertencias no deben ignorarse. Ignorarlas muy probablemente ocasionará pérdida de datos. 2. Cómo obt ener ayuda y hacer sus coment arios 2.1. ¿Necesit a ayuda? 5 Suit e BPM JBoss de Red Hat 6 .0 G uía de inicio Si encuentra dificultades con alguno de los procedimientos descritos en este documento, visite el Portal del cliente de Red Hat en http://access.redhat.com. A través del portal del cliente, usted podrá: 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 software de Red Hat y tecnología. Encontrará un listado de las listas de correo disponibles al público en https://www.redhat.com/mailman/listinfo. Haga clic en el nombre de la lista a la que quiera suscribirse o para acceder a los archivos de listados. 2.2. ¡Necesit amos sus coment arios! Si encuentra un error tipográfico en este manual o si ha pensado que hay alguna manera de mejorar este manual, nos gustaría escuchar sus sugerencias. Por favor complete un reporte en Bugzilla: http://bugzilla.redhat.com/ relacionando el producto Su it e B PM JB o ss d e R ed H at . Cuando envíe un reporte de error no olvide mencionar el identificador' del manual: Getting_Started_Guide Si tiene alguna sugerencia para mejorar la documentación, trate de ser tan específico como sea posible. Si ha encontrado algún error, por favor incluya el número de la sección y parte del texto que lo rodea para que sea más fácil ubicarlo. 6 Capít ulo 1 . Int roducción Capítulo 1. Introducción 1.1. Sobre la Suit e BPM JBoss de Red Hat La suite BPM JBoss de Red Hat es una suite de gestion de procesos empresariales de código abierto que combina la administración de procesos empresariales y la gestión de reglas empresariales y habilita a las empresas y a los usuarios informáticos para crear, administrar e implementar procesos y reglas empresariales. BRMS JBoss de Red Hat y la suite BPM JBoss de Red Hat usan un repositorio centralizado en donde todos los recursos se almacenan. Esto asegura consistencia, transparencia y la habilidad para realizar auditorías a través de la empresa. Los usuarios empresariales pueden modificar la lógica empresarial y los procesos empresariales sin requerir ayuda del personal de sistemas. Para acomodar el componente de reglas empresariales, la suite BPM JBoss de Red Hat incluye BRMS JBoss de Red Hat. El planificador de recursos empresariales se incluye como un avance de tecnología con este lanzamiento. Reportar un error 1.2. Component es de la suit e BPM JBoss de Red Hat La suite BPM JBoss de Red Hat contiene los siguientes componentes: Máq u in a d e ejecu ció n El entorno del tiempo de ejecución para los activos empresariales (procesos, tareas, reglas, etc). Para obtener mayores detalles consulte la Guía de configuración y administración de la suite BPM JBoss de Red Hat. R ep o sit o rio d e art ef act o s ( almacén d e co n o cimien t o ) Un almacenamiento para activos empresariales que proporcionan funcionalidades de control de revisiones (conecta repositorios GIT con activos empresariales). C en t ral emp resarial Una aplicación basada en red para la creación, administración y monitoreamiento de activos empresariales proporcionando un entorno integrado con las herramientas respectivas tal como reglas y herramientas de autoría de procesos, la herramienta de administración de activos empresariales para trabajar con el repositorio de artefactos, herramientas de administración de datos en tiempo de ejecución, editores de recursos, herramientas BAM (del inglés Business Activity Monitoring- monitoreamiento de actividades empresariales), herramientas de administración de tareas y herramientas BRMS. Para obtener mayores detalles consulte la Guía del usuario de la suite BPM JBoss de Red Hat. Reportar un error 1.3. Ejemplo de uso: soluciones basadas en procesos en la indust ria de prést amos La suite BPM JBoss de Red Hat (BPMS) se puede implementar para automatizar procesos empresariales tal como automatizar el proceso de aprobación de préstamos en un banco minorista. 7 Suit e BPM JBoss de Red Hat 6 .0 G uía de inicio Esta es una implementación típica 'basada en procesos específicos' que puede ser el primer paso en una adopción más amplia de BPM a través de una empresa. Aprovecha las funcionalidades de BPM y las reglas empresariales de BPMS. Un banco minorista ofrece varios tipos de productos de préstamo con diferentes términos y requerimientos de selección. Los clientes que requieren un préstamo deben llenar una aplicación de préstamo, la cual es procesada por el banco en varios pasos, verificando el criterio de selección, determinando los términos, verificando actividades fraudulentas y determinando el producto de préstamo más apropiado. Una vez aprobado, el banco crea y establece una cuenta de préstamo para el aplicante, quien luego puede acceder a los fondos. El banco debe asegurarse de cumplir con todos los requerimientos relevantes en cada paso del proceso y necesita administrar su portafolio de préstamo para maximizar sus ganancias. Las políticas tienen lugar para ayudar a tomar decisiones en cada paso y esas políticas están administradas activamente para optimizar resultados para el banco. Los analistas empresariales en el banco modelan los procesos de aplicación para préstamos usando las herramientas de autor BPMN3 (diseñador de procesos) en la suite BPM: Fig u ra 1.1. Flu jo d e p ro ceso s d e ap licació n p ara p rést amo s d e alt o n ivel Las reglas empresariales se desarrollan con las herramientas de autor de reglas en la suite BPM para aplicar políticas y tomar decisiones. Las reglas están enlazadas con los modelos de procesos para reforzar las políticas correctas en cada paso del proceso. La sección de sistemas del banco implementa la suite BPM de manera que todo el proceso de aplicación para préstamos se pueda automatizar. 8 Capít ulo 1 . Int roducción Fig u ra 1.2. Au t o mat iz ació n d el p ro ceso d e ap licació n p ara p rést amo s Todo el proceso de préstamo y de reglas se puede modificar en cualquier momento por parte de los analistas empresariales del banco. El banco tiene la habilidad de mantener constantemente un cumplimiento con los requerimientos de acuerdo con las regulaciones cambiantes y puede introducir de manera rápida nuevos productos de préstamo y mejorar las políticas de préstamos para competir efectivamente y dirigir la rentabilidad. Reportar un error 9 Suit e BPM JBoss de Red Hat 6 .0 G uía de inicio Capítulo 2. Inicio rápido con Red Hat JBoss BPM Suite En esta sección descargamos, instalamos y ejecutamos Red Hat JBoss BPM Suite con el número mínimo de instrucciones. Para obtener pasos detallados y métodos opcionales de instalación, sáltese esta sección y continúe leyendo el resto de esta guía. Estas instrucciones asumen que tiene instalada en su sistema la versión de Java soportada como mínimo. No se requiere un servidor Red Hat JBoss EAP ya existente ya que el instalador instala uno si no puede detectar uno. Pro ced imien t o 2.1. G u ía d e in icio ráp id o B PM Su it e 1. D escargue el instalador BPM Suite de access.redhat.com. 2. Ejecute el instalador con el siguiente comando: java -jar jbo ss-bpms-i nstal l er-VER SIO N. G A-red hat-MINO R . jar 3. Siga los pasos del instalador GUI tomando nota del nombre de usuario/contraseña para acceder a la aplicación BRMS después de la instalación. 4. D espués de una instalación exitosa, en una ventana de comandos navegue hasta la carpeta de inicio EAP en donde haya instalado BPM Suite. 5. Inicie el servidor BPM Suite emitiendo el siguiente comando. bi n/stand al o ne. sh 6. Abra un navegador de red e inicie sesión en la central empresarial navegando hasta http: //l o cal ho st: 80 80 /busi ness-central /. Inicie la sesión usando la combinación de nombre de usuario/contraseña para acceder a la aplicación BPM Suite que creó en el momento de la instalación. Ha instalado y ejecutado exitósamente BPM Suite. Ahora puede hacer lo siguiente: Aprender más sobre los roles: Sección 3.1.3, “ D efinición de roles” Crear usuarios adicionales: Sección 3.1.4, “ Creación de usuarios” Crear un proyecto Hello World: Capítulo 5, Proyecto Hello World Examine la Guía de la aplicación de ejemplo BPM Working with the BPM Suite Example App Busque instrucciones detalladas de instalación para usar el instalador: Installation Guide Reportar un error 10 Capít ulo 3. O pciones de inst alación Capítulo 3. Opciones de instalación La suite BPM JBoss de Red Hat viene en dos versiones: Instalador jar ejecutable para la instalación en Red Hat JBoss Enterprise Application Platform (EAP) 6.1.1. Archivo comprimido de instalación, el cual viene en dos versiones: jbo ss-bpms-6 . MINOR_VERSION-red hat-x-d epl o yabl e-eap6 . x. zi p: versión adaptada para implementación en la plataforma de aplicaciones empresariales JBoss de Red Hat (EAP 6.1.1). jbo ss-bpms-6 . MINOR_VERSION-red hat-x-d epl o yabl e-g eneri c. zi p: la versión implementable con bibliotecas adicionales adaptadas para la implementación en el Red Hat JBoss Web Server (WS), Apache Tomcat 6 y Apache Tomcat 7. D ependiendo de su entorno puede seleccionar la mejor opción de instalación de acuerdo con las necesidades de su proyecto. Reportar un error 3.1. La inst alación agrupada EAP6 Esta sección describe la instalación del paquete de la suite BPM JBoss de Red Hat implementable para la plataforma de aplicaciones empresariales JBoss de Red Hat JBoss (EAP). Nota La configuración mínima soportada de Red Hat JBoss EAP para la instalación de la suite BPM JBoss de Red Hat es 6.1.1 y no 6.1.0. Reportar un error 3.1.1. Descarga del paquet e EAP6 Para descargar el paquete de la suite BPM JBoss de Red Hat para la plataforma de aplicaciones empresariales JBoss, haga lo siguiente: 1. Vaya al portal del cliente de Red Hat e inicie sesión. 2. Seleccione D o wn lo ad s → R ed H at JB o ss Mid d leware → D o wn lo ad So f t ware. 3. D el menú desplegable P ro d uct seleccione BP M Sui te. 4. D el menú desplegable Versi o n seleccione la versión del producto. 5. En la tabla, navegue a la fila R ed Hat JBo ss BP M Sui te 6 . 0 . 2 i mpl ementabl e para EAP 6 . 1. 1 y luego haga clic en D escarg ar. Reportar un error 3.1.2. Inst alación del paquet e EAP6 11 Suit e BPM JBoss de Red Hat 6 .0 G uía de inicio Para instalar el paquete implementable para un EAP que todavía no se ha configurado, haga lo siguiente: 1. Extraiga el paquete zip implementable para EAP que descargó del portal del cliente de Red Hat. 2. Agrupe el paquete zip extraído para EAP en el directorio EAP SERVER_HOME. Aviso Este paso debe ser realizado con la misma cuenta de usuario que se utilizó para instalar EAP. Esta cuenta no debe ser la cuenta del superusuario. 3. En este proceso, se sobreescribirán múltiples archivos en el directorio EAP SERVER_HOME y usted debe permitir que el proceso de descompresión sobreescriba estos archivos. Un ejemplo de un archivo que se sobreescribe es el archivo SERVER_HOME/bi n/pro d uct. co nf. D espués de una agrupación exitosa, este archivo debe contener la cadena sl o t= bpms. Puede abrir este archivo para verificar que los archivos se hayan sobreescrito de manera exitosa. En Red Hat Enterprise Linux puede utilizar el siguiente comando para extraer el archivo zip BRMS y unirlo con su directorio de servidor correctamente en un paso, si ejecuta este comando en el directorio en donde descargó el archivo zip: unzip -u jbo ss-bpm s-VERSION-TYPE.zip -d SERVER_HOME_PARENT_DIR Ejemp lo 3.1. El co man d o p ara d esco mp rimir unzip -u jbo ss-bpm s-6 .0 .2-redhat-7-deplo yable-eap6 .x.zip -d /ho m e/jo hn/m yS ervers/ En el arranque del servidor se implementará la suite BPM JBoss de Red Hat. Para instalar el paquete implementable para un EAP previamente configurado, haga lo siguiente: 1. Extraiga el paquete zip implementable para EAP que descargó del portal del cliente de Red Hat. 2. D escomprima el archivador comprimido descargado; sin embargo, no sobreescriba todos los archivos. Agrupe manualmente los siguientes archivos en el directorio SERVER_HOME. jbo ss-eap-6 . 1/d o mai n/co nfi g urati o n/* - (por favor tenga en cuenta que BPMS requiere JMS así que JMS se agrega por defecto en todos los perfiles en d o mai n. xml proporcionado por la distribución BPMS). jbo ss-eap-6 . 1/stand al o ne/co nfi g urati o n/* - (por favor tenga en cuenta que BPMS requiere JMS así que JMS se agrega por defecto en todos los archivos de configuración de perfiles (especialmente en stand al o ne. xml y stand al o ne-ha. xml ) proporcionado por la distribución BPMS). jbo ss-eap-6 . 1/mo d ul es/l ayers. co nf jbo ss-eap-6 . 1/bi n/pro d uct. co nf 12 Capít ulo 3. O pciones de inst alación 3. Asegúrese de que el EAP de destino no incluya una implementación con un nombre que cree conflictos. Copie la carpeta jbo ss-eap-6 . 1/stand al o ne/d epl o yments en el directorio EAP_HOME de la distribución BPMS. 4. Asegúrese de que no se ha llamado antes la capa del módulo EAP llamada BPMS y copie la carpeta jbo ss-eap-6 . 1/mo d ul es/system/l ayers/bpms en la carpeta EAP 6.1.1. Reportar un error 3.1.3. Definición de roles Antes de iniciar el servidor e iniciar sesión en la central empresarial necesitará crear algunas cuentas de usuarios. Esta sección describe los diferentes roles de usuario que se utilizan Red Hat JBoss BPM Suite : admin: los usuarios con el rol admin son los administradores de la aplicación. Los administradores pueden administrar los usuarios, administrar los repositorios (crear y clonar) y tienen acceso completo para realizar los cambios requeridos en la aplicación. Los admins tienen acceso a todas las áreas dentro del sistema. developer: un usuario developer -desarrollador- tiene acceso a casi todas las funcionalidades y puede administrar reglas, modelos, flujos de procesos, formas y páneles. Pueden administrar el repositorio de activos, pueden crear, construir e implementar proyectos e incluso pueden usar el Red Hat JBoss D eveloper Studio para ver procesos. Solo se esconden ciertas funciones administrativas como el crear y clonar un nuevo repositorio para el rol del desarrollador. analyst: un rol de analista tiene acceso a todas las funcionalidades de alto nivel para modelar y ejecutar sus proyectos. Sin embargo, el acceso Au t h o rin g → Ad min ist rat io n no está disponible para los usuarios con el rol de analista. Ciertas funcionalidades de menor nivel orientadas a los desarrolladores como la vista D ep lo ymen t → Art if act R ep o sit o ry no son accesibles para este rol. Sin embargo, el botón Bui l d & D epl o y está disponible para el rol de analista usando el editor de proyectos. user: un usuario o un usuario empresarial trabajan en las listas de tareas empresariales que se utilizan para operar cierto proceso. Un usuario con este rol puede acceder el pánel y administrar procesos. manager: un manager -gerente- es un espectador del sistema y está interesado en las estadísticas con relación a los procesos empresariales y su rendimiento, indicadores empresariales y otros reportes del sistema. Un usuario con este rol tiene acceso al BAM solamente. Nota Ingrese los roles mencionados anteriormente durante el proceso de creación del usuario. Reportar un error 3.1.4 . Creación de usuarios Para empezar a agregar nuevos usuarios necesitará ejecutar el script add-user.sh en un sistema Unix o el archivo add-user.bat en un sistema Windows desde el directorio bin EAP. 1. Ejecute ./add-user.sh en un sistema Unix o add-user.bat en un sistema Windows desde el directorio bin. 13 Suit e BPM JBoss de Red Hat 6 .0 G uía de inicio 2. Ingrese b para seleccionar un usuario de la aplicación en el tipo de usuario y presione Intro. 3. Acepte el dominio predeterminado (ApplicationRealm): presionando Intro. 4. En el campo del nombre del usuario ingrese un nombre de usuario y confirme. Por ejemplo: hel l o wo rl d user. 5. Cree la contraseña del usuario en el campo de la contraseña y reingrese la contraseña. Por ejemplo: Hel l o wo rl d @ 123. Nota La contraseña debe tener por lo menos 8 caracteres de largo y debe tener caracteres en mayúsculas y minúsculas (por ejemplo, A-Z , a-z) por lo menos un caracter numérico (por ejemplo,. 0-9) y por lo menos un caracter especial (por ejemplo, ~ ! @ # $ % ^ * ( ) - _ + =). 6. Ingrese una lista de roles que el usuario necesitará en el campo de roles (consulte Sección 3.1.3, “ D efinición de roles” ). Los usuarios de la central empresarial necesitan por lo menos tener el rol anal yst y los usuarios dashbuilder necesitan tener el rol ad mi n. Los roles se deben ingresar como una lista: 7. Confirme que quiere agregar el usuario. 8. Ingrese si en el siguiente campo (esto es para habilitar el uso de clústers en el futuro si se requiere). Reportar un error 3.2. La inst alación agrupada genérica implement able Para instalar la suite BPM JBoss de Red Hat en el Red Hat JBoss Web Server (WS) , necesita utilizar el paquete implementable genérico del producto. Para la instalación en WS, el paquete implementable genérico contiene bibliotecas de seguridad y administradores de transacciones adicionales que no son parte del WS JBoss Red Hat. Note que el paquete implementable genérico contiene los siguientes archivos zip: jbo ss-bpms-eng i ne. zi p: las bibliotecas de la máquina de ejecución soportada que se necesitan si está incluyendo la máquina en su aplicación jbo ss-bpms-manag er. zi p: las aplicaciones de red busi ness-central . war y d ashbui l d er. war Reportar un error 3.2.1. Descarga del paquet e implement able genérico Para descargar el paquete de la suite BPM JBoss de Red Hat genérico implementable para el servidor de red JBoss, haga lo siguiente: 1. Vaya al portal del cliente de Red Hat e inicie sesión. 14 Capít ulo 3. O pciones de inst alación 2. Seleccione D o wn lo ad s → R ed H at JB o ss Mid d leware → D o wn lo ad So f t ware. 3. D el menú desplegable P ro d uct seleccione BP M Sui te. 4. D el menú desplegable Versi o n seleccione la versión del producto. 5. En la tabla, navegue a la fila R ed Hat JBo ss BP M Sui te 6 . 0 . 2 D epl o yabl e fo r al l suppo rted co ntai ners y luego haga clic en D o wnl o ad . Reportar un error 3.2.2. Inst alación del paquet e implement able genérico Para instalar el paquete implementable genérico, necesita configurar lo siguiente después de haber instalado la plataforma subyacente (Red Hat JBoss WS): Configure el controlador de la base de datos y el gestor de transacciones (Bitronix) (consulte Sección 3.2.2.1, “ Configuración del administrador de transacciones para Red Hat JBoss Web Server 2.0 (Tomcat 7)” ). Configure la aplicación de la central empresarial: configure usuarios y roles y configure la persistencia (consulte Sección 3.2.2.2, “ Configuración de una central empresarial para Red Hat JBoss Web Server 2.0 (Tomcat 7)” ). Configure la aplicación D ashbuilder: configure usuarios y roles y configure la persistencia (consulte Sección 3.2.2.3, “ Configuración de D ashbuilder para Red Hat JBoss Web Server 2.0 (Tomcat 7)” ). Reportar un error 3.2 .2 .1 . Co nfiguració n de l adm inist rado r de t ransaccio ne s para Re d Hat JBo ss We b Se rve r 2 .0 (T o m cat 7 ) 1. Extraiga el paquete zip genérico implementable que descargó del Portal del cliente de Red Hat. Este paquete zip contiene dos archvos zip más: jbo ss-bpms-eng i ne. zi p y jbo ssbpms-manag er. zi p. 2. Extraiga el contenido del archivo jbo ss-bpms-manag er. zi p en una ubicación temporal. Este archivo zip contiene dos carpetas archivadoras de aplicaciones de red: busi nesscentral . war y d ashbui l d er. war en formatos expandidos y estas están ahora en su ubicación temporal. Vuelva a nombrar estas carpetas para borrar la extensión . war. Copie ambas carpetas directamente bajo la carpeta $TOMCAT_DIR/webapps. Al final debe tener dos carpetas en formato expandido: $TOMCAT_DIR/webapps/busi ness-central y $TOMCAT_DIR/webapps/d ashbui l d er. Nota $TOMCAT_DIR se refiere al directorio de inicio en donde se encuentra su servidor de red. Reemplácelo con la ruta a su directorio de inicio del servidor de red, por ejemplo: /ho me/jo hn/jbo ss-ews-2. 0 /to mcat7/ 15 Suit e BPM JBoss de Red Hat 6 .0 G uía de inicio 3. Extraiga la carpeta jbo ss-bpms-eng i ne del archivador jbo ss-bpms-eng i ne. zi p a una ubicación temporal desde donde puede copiar las bibliotecas requeridas. Esta carpeta ahora contiene todas las abibliotecas centrales BPMS bajo la carpeta extraída y una carpeta l i b. 4. In st ale el g est o r d e t ran saccio n es. Copie las siguientes bibliotecas jar del administrador de transacciones de la carpeta l i b en donde extrajo las bibliotecas jbo ss-bpms-eng i ne al directorio $TOMCAT_DIR/l i b/: btm-VERSION.jar btm-tomcat55-lifecycle-VERSION.jar jta-VERSION.jar slf4j-api-VERSION.jar slf4j-ext-VERSION.jar Además descargue la siguiente biblioteca y cópiela en la carpeta $TOMCAT_DIR/l i b/ también: javax.security.jacc-api.jar 5. Instale el controlador en su base de datos: copie el archivo jar con el controlador de la base de datos relevante en $TOMCAT_DIR/l i b/. Controlador para la base de datos H2 incluída Si utiliza la base de datos H2 incluída, el controlador está disponible en busi nesscentral /WEB-INF/l i b/. 6. Cree los archivos de configuración del gestor de transacciones en $TOMCAT_DIR/co nf/: btm-config.properties bitro nix.tm .serverI d=to m cat-btm -no de0 bitro nix.tm .jo urnal.disk.lo gP art1Filenam e=$ {btm .ro o t}/wo rk/btm 1.tlo g bitro nix.tm .jo urnal.disk.lo gP art2Filenam e=$ {btm .ro o t}/wo rk/btm 2.tlo g bitro nix.tm .reso urce.co nfiguratio n=$ {btm .ro o t}/co nf/reso urces.pro perties resources.properties (el resource.ds1.uniqueName define el nombre de la fuente de datos utilizado después en la definición de recursos tomcat - tome nota de este valor). Asegúrese de cambiar los valores en las siguientes definiciones para que coincidan con su entorno. Ejemp lo 3.2. D ef in ició n d e la f u en t e d e d at o s H 2 reso urce.ds1.classNam e=bitro nix.tm .reso urce.jdbc.lrc.LrcXAD ataS o urce reso urce.ds1.uniqueNam e=jdbc/jbpm reso urce.ds1.m inP o o lS ize=10 reso urce.ds1.m axP o o lS ize=20 reso urce.ds1.driverP ro perties.driverClassNam e=o rg.h2.D river 16 Capít ulo 3. O pciones de inst alación reso urce.ds1.driverP ro perties.url=jdbc:h2:file:~/jbpm reso urce.ds1.driverP ro perties.user=sa reso urce.ds1.driverP ro perties.passwo rd= reso urce.ds1.allo wLo calT ransactio ns=true Ejemp lo 3.3. D ef in ició n d e la f u en t e d e d at o s MySQ L 5.5 reso urce.ds1.classNam e=co m .m ysql.jdbc.jdbc2.o ptio nal.M ysqlXAD ataS o urce reso urce.ds1.uniqueNam e=jdbc/jbpm reso urce.ds1.m inP o o lS ize=0 reso urce.ds1.m axP o o lS ize=10 reso urce.ds1.driverP ro perties.U R L=jdbc:m ysql://lo calho st:330 6 /sam pledb reso urce.ds1.driverP ro perties.user=dbuser reso urce.ds1.driverP ro perties.passwo rd=dbpasswo rd reso urce.ds1.allo wLo calT ransactio ns=true Ejemp lo 3.4 . D ef in ició n d e la f u en t e d e d at o s D B 2 T yp e 4 reso urce.ds1.classNam e=co m .ibm .db2.jcc.D B 2D river reso urce.ds1.uniqueNam e=jdbc/jbpm reso urce.ds1.m inP o o lS ize=0 reso urce.ds1.m axP o o lS ize=10 reso urce.ds1.driverP ro perties.U R L=jdbc:db2://lo calho st:50 0 0 0 /sam pledb reso urce.ds1.driverP ro perties.user=dbuser reso urce.ds1.driverP ro perties.passwo rd=dbpasswo rd reso urce.ds1.allo wLo calT ransactio ns=true Ejemp lo 3.5. D ef in ició n d e la f u en t e d e d at o s O racle reso urce.ds1.classNam e=o racle.jdbc.xa.client.O racleXAD ataS o urce reso urce.ds1.uniqueNam e=jdbc/jbpm reso urce.ds1.m inP o o lS ize=0 reso urce.ds1.m axP o o lS ize=10 reso urce.ds1.driverP ro perties.U R L=jdbc:o racle:thin:@ //lo calho st:1521/bpm s reso urce.ds1.driverP ro perties.user=dbuser reso urce.ds1.driverP ro perties.passwo rd=dbpasswo rd reso urce.ds1.allo wLo calT ransactio ns=true Ejemp lo 3.6 . D ef in ició n d e la f u en t e d e d at o s d el servid o r Micro so f t SQ L reso urce.ds1.classNam e=co m .m icro so ft.sqlserver.jdbc.S Q LS erverD river reso urce.ds1.uniqueNam e=jdbc/jbpm reso urce.ds1.m inP o o lS ize=0 reso urce.ds1.m axP o o lS ize=10 reso urce.ds1.driverP ro perties.U R L=jdbc:sqlserver://lo calho st:1433;databas eNam e=bpm s; reso urce.ds1.driverP ro perties.user=dbuser reso urce.ds1.driverP ro perties.passwo rd=dbpasswo rd reso urce.ds1.allo wLo calT ransactio ns=true 7. Configure el escucha del gestor de transacciones en $TOMCAT_DIR/co nf/server. xml para iniciar y detener Bitronix en el arranque y detención del contenedor: Agregue el siguiente elemento como el último elemento <Listener> en el elemento <Server>: 17 Suit e BPM JBoss de Red Hat 6 .0 G uía de inicio < Listener classNam e="bitro nix.tm .integratio n.to m cat55.B T M LifecycleListener" /> 8. D efina la propiedad del sistema btm.root y la ubicación en donde se ubica el archivo de configuración bitronix: En $TOMCAT_DIR/bi n/ cree el archivosetenv. sh con el siguiente contenido: CAT ALI NA_O P T S ="-Xm x512M -XX:M axP erm S ize=512m -D btm .ro o t=$ CAT ALI NA_HO M E D bitro nix.tm .co nfiguratio n=$ CAT ALI NA_HO M E/co nf/btm -co nfig.pro perties D o rg.jbpm .designer.perspective=R uleFlo w" Otorgue permisos de ejecución de archivos si aplica. La última propiedad o rg . jbpm. d esi g ner. perspecti ve se establece como R ul eFl o w para permitir que la perspectiva predeterminada para el diseñador sea R ul eFl o w en lugar de Ful l . T omcat en sistemas Microsoft Windows En sistemas Microsoft Windows reemplace el valor $C AT ALINA_HO ME en el contenido del archivo con el nombre de la variable de entorno equivalente o use la ruta absoluta y agregue los valores en el archivo setenv. bat tal como se muestra en el siguiente ejemplo: set "CAT ALI NA_O P T S =-Xm x512M -XX:M axP erm S ize=512m -D btm .ro o t=C:/T o m cat -D bitro nix.tm .co nfiguratio n=C:/T o m cat/co nf/btm -co nfig.pro perties D o rg.jbpm .designer.perspective=R uleFlo w" Reportar un error 3.2 .2 .2 . Co nfiguració n de una ce nt ral e m pre sarial para Re d Hat JBo ss We b Se rve r 2 .0 (T o m cat 7 ) Para establecer la central empresarial haga lo siguiente: 1. Establezca una Val ve de manera que la aplicación de red de la central empresarial pueda cargar la configuración de los usuarios en Tomcat: a. D efina los usuarios y roles en $TOMCAT_DIR/co nf/to mcat-users. xml . Note que la central empresarial requiere que los usuarios tengan los roles especificados como ad mi n y/o anal yst (fpara mayor información sobre definiciones de roles y usuarios consulte la documentación de Tomcat 7). El programa listado a continuación muestra un ejemplo de la manera en que estos dos roles se agregarían y cómo se le asignará estos roles al usuario llamado bpmsad mi n. < ro le ro lenam e="adm in"/> < ro le ro lenam e="analyst" /> < user usernam e="bpm sadm in" passwo rd="P @ ssw0 rd" ro les="adm in,analyst"/> 18 Capít ulo 3. O pciones de inst alación b. Copie ki e-to mcat-i nteg rati o n-VERSION. jar de $TOMCAT_DIR/webapps/busi ness-central /WEB-INF/l i b/ a $TOMCAT_DIR/l i b/. c. Copie jaxb-api -VERSION. jar de $TOMCAT_DIR/webapps/busi nesscentral /WEB-INF/l i b/ a $TOMCAT_DIR/l i b/. d. En $TOMCAT_DIR/co nf/server. xml agregue la declaración de la válvula Tomcat en el elemento relevante <host>: < Valve classNam e="o rg.kie.integratio n.to m cat.JACCValve" /> e. En $TOMCAT_DIR/webapps/busi ness-central /WEB-INF/web. xml borre el comentario de las entradas marcadas con el comentario T O MC AT -JEE-SEC UR IT Y . f. Configure la fuente de autenticación tomcat: en el directorio $TOMCAT_DIR/webapps/busi ness-central /WEB-INF/cl asses/MET AINF/servi ces/, renombre los siguientes archivos: o rg . uberfi re. securi ty. auth. Authenti cati o nSo urce como o rg . uberfi re. securi ty. auth. Authenti cati o nSo urce-O R IG IN y o rg . uberfi re. securi ty. auth. Authenti cati o nSo urce-T O MC AT -JEESEC UR IT Y como o rg . uberfi re. securi ty. auth. Authenti cati o nSo urce: # Co m ando de ejem plo si ejecuta este desde el directo rio $ T O M CAT _D I R /webapps $ m v business-central/WEB -I NF/classes/M ET AI NF/services/o rg.uberfire.security.auth.Authenticatio nS o urce businesscentral/WEB -I NF/classes/M ET AI NF/services/o rg.uberfire.security.auth.Authenticatio nS o urce-O R I G I N $ m v business-central/WEB -I NF/classes/M ET AI NF/services/o rg.uberfire.security.auth.Authenticatio nS o urce-T O M CAT JEE-S ECU R I T Y business-central/WEB -I NF/classes/M ET AI NF/services/o rg.uberfire.security.auth.Authenticatio nS o urce g. En $TOMCAT_DIR/webapps/busi ness-central /WEB-INF/beans. xml borre el comentario JAASUserG ro upInfo P ro d ucer y agregue el comentario o rg . jbpm. ki e. servi ces. cd i . pro d ucer. D efaul tUserG ro upInfo P ro d uce r (opcional). La parte al ternati ves de este archivo se debe ver así: < alternatives> < ! -< class> o rg.jbpm .kie.services.cdi.pro ducer.D efaultU serG ro upI nfo P ro ducer < /class> --> < ! -- unco m m ent JAAS U serG ro upI nfo P ro ducer when using JEE security o n T o m cat --> < class> o rg.jbpm .kie.services.cdi.pro ducer.JAAS U serG ro upI nfo P ro ducer< /c lass> < /alternatives> 2. Si está usando una fuente de datos diferente de la predeterminada proporcionada por la base de datos H2 subyacente necesitará configurar la persistencia. Si está utilizando la base de datos H2 predeterminada entonces puede ignorar el resto de pasos en este procedimiento. 19 Suit e BPM JBoss de Red Hat 6 .0 G uía de inicio En este procedimiento se configura una fuente de datos con el nombre JND I jd bc/myD ataso urce tal como se define en uniqueName=jdbc/jbpm en el archivo bitronix reso urces. pro perti es (para la opción MySQL): a. En busi ness-central /MET A-INF/co ntext. xml reemplace el nombre JND I de la fuente de datos en el elemento <Resource>. El atributo uniqueName se refiere a la propiedad resource.ds1.uniqueName establecida en reso urces. pro perti es: < R eso urce nam e="jdbc/m yD ataso urce" uniqueNam e="jdbc/jbpm " auth="Co ntainer" rem o veAbando ned="true" facto ry="bitro nix.tm .reso urce.R eso urceO bjectFacto ry" type="javax.sql.D ataS o urce"/> b. En busi ness-central /WEB-INF/web. xml reemplace el nombre JND I de la fuente de datos en el elemento <res-ref-name> con su nombre de fuente de datos: < reso urce-ref> < descriptio n> Co nso le D S < /descriptio n> < res-ref-nam e> jdbc/m yD ataso urce< /res-ref-nam e> < res-type> javax.sql.D ataS o urce< /res-type> < res-auth> Co ntainer< /res-auth> < /reso urce-ref> c. Cambie busi ness-central /WEB-INF/cl asses/MET A-INF/persi stence. xml . En este archivo cambie el nombre del dialecto hibernate utilizado para su base de datos si está utilizando una base de datos diferente de H2. El código a continuación demuestra la información de la base de datos original para persi stence. xml : < pro perty nam e="hibernate.dialect" value="o rg.hibernate.dialect.H2D ialect"/> Esta información se puede actualizar de la siguiente manera (tal como se demuestra con la base de datos MySQL a continuación): < pro perty nam e="hibernate.dialect" value="o rg.hibernate.dialect.M yS Q LD ialect"/> Nota El dialecto para D B2 es o rg . hi bernate. d i al ect. D B2D i al ect, para D B2 en AS/400 es o rg . hi bernate. d i al ect. D B24 0 0 D i al ect, para Oracle es o rg . hi bernate. d i al ect. O racl e10 g D i al ect y para el servidor Microsoft SQL es o rg . hi bernate. d i al ect. SQ LServerD i al ect d. Cambie el archivo busi ness-central /WEB-INF/cl asses/MET AINF/persi stence. xml de manera que la máquina de procesos BPMS pueda usar la nueva base de datos. El código a continuación demuestra la información de la fuente de datos original para persi stence. xml : < jta-data-so urce> java:co m p/env/jdbc/jbpm < /jta-data-so urce> Cambie este valor a la fuente de datos definida anteriormente: 20 Capít ulo 3. O pciones de inst alación < jta-data-so urce> java:co m p/env/jdbc/m yD ataso urce< /jta-data-so urce> 3. Ahora puede iniciar JBoss Web Server para iniciar sesión en la central empresarial. a. Ejecute startup. sh en el directorio $TOMCAT_HOME/bi n. ./startup.sh b. Navegue hasta http://localhost:8080/business-central en un navegador de red. c. Inicie sesión con el nombre de usuario/contraseña correctos tal como aparece en el archivo to mcat-users. xml en donde definió los roles de usuario. Reportar un error 3.2 .2 .3. Co nfiguració n de Dashbuilde r para Re d Hat JBo ss We b Se rve r 2 .0 (T o m cat 7) Para establecer un panel de construcción en el servidor de red JBoss Red Hat, haga lo siguiente: 1. D efinir usuarios y roles en $TOMCAT_DIR/co nf/to mcat-users. xml . Note que D ashbuilder requiere que los usuarios tengan el rol especificado como ad mi n y/o anal yst. Si ya definió estos usuarios para la central empresarial entonces no necesita definirlos de nuevo. 2. Habilitar el inicio de sesión único entre D ashbuilder y la central empresarial borrando el comentario de las siguientes líneas en el archivo $TOMCAT_DIR/co nf/server. xml : < Valve classNam e="o rg.apache.catalina.authenticato r.S ingleS ignO n" /> 3. Así como con la configuración de la central empresarial, si está utilizando una base de datos diferente de la base de datos H2 integrada y predeterminada entonces necesitará configurar la persistencia. En este procedimiento se configura una fuente de datos con el nombre JND I jd bc/d ashbui l d erD S tal como se define en uniqueName=jdbc/jbpm en el archivo bitronix reso urces. pro perti es: a. En d ashbui l d er/MET A-INF/co ntext. xml reemplace el nombre JND I de la fuente de datos en el elemento <Resource>. El atributo uniqueName se refiere a la propiedad resource.ds1.uniqueName establecida en reso urces. pro perti es: < R eso urce nam e="jdbc/dashbuilderD S " uniqueNam e="jdbc/jbpm " auth="Co ntainer" rem o veAbando ned="true" facto ry="bitro nix.tm .reso urce.R eso urceO bjectFacto ry" type="javax.sql.D ataS o urce"/> 21 Suit e BPM JBoss de Red Hat 6 .0 G uía de inicio Nota D ependiendo de su base de datos es posible que necesite definir algunas otras propiedades aquí también. Por ejemplo, en un entorno Oracle esta entrada puede verse como el siguiente listado. < R eso urce nam e="jdbc/jbpm " uniqueNam e="jdbc/jbpm " auth="Co ntainer" rem o veAbando ned="true" facto ry="bitro nix.tm .reso urce.R eso urceO bjectFacto ry" type="javax.sql.D ataS o urce" usernam e="usernam e" passwo rd="passwo rd" driverClassNam e="o racle.jdbc.xa.client.O racleXAD ataS o urce" url="jdbc:o racle:thin:Y O U R -U R L:1521:Y O U R -D B " m axActive="8 " /> b. En d ashbui l d er/WEB-INF/web. xml agregue el nombre JND I de la fuente de datos en el elemento <res-ref-name> con su nombre de fuente de datos: < reso urce-ref> < descriptio n> D ashbo ard B uilder D ataso urce< /descriptio n> < res-ref-nam e> jdbc/dashbuilderD S < /res-ref-nam e> < res-type> javax.sql.D ataS o urce< /res-type> < res-auth> Co ntainer< /res-auth> < /reso urce-ref> c. En d ashbui l d er/MET A-INF/co ntext. xml defina la fábrica de transacciones: < T ransactio n facto ry="bitro nix.tm .B itro nixU serT ransactio nO bjectFacto ry"/> d. Actualice el nombre JND I de la fuente de datos en d ashbui l d er/WEBINF/etc/hi bernate. cfg . xml en el elemento <session-factory>: < pro perty nam e="co nnectio n.dataso urce"> java:/co m p/env/jdbc/dashbuilderD S < /pro per ty> 4. Reinicie el servidor de red Java para que los cambios tengan efecto. Una vez reiniciado puede navegar al D ashbuilder desde la central empresarial o directamente a través de: http: //l o cal ho st: 80 80 /d ashbui l d er. Reportar un error 3.3. Inicio del servidor Si ha instalado BPMS usando ya sea el instalador o por medio de la instalación agrupada EAP6 entonces ahora puede iniciar su servidor en uno de dos modos disponibles. 22 Capít ulo 3. O pciones de inst alación Nota Si instaló BPMS usando la versión implementable genérica en el servidor de red Java de Red Hat, las instrucciones para descargar e instalar también contienen las instrucciones para iniciar el servidor. Puede ignorar la siguiente discusión. El script de arranque predeterminado, stand al o ne. sh con el que se envía la suite BPMJBoss de Red Hat está optimizado para rendimiento. Para ejecutar su servidor en modo de rendimiento, haga lo siguiente: 1. En la línea de comandos vaya al directorio $SERVER_HOME/bi n/. 2. En un entorno Unix ejecute: ./standalo ne.sh En un entorno Windows ejecute: ./standalo ne.bat La suite BPMJBoss Red Hat también se envía con un script separado, stand al o ne-secure. sh que está optimizado para la seguridad. Este script aplica una política de seguridad por defecto que protege en contra de alguna vulnerabilidad de seguridad conocida. Nota Se recomienda que los entornos de producción utilicen el script stand al o ne-secure. sh. Aviso El uso de un administrador de seguridad impone una sanción importante en el rendimiento que debe tener en mente. El intercambio entre la seguridad y el rendimiento se debe realizar teniendo en consideración las circunstancias individuales. Consulte Sección 3.4, “ Administrador de seguridad Java y gestión de rendimiento” . Para ejecutar su servidor en el modo seguro con este script, haga lo siguiente: 1. En la línea de comandos vaya al directorio $SERVER_HOME/bi n/. 2. En un entorno Unix ejecute: ./standalo ne-secure.sh En un entorno Windows ejecute: ./standalo ne-secure.bat Reportar un error 3.4 . Administ rador de seguridad Java y gest ión de rendimient o 23 Suit e BPM JBoss de Red Hat 6 .0 G uía de inicio 3.4 . Administ rador de seguridad Java y gest ión de rendimient o Como se observó anteriormente el habilitar el administrador de seguridad Java (JSM del inglés Java Security Manager) como un entorno de pruebas completo para la evaluación de scripts MVEL en BPMS introduce una penalidad de rendimiento en entornos de alta carga. Se deben tener en cuenta los marcadores de entorno y de rendimiento al implementar una aplicación BPMS. Use las siguientes directrices para implementar aplicaciones BPMS seguras y de alto rendimiento. En entornos de alto rendimiento en donde el rendimiento es crítico se recomienda que sólo se implementen aplicaciones que hayan sido desarrolladas en otros sistemas y que hayan sido revisadas apropiadamente. También se recomienda no crear ningún usuario con el rol Analyst en dichos sistemas. Si se toman en cuenta estas medidas entonces es seguro el dejar JSM deshabilitado en estos sistemas de manera que no introduzca ninguna degradación del rendimiento. En entornos de prueba y desarrollo sin altas cargas o en entornos en donde la autoría de reglas y procesos está expuesta a redes externas, se recomienda tener JSM habilitado con el fin de lograr beneficios de seguridad de una evaluación completa del entorno de prueba de MVEL. No es seguro y no se recomienda el permitir que usuarios con el rol Analyst inicien sesión en la consola central empresarial con JSM inhabilitado. Reportar un error 24 Capít ulo 4 . Inicio de sesión en la cent ral empresarial Capítulo 4. Inicio de sesión en la central empresarial Inicio de sesión en la central empresarial después de que el servidor ha iniciado exitósamente. 1. Navegue hasta http://localhost:8080/business-central en un navegador de red. Si la interfaz se ha configurado para ejecutar desde un nombre de dominio, substituya l o cal ho st para el nombre del dominio. Por ejemplo http://www.example.com:8080/business-central. 2. Inicie sesión con las credenciales de usuario que se crearon durante la instalación. Por ejemplo: User = hel l o wo rl d user and password = Hel l o wo rl d @ 123. Reportar un error 25 Suit e BPM JBoss de Red Hat 6 .0 G uía de inicio Capítulo 5. Proyecto Hello World Para demostrar las funcionalidades básicas de la suite BPM JBoss Red Hat, este capítulo le mostrará cómo configurar el proyecto Hel l o Wo rl d con un proceso empresarial Hel l o Wo rl d . Todo lo que este proceso empresarial hará es presentar el mensaje Hel l o Wo rl d ! y terminar la ejecución. Tendrá que hacer lo siguiente: 1. Cree un repositorio Hello World en el repositorio Artifact. 2. Cree el proyecto Hello World con la definición del proceso empresarial con la definición del proceso empresarial Hel l o Wo rl d . 3. Modele la lógica del proceso Hello World en el proceso empresarial usando la herramienta del diseñador de procesos gráfico. 4. Construya e implemente el proyecto en la máquina de ejecución ejecutando localmente. 5. Ejecute el proceso Hello World. 6. Monitoree la ejecución del proceso. Reportar un error 5.1. Creación de una est ruct ura de reposit orio Todos los activos empresariales viven en repositorios que viven en unidades organizacionales, los cuales son directorios en el repositorio Artifact. Por defecto, el repositorio Artifact no contiene ninguna unidad organizacional. Por lo tanto, para poder crear sus propios activos empresariales tal como un proceso empresarial, necesita crear una unidad organizacional en el repositorio Artifact y un repositorio (Git) en el. Luego el repositorio puede contener su proyecto. Un proyecto puede contener una estructura de paquete arbitraria, la cual le permite estructurar su contenido en una estructura lógica de " directorio" . Cualquier paquete puede contener sus activos empresariales (para mayor información sobre el repositorio Artifact consulte la Red Hat JBoss BRMS User Guide). Para crear la estructura del repositorio, haga lo siguiente: 1. Abra la central empresarial en su navegador de red (si está ejecutando localmente http://localhost:8080/business-central) e inicie sesión como usuario con el rol ad mi n (hel l o wo rl d user). 2. Cree una unidad organizacional en el repositorio Artifact: a. Vaya a Au t h o rin g → Ad min ist rat io n . b. En el menú de perspectivas haga clic en O rg an iz at io n al U n it s → Man ag e O rg an iz at io n al U n it s. c. En la vista que se presenta O rg ani zati o nal Uni t Manag er haga clic en Ad d . En la ventana que se presenta Ad d New O rg ani zati o nal Uni t defina las propiedades de las unidades y haga clic en O K: Nombre: hel l o wo rl d Propietario: hel l o wo rl d user 26 Capít ulo 5. Proyect o Hello World 3. Cree un nuevo repositorio en la unidad organizacional helloworld: a. Vaya a Au t h o rin g → Ad min ist rat io n . b. En el menú de perspectivas haga clic en R ep o sit o ries → N ew rep o sit o ry. c. En la ventana que se presenta C reate R epo si to ry defina las propiedades del repositorio: Nombre del repositorio: hel l o wo rl d repo Unidad organizacional: hel l o wo rl d 4. Vaya a Au t h o rin g → Pro ject Au t h o rin g . 5. En el explorador de proyectos en la casilla desplegable de la unidad organizacional, seleccione hel l o wo rl d y en la casilla desplegable del repositorio seleccione hel l o wo rl d repo . Fig u ra 5.1. Seleccio n e el rep o sit o rio hel l o wo rl d repo en el g ru p o o rg an iz acio n al hel l o wo rl d en el exp lo rad o r d e p ro yect o s 6. Cree un proyecto en el repositorio hel l o wo rl d : a. En el menú de perspectivas vaya a N ew It em → Pro ject b. En la ventana que se presenta C reate new defina sus propiedades del proyecto: Nombre del recurso (nombre del proyecto): Hel l o Wo rl d Ruta: d efaul t: //master@ hel l o wo rl d repo / c. En el diálogo New P ro ject Wi zard defina las propiedades maven del proyecto. Presione Intro después de realiza cada entrada: Id del grupo: o rg . jbpm Id del arterfacto: Hel l o Wo rl d Id de la versión: 1. 0 27 Suit e BPM JBoss de Red Hat 6 .0 G uía de inicio d. Haga clic en Fi ni sh. Reportar un error 28 Capít ulo 6 . Proceso Hello World Capítulo 6. Proceso Hello World En este capítulo continuaremos con el ejemplo de Hello World y crearemos todo un proceso empresarial para demostrar la creación de un proceso básico Hello World. Reportar un error 6.1. Creación de procesos empresariales Para crear una nueva definición de proceso empresarial haga lo siguiente: 1. Utilice la perspectiva de autoría de proyectos (Au t h o rin g → Pro ject Au t h o rin g ) . 2. En la vista del explorador de proyectos a la izquierda, seleccione la unidad organizacional hel l o wo rl d , el repositorio hel l o wo rl d repo , el proyecto Hel l o Wo rl d y el paquete org.jbpm: esto define la ubicación en el repositorio Artifact, en donde creará su definición de proceso empresarial. Selección de paquetes Asegúrese de seleccionar el paquete org.jbpm. El seleccionar un paquete incorrecto hace que la implementación falle. 3. En el menú de perspectivas haga clic en N ew It em → B u sin ess Pro cess y defina los detalles de la definición de procesos: Ingrese el nombre del recurso como Hel l o Wo rl d . 4. Haga clic en Aceptar. Se abre el diseñador de procesos con la vista de la definición del proceso creado. Reportar un error 6.2. Modelado de procesos empresariales D espués de haber creado la definición de procesos empresariales, puede diseñar el proceso empresarial en el diseñador de procesos empresariales: el diseñador del proceso empresarial debe estar abierto en una pestaña a la derecha. Si cerró la pestaña, en el explorador de proyectos haga clic en Hel l o Wo rl d bajo Busi ness P ro cesses para volver a abrir el diseñador de procesos empresariales. Asegúrese de seleccionar el paquete correcto (org.jbpm.helloworld). Para diseñar el contenido del proceso, haga lo siguiente: 1. Amplie la paleta O bject Li brary con los elementos del proceso: haga clic en el botón con doble flecha ( empresariales. ) en la esquina superior izquierda de la pestaña del diseñador de procesos 2. Aparece un elemento de inicio del evento. 3. Haga clic en el elemento de inicio del evento: los objetos de enlace rápido aparecen alrededor del nodo. Haga clic en el ícono de la tarea ( ) para crear un flujo de secuencia saliente y un elemento de tarea conectado al inicio del evento. 29 Suit e BPM JBoss de Red Hat 6 .0 G uía de inicio 4. Cree un evento temporizador: de la paleta arrastre y deje caer el T i mer (bajo C atchi ng Intermed i ate Events) y conecte la tarea al elemento temporizador usando el menú de enlace rápido. 5. Cree el elemento Terminar evento conectado al elemento Evento temporizador (ya sea usando la funcionalidad de enlace rápido o arrastrándolo de la paleta). Fig u ra 6 .1. B o rrad o r d el p ro ceso H ello Wo rld Reportar un error 6.3. Definición de propiedades del element o Ahora necesita definir las propiedades del elemento: 1. Haga clic en la doble flecha ( P ro perti es. ) en la esquina superior derecha para expandir la pestaña 2. Haga clic en cualquier parte. La pestaña P ro perti es presenta las propiedades del proceso Hel l o Wo rl d . Las propiedades requeridas son pre-definidas; sin embargo, puede cambiar sus valores si es necesario. 3. El elemento de inicio y el elemento para terminar solo tienen propiedades opcionales. Sin embargo, los elementos tareas necesitan su tipo y propiedades específicas de tipo definidas: haga clic en el elemento tarea y defina las propiedades requeridas: Name: Scri ptT ask Task Type: Scri pt Script Language: java Script: System. o ut. pri ntl n("Hel l o Wo rl d ! "); Haga clic en Aceptar. Ha definido una tarea que realizará un script durante la ejecución. El script está definido en Java y ejecuta el método System. o ut. pri ntl n("Hel l o Wo rl d ! ");, eso significa que escribirá Hel l o Wo rl d ! en la salida estándar del servidor (por defecto, la salida estándar del servidor es la consola en la que se inició el servidor). 4. Todavía necesita definir propiedades del evento temporizador para hacer que el proceso espere en tiempo de ejecución de manera que usted pueda inspeccionar su ejecución: haga clic en el elemento temporizador y defina las propiedades requeridas: Time Cycle Language: C ro n 30 Capít ulo 6 . Proceso Hello World D uration: 1m y presione Intro. Por lo tanto el proceso esperará por un minuto en el evento temporizador después de que ejecuta la tarea script. 5. Nombre el evento temporizador por medio de las propiedades y luego guarde su proceso: abra el menú Save ( ) y haga clic en Save. 6. Haga click en el botón ( ) en la barra de herramientas del diseñador de procesos con el proceso para asegurarse de que el proceso definido es válido. El esquema de cualquier elemento con uno o múltiples errores de validación se vuelve naranja (consulte la Red Hat JBoss BPMS User Guide para obtener información sobre la funcionalidad de validación). Para obtener mayor información sobre los elementos de procesos y sus propiedades consulte la JBoss BPMS User Guide. Reportar un error 6.4 . Const rucción e implement ación Antes de poder instanciar, es decir, ejecutar su proceso Hel l o Wo rl d , necesita construir todo el proyecto e implementarlo en el servidor de ejecución: 1. En el menú principal de la central empresarial vaya a Au t h o rin g → Pro ject Au t h o rin g . 2. En el explorador de proyectos ubique el proyecto Hello World. 3. Abra el proyecto en el editor de proyectos: en el menú de perspectivas haga clic en T o o ls → Pro ject Ed it o r. 4. Verifique que los detalles del proyecto estén correctos en el P ro ject Screen y haga clic en el botón Bui l d & D epl o y en la esquina superior derecha de la vista de la pantalla del proyecto. Fig u ra 6 .2. Ed it o r d e p ro yect o s co n las sig u ien t es p ro p ied ad es d el p ro yect o h ello Wo rld 31 Suit e BPM JBoss de Red Hat 6 .0 G uía de inicio Aparecerá una notificación en verde en la parte superior de la pantalla informándole que el proyecto se ha construído e implementado en el servidor de ejecuciones y está disponible para instanciación. Reportar un error 6.5. Inst anciación de procesos empresariales Para crear una instancia del proceso Hel l o Wo rl d , es decir, ejecutar el proceso empresarial, haga lo siguiente: 1. Haga clic en Pro cess Man ag emen t → Pro cess D ef in it io n s en el menú principal. 2. En la pestaña P ro cess D efi ni ti o ns que se presenta ubique el Hel l o Wo rl d . Es posible que tenga que hacer clic en R efresh para que la implementación se pueda ver en la lista. 3. Haga clic en el botón Start( ) al lado de la entrada de la definición del proceso y en la casilla Fo rm haga clic en el botón play ( proceso. ) para confirmar que quiere instanciar el El proceso se instancia con el usuario que actualmente está en sesión como propietario del proceso y el formato del proceso se presenta (el formato puede servir para solicitar entrada de un usuario en la instanciación de procesos si está definido; consulte la Red Hat JBoss BPMS User Guide). Se presenta la vista P ro cess Instance D etai l s con los detalles sobre la instancia del proceso iniciado. Aparece el mensaje Hel l o Wo rl d ! en la salida estándar, usualmente el emulador terminal en el que se inició el servidor. Luego la instancia del proceso espera por el evento temporizador. Haga clic en Vi ews - P ro cess Mo d el para ver el estado actual de ejecución. Fig u ra 6 .3. D iag rama d e ejecu ció n en t iemp o real H ello Wo rld : el even t o t emp o riz ad o r en ejecu ció n Reportar un error 32 Capít ulo 6 . Proceso Hello World 6.6. Cancelación de procesos empresariales En este momento está ejecutando una instancia del proceso Hel l o Wo rl d en el servidor de ejecución (siendo ejecutado). Puede chequear la vista P ro cess Instances: para presentar la vista vaya a Pro cess Man ag emen t → Pro cess In st an ces. D esde aquí puede ver los detalles de cualquier instancia de procesos usando el botón de detalles ( ) y realizar acciones de administración básicas tal como enviar una señal a una instancia de proceso ( ) y cancelarla ( ). Ya que la instancia del proceso Hel l o Wo rl d está esperando por el evento temporizador, cancélela: haga clic en ( ) en la línea con la información sobre la instancia del proceso Hel l o Wo rl d : la instancia desaparecerá de la lista de instancias de procesos activos y aparecerá en la lista de instancias Abo rted . Fig u ra 6 .4 . In st an cias d e p ro ceso s can celad o s in clu yen d o la in st an cia d el p ro ceso H ello Wo rld Reportar un error 33 Suit e BPM JBoss de Red Hat 6 .0 G uía de inicio Capítulo 7. Reglas empresariales Hello World Ya que BPMS viene con BRMS integrado, este capítulo proporciona una introducción a la manera en que funcionan las reglas empresariales y cómo se integran en BPMS. Agregará una nueva tarea, una tarea de regla empresarial al proceso HelloWorld, el cual disparará una regla empresarial de un grupo de reglas empresariales particular. Note que este es un caso de integración muy simple y en producción puede que necesite un concepto y técnicas más avanzadas tal como tablas de decisiones. Para mayor información sobre las reglas empresariales y BRMS consulte la Red Hat JBoss BRMS User Guide Reportar un error 7.1. Creación de la regla empresarial Las reglas empresariales se definen como declaraciones cuando-entonces: cuando algo es verdadero entonces algo pasa (por ejemplo, cuando la persona es mayor de 18 años, pueden acceder el contenido particular). Las reglas empresariales se almacenan en archivos D RL. Para definir la regla empresarial hel l o wo rl d rul e en el proyecto Hel l o Wo rl d haga lo siguiente: 1. En el P ro ject Expl o rer seleccione la unidad organizacional hel l o wo rl d , el repositorio hel l o wo rl d repo , el proyecto Hel l o Wo rl d y el paquete default. Selección de paquetes Asegúrese de seleccionar el paquete default. El seleccionar un paquete incorrecto causa que la implementación falle. 2. Crear el archivo D RL: a. En el menú de perspectivas haga clic en N ew It em → D R L f ile. b. En la casilla C reate new defina el nombre del recurso como hel l o wo rl d rul e y verifique que la ruta destino sea d efaul t: //master@ hel l o wo rl d repo /Hel l o Wo rl d /src/mai n/reso urces. c. Haga clic en Aceptar. 3. En el editor D RL que se presenta con el archivo hel l o wo rl d rul e. d rl defina la regla: rule "hello wo rldrule" ruleflo w-gro up "hello wo rldgro up" when then S ystem .o ut.println("Hello Wo rld! "); end Esta regla no define ninguna condición cuando, es decir que siempre será verdadera cuando se dispare (llamada a ejecutar) y se imprimirá la frase Hel l o Wo rl d ! . 4. Haga clic en Save. 34 Capít ulo 7 . Reglas empresariales Hello World 5. Se presenta un campo Save thi s i tem. Ingrese el C heck-i n co mment y haga clic en guardar. Nota El comentario de registro sería una descripción corta de la clase de cambio que realizó y se tiene que ingresar cada vez que se guarda un activo. Reportar un error 7.2. Agregación de la t area de reglas empresariales Una tarea de reglas empresariales es una tarea que dispara reglas que pertenecen a cierto grupo de flujo de reglas. Para agregar una tarea de reglas empresariales a su proceso, haga lo siguiente: 1. Abra su proceso empresarial en el diseñador de procesos: en P ro ject Expl o rer seleccione el proyecto Hel l o Wo rl d , el paquete org.jbpm, haga clic en BUSINESS P R O C ESSES y haga clic en el proceso Hel l o Wo rl d . Selección de paquetes Asegúrese de seleccionar el paquete org.jbpm. El seleccionar un paquete incorrecto causa que la implementación falle. 2. En el diseñador de procesos empresariales que se presenta con el proceso helloworld, amplie la paleta O bject Li brary con los elementos del proceso: haga clic en el botón con doble flecha ( empresariales. ) en la esquina superior izquierda de la pestaña del diseñador de procesos 3. Amplie el menú T asks y arrastre y deje caer la tarea de reglas empresariales a la derecha. Ajuste las conecciones de flujo para integrar la tarea en el flujo de trabajo. 4. Seleccione la tarea de reglas empresariales y defina sus propiedades en el panel P ro perti es: Nombre: Busi nessR ul e Grupo de flujo de reglas: hel l o wo rl d g ro up La propiedad Ruleflow Group define el grupo de reglas que se deben disparar cuando se está ejecutando la tarea. En este ejemplo, solo una regla, la reglahel l o wo rl d g ro up definida en el archivo hel l o wo rl d rul e. d rl , está presente en el grupo hel l o wo rl d g ro up. 35 Suit e BPM JBoss de Red Hat 6 .0 G uía de inicio Fig u ra 7.1. El p ro ceso h ello wo rld co n la t area d e reg las emp resariales y su s p ro p ied ad es 5. Haga clic en el botón para guardar para mantener los cambios. Reportar un error 7.3. Const rucción e implement ación Construya todo el proyecto e impleméntelo en el servidor de ejecución: 1. En el menú principal de la central empresarial vaya a Au t h o rin g → Pro ject Au t h o rin g . 2. En el explorador de proyectos ubique el proyecto Hello World. 3. Abra el proyecto en el editor de proyectos: en el menú de perspectivas haga clic en T o o ls → Pro ject Ed it o r. 4. Verifique que los detalles del proyecto estén correctos en el P ro ject Screen y haga clic en el botón Bui l d & D epl o y en la esquina superior derecha de la vista de la pantalla del proyecto. 36 Capít ulo 7 . Reglas empresariales Hello World Fig u ra 7.2. Ed it o r d e p ro yect o s co n las sig u ien t es p ro p ied ad es d el p ro yect o h ello Wo rld Aparece una notificación en verde en la parte superior de la pantalla informándole que el proyecto se construyó e implementó en el servidor de ejecuciones y que está disponible para ser instanciado. Note que la versión anterior de la implementación hel l o Wo rl d se substituye con la nueva versión con la tarea de la regla empresarial. Para mantener ambas implementaciones, cambie el número de la versión del proyecto en el editor de proyectos. Reportar un error 7.4 . Inst anciación de procesos empresariales Para crear una instancia del proceso Hel l o Wo rl d , es decir, ejecutar el proceso empresarial, haga lo siguiente: 1. Haga clic en Pro cess Man ag emen t → Pro cess D ef in it io n s en el menú principal. 2. En la pestaña P ro cess D efi ni ti o ns que se presenta ubique el Hel l o Wo rl d . Es posible que tenga que hacer clic en R efresh para que la implementación se pueda ver en la lista. 3. Haga clic en el botón Start( ) al lado de la entrada de la definición del proceso y en la casilla Fo rm haga clic en el botón play ( proceso. ) para confirmar que quiere instanciar el El proceso se instancia con el usuario que actualmente está en sesión como propietario del proceso y el formato del proceso se presenta (el formato puede servir para solicitar entrada de un usuario en la instanciación de procesos si está definido; consulte la Red Hat JBoss BPMS User Guide). Se presenta la vista P ro cess Instance D etai l s con los detalles sobre la instancia del proceso iniciado. Aparece el mensaje Hel l o Wo rl d ! en la salida estándar, usualmente el emulador terminal en el que se inició el servidor. Luego la instancia del proceso espera por el evento temporizador. Haga clic en Vi ews - P ro cess Mo d el para ver el estado actual de ejecución. Fig u ra 7.3. D iag rama d e ejecu ció n en t iemp o real H ello Wo rld : el even t o t emp o riz ad o r en ejecu ció n 37 Suit e BPM JBoss de Red Hat 6 .0 G uía de inicio Reportar un error 38 Capít ulo 8 . BAM Capítulo 8. BAM 8.1. Acceso al const ruct or de páneles de la suit e BPM JBoss Red Hat El constructor de páneles es la interfaz de usuario basada en red de la suite BPM JBoss Red Hat para monitoreo de actividades empresariales. Para acceder el constructor de páneles desde la central empresarial vaya a D ash b o ard s → Pro cess & T ask D ash b o ard s. El pánel que se presenta proporciona estadísticas sobre los datos en tiempo de ejecución seleccionados a su izquierda. Puede crear su propio pánel en el constructor de páneles que se presenta al hacer clic en D ash b o ard s → B u sin ess D ash b o ard s. Reportar un error 8.2. Monit oriz ación de inst ancias El constructor de páneles proporciona un pánel especial que le permite monitorear el estado de los datos en tiempo de ejecución (instancias de procesos y tareas) en su máquina de ejecución. Para ver estos datos vaya a D ash b o ard s → Pro cess & T ask D ash b o ard . Fig u ra 8.1. Pán el d e t areas y p ro ceso s En el panel de la izquierda puede seleccionar una entidad para la cual presentar estadísticas. Las tablas y los datos a la derecha se actualizan de acuerdo con esto. Reportar un error 39 Suit e BPM JBoss de Red Hat 6 .0 G uía de inicio Capítulo 9. Estudio del desarrollador JBoss de Red Hat Red Hat JBoss D eveloper Studio es el entorno de desarrollo integrado de JBoss (ID E del inglés integrated development environment) basado en Eclipse y disponible en el portal de soporte del cliente de Red Hat en https://access.redhat.com. Red Hat JBoss D eveloper Studio proporciona plugins con herramientas e interfaces para Red Hat JBoss BRMS y Red Hat JBoss BPM Suite. Estos plugins se basan en la versión de la comunidad de estos productos. Así que el plugin BRMS se llama el plugin D rools y el plugin de la suite BPM se llama plugin jBPM. Consulte la documentación de Red Hat JBoss Developer Studio para ver las instrucciones de instalación y configuración. Reportar un error 9.1. Cent ral de JBoss Cuando se inicia por primera vez JBoss D eveloper Studio 7.0, se presenta la central de JBoss en la ventana principal del banco de trabajo. D esde la central de JBoss es posible crear nuevos proyectos seleccionando las opciones del menú bajo Start fro m scratch. Los proyectos de ejemplo se pueden iniciar seleccionando los enlaces bajo Start fro m a sampl e. Fig u ra 9 .1. C en t ral d e JB o ss 40 Capít ulo 9 . Est udio del desarrollador JBoss de Red Hat Reportar un error 9.2. Inst alación de los plugins del est udio del desarrollador JBoss Los plugins D rools y jBPM para el estudio desarrollador JBoss están disponibles a través del sitio de actualización. Pro ced imien t o 9 .1. In st alació n d el p lu g in d el est u d io d esarro llad o r JB o ss D ro o ls y jB PM 1. Inicie el estudio desarrollador JBoss. 2. Seleccione H elp → In st all N ew So f t ware. 3. Haga clic en Ad d para ingresar el menú Ad d R epo si to ry. 4. D ele un nombre al sitio software junto al campo Name y agregue la siguiente url en el campo Lo cati o n:https://devstudio.jboss.com/updates/7.0/integration-stack/ 5. Haga clic en O K 6. Seleccione la funcionalidad JBo ss Busi ness P ro cess and R ul e D evel o pment de las opciones disponibles y haga clic en Next y luego Next de nuevo. 7. Lea la licencia y acéptela seleccionando el botón apropiado y haga clic en Fi ni sh. 8. D espués de que la instalación de los plug-ins se haya completado, reinicie el estudio desarrollador JBoss. Reportar un error 9.3. Configuración del t iempo de ejecución Drools Con el fin de utilizar el plugin BRMS JBoss con Red Hat JBoss D eveloper Studio es necesario establecer el tiempo de ejecución. Un tiempo de ejecución es una colección de archivos jar que representan un lanzamiento específico del software y proporciona las bibliotecas que se necesitan para la compilación y ejecución de sus activos empresariales. Extraiga los archivos jar de tiempo de ejecución que se encuentran en el archivador jboss-brmsengine.zip del archivador zip implementable genérico JBoss BRMS (no el archivador zip implementable EAP6) (disponible en el portal del cliente de Red Hat). Pro ced imien t o 9 .2. C o n f ig u ració n d el t iemp o d e ejecu ció n B R MS 1. D el menú JBoss D eveloper Studiot seleccione Wi nd o w y haga clic en P references. 2. Seleccione D ro o ls → In st alled D ro o ls R u n t imes. 3. Haga clic en Ad d . . . ; proporcione un nombre para el nuevo tiempo de ejecución y haga clic en Bro wse para navegar al directorio en donde se encuentra el tiempo de ejecución. Haga clic en OK para registrar el tiempo de ejecución seleccionado en JBD S. 4. Marca el tiempo de ejecución que usted ha creado como el tiempo de ejecución D rools predeterminado haciendo clic en la casilla al lado de este. 41 Suit e BPM JBoss de Red Hat 6 .0 G uía de inicio 5. Haga clic en O K. Si tiene proyectos existentes, una ventana de diálogo indicará que tiene que reiniciar JBoss D eveloper Studio para actualizar el tiempo de ejecución. Reportar un error 9.4 . Configuración del t iempo de ejecución jBPM Con el fin de utilizar el plugin jBPM con Red Hat JBoss D eveloper Studio es necesario establecer el tiempo de ejecución. Un tiempo de ejecución es una colección de archivos jar que representan un lanzamiento específico del software. Si descargó previamente el archivador zip implementable genérico de la suite BPM JBoss del portal del cliente de Red Hat, los archivos jars que componen el tiempo de ejecución se encuentran en el archivador jbo ss-bpms-eng i ne. zi p. Pro ced imien t o 9 .3. C o n f ig u ració n d el t iemp o d e ejecu ció n jB PM 1. D el menú JBoss D eveloper Studiot seleccione Wi nd o w y haga clic en P references. 2. Seleccione jB PM → In st alled jB PM R u n t imes. 3. Haga clic en Ad d . . . ; proporcione un nombre para el nuevo tiempo de ejecución y haga clic en Bro wse para navegar al directorio en donde se encuentra el tiempo de ejecución. 4. Haga clic en O K, seleccione el nuevo tiempo de ejecución y haga clic en O K de nuevo . Si tiene proyectos existentes, una ventana de diálogo indicará que tiene que reiniciar JBoss D eveloper Studio para actualizar el tiempo de ejecución. Reportar un error 9.5. Configuración del servidor de la suit e BPM JBoss El estudio desarrollador JBoss se puede configurar para ejecutar el servidor de la suite BPM JBoss de Red Hat. Pro ced imien t o 9 .4 . C o n f ig u ració n d el servid o r 1. Abra la vista jBPM seleccionando Win d o w → O p en Persp ect ive → O t h er y seleccione D ro o l s y haga clic en O K. 2. Agregue la vista del servidor seleccionando Win d o w → Sh o w View → O t h er... y seleccione Server → Servers. 3. Abra el menú del servidor haciendo clic con el botón derecho del ratón en el panel del servidor y seleccione N ew → Server. 4. D efina el servidor seleccionando JB o ss En t erp rise Mid d leware → JB o ss En t erp rise Ap p licat io n Plat f o rm 6 .1+ y haciendo clic en Next. 5. Establezca el directorio de inicio haciendo clic en el enlace en el botón Bro wse. Navegue hasta el directorio de instalación y selecciónelo para JBoss EAP 6.1.1, el cual tiene la suite BPM JBoss instalada. 6. Proporcione un nombre para el servidor en el campo Name, asegúrese de que el archivo de configuración se establece como y haga clic en Fi ni sh. 42 Capít ulo 9 . Est udio del desarrollador JBoss de Red Hat Reportar un error 9.6. Import ación de proyect os desde un reposit orio Git a JBoss Developer St udio El estudio desarrollador JBoss se puede configurar para conectarse a un repositorio de activos Git central. En el repositorio se almacenan las versiones de las reglas, modelos, funciones y procesos. Este repositorio Git ya debe estar definido por el banco de trabajo KIE. Los usuarios pueden importar un repositorio local Git o pueden clonar un repositorio remoto Git. Pro ced imien t o 9 .5. Imp o rt ació n d e u n rep o sit o rio lo cal G it 1. Inicie la suite BPM JBoss de Red Hat (si todavía no está ejecutando) seleccionando el servidor de la pestaña de servidores y haga clic en el ícono de inicio. 2. Seleccione File → Imp o rt ... y navegue a la carpeta Git. Abra la carpeta Git para seleccionar Pro ject s f ro m G it y haga clic en siguiente. 3. Seleccione la fuente del repositorio Exist in g lo cal rep o sit o ry y haga clic en siguiente. Fig u ra 9 .2. D et alles d el rep o sit o rio G it 4. Seleccione el repositorio que se va a configurar de la lista de repositorios disponibles. 5. Importe el proyecto como un proyecto general en la siguiente ventana y haga clic en siguiente. D éle nombre a este proyecto y haga clic en terminar. Pro ced imien t o 9 .6 . C lo n ació n d e u n rep o sit o rio remo t o G it 43 Suit e BPM JBoss de Red Hat 6 .0 G uía de inicio 1. Inicie la suite BPM JBoss de Red Hat (si todavía no está ejecutando) seleccionando el servidor de la pestaña de servidores y haga clic en el ícono de inicio. 2. Al mismo tiempo inicie el servidor de la shell segura, si todavía no está ejecutando, usando el siguiente comando. Este comando es específico para Linux y Mac sólamente. En estas plataformas, si sshd ya se inició entonces este comando fallará y puede ignorar de manera segura este paso. /sbin/service sshd start 3. Seleccione File → Imp o rt ... y navegue a la carpeta Git. Abra la carpeta Git para seleccionar Pro ject s f ro m G it y haga clic en siguiente. 4. Seleccione la fuente del repositorio C lo n e U R I y haga clic en siguiente. 5. Ingrese los detalles del repositorio Git en la siguiente ventana y haga clic en siguiente. 44 Capít ulo 9 . Est udio del desarrollador JBoss de Red Hat Fig u ra 9 .3. D et alles d el rep o sit o rio G it 6. Seleccione la rama que quiere importar en la siguiente ventana y haga clic en siguiente. 7. Se le presentará la opción de definir el almacenamiento local para este proyecto. Ingrese (o seleccione) un directorio que no esté vacío, haga los cambios en la configuración y haga clic en siguiente. 8. Importe el proyecto como un proyecto general en la siguiente ventana y haga clic en siguiente. D éle nombre a este proyecto y haga clic en terminar. Reportar un error 9.7. Creación de un proyect o Drools Pro ced imien t o 9 .7. C reació n d e u n n u evo p ro yect o R ed H at JB o ss D evelo p er St u d io 1. D el menú principal seleccione File → N ew → Pro ject . Seleccione D ro o ls → D ro o ls Pro ject y haga clic en Next. 2. Ingrese un nombre para el proyecto en la casilla P ro ject name: y haga clic en Next. NOT A JBoss D eveloper Studio proporciona la opción para agregar un archivo de reglas HelloWorld de ejemplo al proyecto. Acepte esta opción predeterminada haciendo clic en Next para probar el proyecto de ejemplo en los siguientes pasos. 3. Seleccione el tiempo de ejecución D rools (o use el predeterminado). 4. Seleccione el código compatible con D ro o l s 6 . 0 . x. Ingrese un G ro upID , un Arti factID y la Versi o n y haga clic en Fi ni sh. 5. Para probar el proyecto, haga clic con el botón derecho del ratón en el archivo Java que contiene el método principal y seleccione R u n → ru n as → Java Ap p licat io n . La salida se presentará en la pestaña de la consola. Reportar un error 9.8. Creación de un proyect o jBPM Pro ced imien t o 9 .8. C reació n d e u n n u evo p ro yect o R ed H at JB o ss D evelo p er St u d io 1. D el menú principal seleccione File → N ew → Pro ject . Seleccione jB PM → jB PM Pro ject y haga clic en Next. 2. Ingrese un nombre para el proyecto en la casilla P ro ject name: y haga clic en Next. 45 Suit e BPM JBoss de Red Hat 6 .0 G uía de inicio Archivo de reglas HelloWorld de ejemplo JBoss D eveloper Studio proporciona la opción para agregar un archivo de reglas HelloWorld de ejemplo al proyecto. Acepte esta opción predeterminada haciendo clic en Next para probar el proyecto de ejemplo en los siguientes pasos. 3. Seleccione el tiempo de ejecución jBPM (o use el predeterminado). 4. Seleccione generar código compatible con jBP M 6 o po steri o res y haga clic en Fi ni sh. 5. Para probar el proyecto, haga clic con el botón derecho del ratón en el archivo Java que contiene el método principal y seleccione R u n → ru n as → Java Ap p licat io n . La salida se presentará en la pestaña de la consola. Reportar un error 46 Capít ulo 1 0 . Planificador de recursos empresariales Capítulo 10. Planificador de recursos empresariales El p lan if icad o r d e recu rso s emp resariales está disponible como un avance técnico con la suite BPM JBoss de Red Hat. El planeador de recursos empresariales es una máquina ligera incluíble de planeación que optimiza los problemas de planeación. Ayuda a los programadores TM Java normales a resolver problemas de planeación de manera eficiente y combina heurística de optimización y metaheurística con cálculos muy eficientes. El planificador ayuda a solucionar varios casos como los siguientes: Emp lead o s/list a d e p acien t es. En planificador ayuda a crear horarios para las enfermeras y mantiene registros de la administración de las camas de los pacientes. H o rario s ed u cacio n ales. El planificador ayuda a programar clases, cursos, exámenes y presentaciones de conferencias. H o rario s d el t aller: El planificador mantiene registros de las cadenas de fabricación, planeación de colas de máquinas y planeación de tareas del personal. R eco rt e d e recu rso s: El planificador minimiza los desperdicios reduciendo el consumo de recursos tal como papel y acero. Reportar un error 10.1. Inst alación del planificador de recursos empresariales 1. Navegue al portal del cliente de Red Hat e inicie sesión con sus credenciales de usuario. 2. Seleccione D o wn lo ad s → R ed H at JB o ss Mid d leware → D o wn lo ad So f t ware. 3. D el menú desplegable P ro d ucts seleccione BP M Sui te. 4. D el menú desplegable Versi o n seleccione la versión del producto 6 . 0 . 2. 5. Seleccione R ed Hat JBo ss BP M Sui te 6 . 0 . 2 Busi ness R eso urce P l anner y haga clic en D o wnl o ad . Reportar un error 10.2. Ejecución de los ejemplos del planificador de recursos empresariales 1. En la línea de comandos vaya hasta el directorio exampl es/. 2. En un entorno Unix ejecute el siguiente comando: ./runExam ples.sh En un entorno Windows ejecute el siguiente comando: ./runExam ples.bat 3. Escoja un ejemplo de la aplicación GUI de ejemplos que se abre y ejecútelo en su ID E favorito. 47 Suit e BPM JBoss de Red Hat 6 .0 G uía de inicio Reportar un error 48 Hist orial de revisiones Historial de revisiones R evisió n 1.0.0- 1 Wed Au g 06 2014 Built from Content Specification: 22690, Revision: 684299 C S B u ild er R o b o t 49
