suite bpm jboss de red hat 6 · componentes de la suite bpm jboss de red hat 1.3. ......

49
Suite BPM JBoss de Red Hat 6.0 Guía de inicio La guía de inicio para BPMS JBoss Red Hat Last Updated: 2017-11-23

Upload: ngodieu

Post on 27-Apr-2018

243 views

Category:

Documents


2 download

TRANSCRIPT

Page 1: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

Suite BPM JBoss de Red Hat 6.0

Guía de inicio

La guía de inicio para BPMS JBoss Red Hat

Last Updated: 2017-11-23

Page 2: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5
Page 3: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

Suite BPM JBoss de Red Hat 6.0 Guía de inicio

La guía de inicio para BPMS JBoss Red Hat

Kanchan [email protected]

Doug Hoffman

Eva Kopalova

Red Hat Content Services

Page 4: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

Legal Notice

Copyright © 2014 Red Hat, Inc.

This document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0Unported License. If you distribute this document, or a modified version of it, you must provideattribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red Hattrademarks 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, OpenShift, Fedora, the Infinitylogo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and othercountries.

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 Statesand/or other countries.

MySQL ® is a registered trademark of MySQL AB in the United States, the European Union andother countries.

Node.js ® is an official trademark of Joyent. Red Hat Software Collections is not formally related toor endorsed by the official Joyent Node.js open source or commercial project.

The OpenStack ® Word Mark and OpenStack logo are either registered trademarks/service marksor trademarks/service marks of the OpenStack Foundation, in the United States and other countriesand are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed orsponsored by the OpenStack Foundation, or the OpenStack community.

All other trademarks are the property of their respective owners.

Resumen

Esta guía le ayuda a los usuarios a instalar y configurar BPMS JBoss de Red Hat por primera vez.

Page 5: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table of Contents

CAPÍTULO 1. INTRODUCCIÓN1.1. SOBRE LA SUITE BPM JBOSS DE RED HAT1.2. COMPONENTES DE LA SUITE BPM JBOSS DE RED HAT1.3. EJEMPLO DE USO: SOLUCIONES BASADAS EN PROCESOS EN LA INDUSTRIA DE PRÉSTAMOS

CAPÍTULO 2. INICIO RÁPIDO CON RED HAT JBOSS BPM SUITE

CAPÍTULO 3. OPCIONES DE INSTALACIÓN3.1. LA INSTALACIÓN AGRUPADA EAP6

3.1.1. Descarga del paquete EAP63.1.2. Instalación del paquete EAP63.1.3. Definición de roles3.1.4. Creación de usuarios

3.2. LA INSTALACIÓN AGRUPADA GENÉRICA IMPLEMENTABLE3.2.1. Descarga del paquete implementable genérico3.2.2. Instalación del paquete implementable genérico

3.2.2.1. Configuración del administrador de transacciones para Red Hat JBoss Web Server 2.0 (Tomcat 7)

Instale el gestor de transacciones.3.2.2.2. Configuración de una central empresarial para Red Hat JBoss Web Server 2.0 (Tomcat 7)3.2.2.3. Configuración de Dashbuilder para Red Hat JBoss Web Server 2.0 (Tomcat 7)

3.3. INICIO DEL SERVIDOR3.4. ADMINISTRADOR DE SEGURIDAD JAVA Y GESTIÓN DE RENDIMIENTO

CAPÍTULO 4. INICIO DE SESIÓN EN LA CENTRAL EMPRESARIAL

CAPÍTULO 5. PROYECTO HELLO WORLD5.1. CREACIÓN DE UNA ESTRUCTURA DE REPOSITORIO

CAPÍTULO 6. PROCESO HELLO WORLD6.1. CREACIÓN DE PROCESOS EMPRESARIALES6.2. MODELADO DE PROCESOS EMPRESARIALES6.3. DEFINICIÓN DE PROPIEDADES DEL ELEMENTO6.4. CONSTRUCCIÓN E IMPLEMENTACIÓN6.5. INSTANCIACIÓN DE PROCESOS EMPRESARIALES6.6. CANCELACIÓN DE PROCESOS EMPRESARIALES

CAPÍTULO 7. REGLAS EMPRESARIALES HELLO WORLD7.1. CREACIÓN DE LA REGLA EMPRESARIAL7.2. AGREGACIÓN DE LA TAREA DE REGLAS EMPRESARIALES7.3. CONSTRUCCIÓN E IMPLEMENTACIÓN7.4. INSTANCIACIÓN DE PROCESOS EMPRESARIALES

CAPÍTULO 8. BAM8.1. ACCESO AL CONSTRUCTOR DE PÁNELES DE LA SUITE BPM JBOSS RED HAT8.2. MONITORIZACIÓN DE INSTANCIAS

CAPÍTULO 9. ESTUDIO DEL DESARROLLADOR JBOSS DE RED HAT9.1. CENTRAL DE JBOSS9.2. INSTALACIÓN DE LOS PLUGINS DEL ESTUDIO DEL DESARROLLADOR JBOSS9.3. CONFIGURACIÓN DEL TIEMPO DE EJECUCIÓN DROOLS9.4. CONFIGURACIÓN DEL TIEMPO DE EJECUCIÓN JBPM9.5. CONFIGURACIÓN DEL SERVIDOR DE LA SUITE BPM JBOSS9.6. IMPORTACIÓN DE PROYECTOS DESDE UN REPOSITORIO GIT A JBOSS DEVELOPER STUDIO

4444

7

8888

1010111112

121315182021

22

2323

26262627282929

3131323334

353535

36363737383839

Table of Contents

1

Page 6: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

9.7. CREACIÓN DE UN PROYECTO DROOLS9.8. CREACIÓN DE UN PROYECTO JBPM

CAPÍTULO 10. PLANIFICADOR DE RECURSOS EMPRESARIALES10.1. INSTALACIÓN DEL PLANIFICADOR DE RECURSOS EMPRESARIALES10.2. EJECUCIÓN DE LOS EJEMPLOS DEL PLANIFICADOR DE RECURSOS EMPRESARIALES

APÉNDICE A. HISTORIAL DE REVISIONES

4142

434343

45

Guía de inicio

2

Page 7: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

Table of Contents

3

Page 8: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

CAPÍTULO 1. INTRODUCCIÓN

1.1. SOBRE LA SUITE BPM JBOSS DE RED HAT

La suite BPM JBoss de Red Hat es una suite de gestion de procesos empresariales de código abiertoque combina la administración de procesos empresariales y la gestión de reglas empresariales yhabilita a las empresas y a los usuarios informáticos para crear, administrar e implementar procesos yreglas empresariales.

BRMS JBoss de Red Hat y la suite BPM JBoss de Red Hat usan un repositorio centralizado en dondetodos los recursos se almacenan. Esto asegura consistencia, transparencia y la habilidad para realizarauditorías a través de la empresa. Los usuarios empresariales pueden modificar la lógica empresarial ylos procesos empresariales sin requerir ayuda del personal de sistemas.

Para acomodar el componente de reglas empresariales, la suite BPM JBoss de Red Hat incluye BRMSJBoss de Red Hat.

El planificador de recursos empresariales se incluye como un avance de tecnología con estelanzamiento.

Reportar un error

1.2. COMPONENTES DE LA SUITE BPM JBOSS DE RED HAT

La suite BPM JBoss de Red Hat contiene los siguientes componentes:

Máquina de ejecució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 BPMJBoss de Red Hat.

Repositorio de artefactos (almacén de conocimiento)

Un almacenamiento para activos empresariales que proporcionan funcionalidades de control derevisiones (conecta repositorios GIT con activos empresariales).

Central empresarial

Una aplicación basada en red para la creación, administración y monitoreamiento de activosempresariales proporcionando un entorno integrado con las herramientas respectivas tal comoreglas y herramientas de autoría de procesos, la herramienta de administración de activosempresariales para trabajar con el repositorio de artefactos, herramientas de administración de datosen tiempo de ejecución, editores de recursos, herramientas BAM (del inglés Business ActivityMonitoring- monitoreamiento de actividades empresariales), herramientas de administración detareas y herramientas BRMS. Para obtener mayores detalles consulte la Guía del usuario de la suiteBPM JBoss de Red Hat.

Reportar un error

1.3. EJEMPLO DE USO: SOLUCIONES BASADAS EN PROCESOS ENLA INDUSTRIA DE PRÉSTAMOS

La suite BPM JBoss de Red Hat (BPMS) se puede implementar para automatizar procesos

Guía de inicio

4

Page 9: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

empresariales tal como automatizar el proceso de aprobación de préstamos en un banco minorista. Estaes una implementación típica 'basada en procesos específicos' que puede ser el primer paso en unaadopción más amplia de BPM a través de una empresa. Aprovecha las funcionalidades de BPM y lasreglas empresariales de BPMS.

Un banco minorista ofrece varios tipos de productos de préstamo con diferentes términos yrequerimientos de selección. Los clientes que requieren un préstamo deben llenar una aplicación depré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 depréstamo más apropiado. Una vez aprobado, el banco crea y establece una cuenta de préstamo para elaplicante, quien luego puede acceder a los fondos. El banco debe asegurarse de cumplir con todos losrequerimientos relevantes en cada paso del proceso y necesita administrar su portafolio de préstamopara maximizar sus ganancias. Las políticas tienen lugar para ayudar a tomar decisiones en cada pasoy 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 lasherramientas de autor BPMN3 (diseñador de procesos) en la suite BPM:

Figura 1.1. Flujo de procesos de aplicación para préstamos de alto nivel

Las reglas empresariales se desarrollan con las herramientas de autor de reglas en la suite BPM paraaplicar políticas y tomar decisiones. Las reglas están enlazadas con los modelos de procesos parareforzar 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 deaplicación para préstamos se pueda automatizar.

CAPÍTULO 1. INTRODUCCIÓN

5

Page 10: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

Figura 1.2. Automatización del proceso de aplicación para préstamos

Todo el proceso de préstamo y de reglas se puede modificar en cualquier momento por parte de losanalistas empresariales del banco. El banco tiene la habilidad de mantener constantemente uncumplimiento con los requerimientos de acuerdo con las regulaciones cambiantes y puede introducir demanera rápida nuevos productos de préstamo y mejorar las políticas de préstamos para competirefectivamente y dirigir la rentabilidad.

Reportar un error

Guía de inicio

6

Page 11: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

CAPÍTULO 2. INICIO RÁPIDO CON RED HAT JBOSS BPMSUITEEn esta sección descargamos, instalamos y ejecutamos Red Hat JBoss BPM Suite con el númeromínimo de instrucciones. Para obtener pasos detallados y métodos opcionales de instalación, sálteseesta 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 comomínimo. No se requiere un servidor Red Hat JBoss EAP ya existente ya que el instalador instala uno sino puede detectar uno.

Procedimiento 2.1. Guía de inicio rápido BPM Suite

1. Descargue el instalador BPM Suite de access.redhat.com.

2. Ejecute el instalador con el siguiente comando:

java -jar jboss-bpms-installer-VERSION.GA-redhat-MINOR.jar

3. Siga los pasos del instalador GUI tomando nota del nombre de usuario/contraseña para accedera la aplicación BRMS después de la instalación.

4. Después de una instalación exitosa, en una ventana de comandos navegue hasta la carpeta deinicio EAP en donde haya instalado BPM Suite.

5. Inicie el servidor BPM Suite emitiendo el siguiente comando.

bin/standalone.sh

6. Abra un navegador de red e inicie sesión en la central empresarial navegando hasta http://localhost:8080/business-central/. Inicie la sesión usando la combinación denombre de usuario/contraseña para acceder a la aplicación BPM Suite que creó en el momentode 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, “Definició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

CAPÍTULO 2. INICIO RÁPIDO CON RED HAT JBOSS BPM SUITE

7

Page 12: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

CAPÍTULO 3. OPCIONES DE INSTALACIÓNLa 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:

jboss-bpms-6.MINOR_VERSION-redhat-x-deployable-eap6.x.zip: versiónadaptada para implementación en la plataforma de aplicaciones empresariales JBoss deRed Hat (EAP 6.1.1).

jboss-bpms-6.MINOR_VERSION-redhat-x-deployable-generic.zip: la versiónimplementable con bibliotecas adicionales adaptadas para la implementación en el Red HatJBoss Web Server (WS), Apache Tomcat 6 y Apache Tomcat 7.

Dependiendo de su entorno puede seleccionar la mejor opción de instalación de acuerdo con lasnecesidades de su proyecto.

Reportar un error

3.1. LA INSTALACIÓN AGRUPADA EAP6

Esta sección describe la instalación del paquete de la suite BPM JBoss de Red Hat implementable parala 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 suiteBPM JBoss de Red Hat es 6.1.1 y no 6.1.0.

Reportar un error

3.1.1. Descarga del paquete EAP6

Para descargar el paquete de la suite BPM JBoss de Red Hat para la plataforma de aplicacionesempresariales JBoss, haga lo siguiente:

1. Vaya al portal del cliente de Red Hat e inicie sesión.

2. Seleccione Downloads → Red Hat JBoss Middleware → Download Software.

3. Del menú desplegable Product seleccione BPM Suite.

4. Del menú desplegable Version seleccione la versión del producto.

5. En la tabla, navegue a la fila Red Hat JBoss BPM Suite 6.0.2 implementable para EAP 6.1.1 y luego haga clic en Descargar.

Reportar un error

3.1.2. Instalación del paquete EAP6

Guía de inicio

8

Page 13: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

Para instalar el paquete implementable para un EAP que todavía no se ha configurado, haga losiguiente:

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 yusted debe permitir que el proceso de descompresión sobreescriba estos archivos. Un ejemplode un archivo que se sobreescribe es el archivo SERVER_HOME/bin/product.conf. Despuésde una agrupación exitosa, este archivo debe contener la cadena slot=bpms. Puede abrir estearchivo 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 yunirlo con su directorio de servidor correctamente en un paso, si ejecuta este comando en el directorioen donde descargó el archivo zip:

Ejemplo 3.1. El comando para descomprimir

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. Descomprima el archivador comprimido descargado; sin embargo, no sobreescriba todos losarchivos. Agrupe manualmente los siguientes archivos en el directorio SERVER_HOME.

jboss-eap-6.1/domain/configuration/* - (por favor tenga en cuenta que BPMSrequiere JMS así que JMS se agrega por defecto en todos los perfiles en domain.xmlproporcionado por la distribución BPMS).

jboss-eap-6.1/standalone/configuration/* - (por favor tenga en cuenta queBPMS requiere JMS así que JMS se agrega por defecto en todos los archivos deconfiguración de perfiles (especialmente en standalone.xml y standalone-ha.xml)proporcionado por la distribución BPMS).

jboss-eap-6.1/modules/layers.conf

unzip -u jboss-bpms-VERSION-TYPE.zip -d SERVER_HOME_PARENT_DIR

unzip -u jboss-bpms-6.0.2-redhat-7-deployable-eap6.x.zip -d /home/john/myServers/

CAPÍTULO 3. OPCIONES DE INSTALACIÓN

9

Page 14: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

jboss-eap-6.1/bin/product.conf

3. Asegúrese de que el EAP de destino no incluya una implementación con un nombre que creeconflictos. Copie la carpeta jboss-eap-6.1/standalone/deployments en el directorioEAP_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 lacarpeta jboss-eap-6.1/modules/system/layers/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 deusuarios. 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. Losadministradores pueden administrar los usuarios, administrar los repositorios (crear y clonar) ytienen acceso completo para realizar los cambios requeridos en la aplicación. Los adminstienen acceso a todas las áreas dentro del sistema.

developer: un usuario developer -desarrollador- tiene acceso a casi todas las funcionalidades ypuede administrar reglas, modelos, flujos de procesos, formas y páneles. Pueden administrar elrepositorio de activos, pueden crear, construir e implementar proyectos e incluso pueden usar elRed Hat JBoss Developer Studio para ver procesos. Solo se esconden ciertas funcionesadministrativas 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 yejecutar sus proyectos. Sin embargo, el acceso Authoring → Administration no estádisponible para los usuarios con el rol de analista. Ciertas funcionalidades de menor nivelorientadas a los desarrolladores como la vista Deployment → Artifact Repository no sonaccesibles para este rol. Sin embargo, el botón Build & Deploy está disponible para el rol deanalista usando el editor de proyectos.

user: un usuario o un usuario empresarial trabajan en las listas de tareas empresariales que seutilizan para operar cierto proceso. Un usuario con este rol puede acceder el pánel y administrarprocesos.

manager: un manager -gerente- es un espectador del sistema y está interesado en lasestadísticas con relación a los procesos empresariales y su rendimiento, indicadoresempresariales y otros reportes del sistema. Un usuario con este rol tiene acceso al BAMsolamente.

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 oel archivo add-user.bat en un sistema Windows desde el directorio bin EAP.

Guía de inicio

10

Page 15: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

1. Ejecute ./add-user.sh en un sistema Unix o add-user.bat en un sistema Windows desde eldirectorio bin.

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: helloworlduser.

5. Cree la contraseña del usuario en el campo de la contraseña y reingrese la contraseña. Porejemplo: Helloworld@123.

NOTA

La contraseña debe tener por lo menos 8 caracteres de largo y debe tenercaracteres en mayúsculas y minúsculas (por ejemplo, A-Z, a-z) por lo menos uncaracter numérico (por ejemplo,. 0-9) y por lo menos un caracter especial (porejemplo, ~ ! @ # $ % ^ * ( ) - _ + =).

6. Ingrese una lista de roles que el usuario necesitará en el campo de roles (consulteSección 3.1.3, “Definición de roles”).

Los usuarios de la central empresarial necesitan por lo menos tener el rol analyst y losusuarios dashbuilder necesitan tener el rol admin. 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 serequiere).

Reportar un error

3.2. LA INSTALACIÓN AGRUPADA GENÉRICA IMPLEMENTABLE

Para instalar la suite BPM JBoss de Red Hat en el Red Hat JBoss Web Server (WS) , necesita utilizar elpaquete implementable genérico del producto.

Para la instalación en WS, el paquete implementable genérico contiene bibliotecas de seguridad yadministradores de transacciones adicionales que no son parte del WS JBoss Red Hat.

Note que el paquete implementable genérico contiene los siguientes archivos zip:

jboss-bpms-engine.zip: las bibliotecas de la máquina de ejecución soportada que senecesitan si está incluyendo la máquina en su aplicación

jboss-bpms-manager.zip: las aplicaciones de red business-central.war y dashbuilder.war

Reportar un error

3.2.1. Descarga del paquete implementable genérico

Para descargar el paquete de la suite BPM JBoss de Red Hat genérico implementable para el servidorde red JBoss, haga lo siguiente:

CAPÍTULO 3. OPCIONES DE INSTALACIÓN

11

Page 16: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

1. Vaya al portal del cliente de Red Hat e inicie sesión.

2. Seleccione Downloads → Red Hat JBoss Middleware → Download Software.

3. Del menú desplegable Product seleccione BPM Suite.

4. Del menú desplegable Version seleccione la versión del producto.

5. En la tabla, navegue a la fila Red Hat JBoss BPM Suite 6.0.2 Deployable for all supported containers y luego haga clic en Download.

Reportar un error

3.2.2. Instalación del paquete implementable genérico

Para instalar el paquete implementable genérico, necesita configurar lo siguiente después de haberinstalado la plataforma subyacente (Red Hat JBoss WS):

Configure el controlador de la base de datos y el gestor de transacciones (Bitronix) (consulteSección 3.2.2.1, “Configuración del administrador de transacciones para Red Hat JBoss WebServer 2.0 (Tomcat 7)”).

Configure la aplicación de la central empresarial: configure usuarios y roles y configure lapersistencia (consulte Sección 3.2.2.2, “Configuración de una central empresarial para Red HatJBoss Web Server 2.0 (Tomcat 7)”).

Configure la aplicación Dashbuilder: configure usuarios y roles y configure la persistencia(consulte Sección 3.2.2.3, “Configuración de Dashbuilder para Red Hat JBoss Web Server 2.0(Tomcat 7)”).

Reportar un error

3.2.2.1. Configuración del administrador de transacciones para Red Hat JBoss WebServer 2.0 (Tomcat 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: jboss-bpms-engine.zip y jboss-bpms-manager.zip.

2. Extraiga el contenido del archivo jboss-bpms-manager.zip en una ubicación temporal. Estearchivo zip contiene dos carpetas archivadoras de aplicaciones de red: business-central.war y dashbuilder.war en formatos expandidos y estas están ahora en suubicació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/business-central y $TOMCAT_DIR/webapps/dashbuilder.

NOTA

$TOMCAT_DIR se refiere al directorio de inicio en donde se encuentra suservidor de red. Reemplácelo con la ruta a su directorio de inicio del servidor dered, por ejemplo: /home/john/jboss-ews-2.0/tomcat7/

Guía de inicio

12

Page 17: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

3. Extraiga la carpeta jboss-bpms-engine del archivador jboss-bpms-engine.zip a unaubicación temporal desde donde puede copiar las bibliotecas requeridas. Esta carpeta ahoracontiene todas las abibliotecas centrales BPMS bajo la carpeta extraída y una carpeta lib.

4. Instale el gestor de transacciones.Copie las siguientes bibliotecas jar del administrador de transacciones de la carpeta lib endonde extrajo las bibliotecas jboss-bpms-engine al directorio $TOMCAT_DIR/lib/:

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/lib/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 dedatos relevante en $TOMCAT_DIR/lib/.

NOTA

Si utiliza la base de datos H2 incluída, el controlador está disponible en business-central/WEB-INF/lib/.

6. Cree los archivos de configuración del gestor de transacciones en $TOMCAT_DIR/conf/:

btm-config.properties

resources.properties (el resource.ds1.uniqueName define el nombre de la fuente de datosutilizado 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 suentorno.

Ejemplo 3.2. Definición de la fuente de datos H2

bitronix.tm.serverId=tomcat-btm-node0bitronix.tm.journal.disk.logPart1Filename=${btm.root}/work/btm1.tlogbitronix.tm.journal.disk.logPart2Filename=${btm.root}/work/btm2.tlogbitronix.tm.resource.configuration=${btm.root}/conf/resources.properties

resource.ds1.className=bitronix.tm.resource.jdbc.lrc.LrcXADataSourceresource.ds1.uniqueName=jdbc/jbpmresource.ds1.minPoolSize=10

CAPÍTULO 3. OPCIONES DE INSTALACIÓN

13

Page 18: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

Ejemplo 3.3. Definición de la fuente de datos MySQL 5.5

Ejemplo 3.4. Definición de la fuente de datos DB2 Type 4

Ejemplo 3.5. Definición de la fuente de datos Oracle

Ejemplo 3.6. Definición de la fuente de datos del servidor Microsoft SQL

resource.ds1.maxPoolSize=20resource.ds1.driverProperties.driverClassName=org.h2.Driverresource.ds1.driverProperties.url=jdbc:h2:file:~/jbpmresource.ds1.driverProperties.user=saresource.ds1.driverProperties.password=resource.ds1.allowLocalTransactions=true

resource.ds1.className=com.mysql.jdbc.jdbc2.optional.MysqlXADataSourceresource.ds1.uniqueName=jdbc/jbpmresource.ds1.minPoolSize=0resource.ds1.maxPoolSize=10resource.ds1.driverProperties.URL=jdbc:mysql://localhost:3306/sampledbresource.ds1.driverProperties.user=dbuserresource.ds1.driverProperties.password=dbpasswordresource.ds1.allowLocalTransactions=true

resource.ds1.className=com.ibm.db2.jcc.DB2Driverresource.ds1.uniqueName=jdbc/jbpmresource.ds1.minPoolSize=0resource.ds1.maxPoolSize=10resource.ds1.driverProperties.URL=jdbc:db2://localhost:50000/sampledbresource.ds1.driverProperties.user=dbuserresource.ds1.driverProperties.password=dbpasswordresource.ds1.allowLocalTransactions=true

resource.ds1.className=oracle.jdbc.xa.client.OracleXADataSourceresource.ds1.uniqueName=jdbc/jbpmresource.ds1.minPoolSize=0resource.ds1.maxPoolSize=10resource.ds1.driverProperties.URL=jdbc:oracle:thin:@//localhost:1521/bpms resource.ds1.driverProperties.user=dbuserresource.ds1.driverProperties.password=dbpasswordresource.ds1.allowLocalTransactions=true

resource.ds1.className=com.microsoft.sqlserver.jdbc.SQLServerDriver

Guía de inicio

14

Page 19: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

7. Configure el escucha del gestor de transacciones en $TOMCAT_DIR/conf/server.xml parainiciar y detener Bitronix en el arranque y detención del contenedor:

Agregue el siguiente elemento como el último elemento <Listener> en el elemento <Server>:

8. Defina la propiedad del sistema btm.root y la ubicación en donde se ubica el archivo deconfiguración bitronix:

En $TOMCAT_DIR/bin/ cree el archivosetenv.sh con el siguiente contenido:

Otorgue permisos de ejecución de archivos si aplica. La última propiedad org.jbpm.designer.perspective se establece como RuleFlow para permitir que laperspectiva predeterminada para el diseñador sea RuleFlow en lugar de Full.

IMPORTANTE

En sistemas Microsoft Windows reemplace el valor $CATALINA_HOME en elcontenido del archivo con el nombre de la variable de entorno equivalente o usela ruta absoluta y agregue los valores en el archivo setenv.bat tal como semuestra en el siguiente ejemplo:

Reportar un error

3.2.2.2. Configuración de una central empresarial para Red Hat JBoss Web Server 2.0(Tomcat 7)

Para establecer la central empresarial haga lo siguiente:

resource.ds1.uniqueName=jdbc/jbpmresource.ds1.minPoolSize=0resource.ds1.maxPoolSize=10resource.ds1.driverProperties.URL=jdbc:sqlserver://localhost:1433;databaseName=bpms;resource.ds1.driverProperties.user=dbuserresource.ds1.driverProperties.password=dbpasswordresource.ds1.allowLocalTransactions=true

<Listener className="bitronix.tm.integration.tomcat55.BTMLifecycleListener" />

CATALINA_OPTS="-Xmx512M -XX:MaxPermSize=512m -Dbtm.root=$CATALINA_HOME -Dbitronix.tm.configuration=$CATALINA_HOME/conf/btm-config.properties -Dorg.jbpm.designer.perspective=RuleFlow"

set "CATALINA_OPTS=-Xmx512M -XX:MaxPermSize=512m -Dbtm.root=C:/Tomcat -Dbitronix.tm.configuration=C:/Tomcat/conf/btm-config.properties -Dorg.jbpm.designer.perspective=RuleFlow"

CAPÍTULO 3. OPCIONES DE INSTALACIÓN

15

Page 20: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

1. Establezca una Valve de manera que la aplicación de red de la central empresarial puedacargar la configuración de los usuarios en Tomcat:

a. Defina los usuarios y roles en $TOMCAT_DIR/conf/tomcat-users.xml. Note que lacentral empresarial requiere que los usuarios tengan los roles especificados como adminy/o analyst (fpara mayor información sobre definiciones de roles y usuarios consulte ladocumentación de Tomcat 7).

El programa listado a continuación muestra un ejemplo de la manera en que estos dos rolesse agregarían y cómo se le asignará estos roles al usuario llamado bpmsadmin.

b. Copie kie-tomcat-integration-VERSION.jar de $TOMCAT_DIR/webapps/business-central/WEB-INF/lib/ a $TOMCAT_DIR/lib/.

c. Copie jaxb-api-VERSION.jar de $TOMCAT_DIR/webapps/business-central/WEB-INF/lib/ a $TOMCAT_DIR/lib/.

d. En $TOMCAT_DIR/conf/server.xml agregue la declaración de la válvula Tomcat en elelemento relevante <host>:

e. En $TOMCAT_DIR/webapps/business-central/WEB-INF/web.xml borre elcomentario de las entradas marcadas con el comentario TOMCAT-JEE-SECURITY.

f. Configure la fuente de autenticación tomcat: en el directorio $TOMCAT_DIR/webapps/business-central/WEB-INF/classes/META-INF/services/, renombre los siguientes archivos: org.uberfire.security.auth.AuthenticationSource como org.uberfire.security.auth.AuthenticationSource-ORIGIN y org.uberfire.security.auth.AuthenticationSource-TOMCAT-JEE-SECURITYcomo org.uberfire.security.auth.AuthenticationSource:

g. En $TOMCAT_DIR/webapps/business-central/WEB-INF/beans.xml borre elcomentario JAASUserGroupInfoProducer y agregue el comentario

<role rolename="admin"/> <role rolename="analyst" /> <user username="bpmsadmin" password="P@ssw0rd" roles="admin,analyst"/>

<Valve className="org.kie.integration.tomcat.JACCValve" />

# Comando de ejemplo si ejecuta este desde el directorio $TOMCAT_DIR/webapps$ mv business-central/WEB-INF/classes/META-INF/services/org.uberfire.security.auth.AuthenticationSource business-central/WEB-INF/classes/META-INF/services/org.uberfire.security.auth.AuthenticationSource-ORIGIN$ mv business-central/WEB-INF/classes/META-INF/services/org.uberfire.security.auth.AuthenticationSource-TOMCAT-JEE-SECURITY business-central/WEB-INF/classes/META-INF/services/org.uberfire.security.auth.AuthenticationSource

Guía de inicio

16

Page 21: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

org.jbpm.kie.services.cdi.producer.DefaultUserGroupInfoProducer(opcional). La parte alternatives de este archivo se debe ver así:

2. Si está usando una fuente de datos diferente de la predeterminada proporcionada por la basede datos H2 subyacente necesitará configurar la persistencia. Si está utilizando la base dedatos H2 predeterminada entonces puede ignorar el resto de pasos en este procedimiento.

En este procedimiento se configura una fuente de datos con el nombre JNDI jdbc/myDatasource tal como se define en uniqueName=jdbc/jbpm en el archivo bitronix resources.properties (para la opción MySQL):

a. En business-central/META-INF/context.xml reemplace el nombre JNDI de lafuente de datos en el elemento <Resource>. El atributo uniqueName se refiere a lapropiedad resource.ds1.uniqueName establecida en resources.properties:

b. En business-central/WEB-INF/web.xml reemplace el nombre JNDI de la fuente dedatos en el elemento <res-ref-name> con su nombre de fuente de datos:

c. Cambie business-central/WEB-INF/classes/META-INF/persistence.xml.

En este archivo cambie el nombre del dialecto hibernate utilizado para su base de datos siestá utilizando una base de datos diferente de H2. El código a continuación demuestra lainformación de la base de datos original para persistence.xml:

Esta información se puede actualizar de la siguiente manera (tal como se demuestra con labase de datos MySQL a continuación):

<alternatives> <!-- <class>org.jbpm.kie.services.cdi.producer.DefaultUserGroupInfoProducer</class> --> <!-- uncomment JAASUserGroupInfoProducer when using JEE security on Tomcat --> <class>org.jbpm.kie.services.cdi.producer.JAASUserGroupInfoProducer</class> </alternatives>

<Resource name="jdbc/myDatasource" uniqueName="jdbc/jbpm" auth="Container" removeAbandoned="true" factory="bitronix.tm.resource.ResourceObjectFactory" type="javax.sql.DataSource"/>

<resource-ref> <description>Console DS</description> <res-ref-name>jdbc/myDatasource</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth></resource-ref>

<property name="hibernate.dialect" value="org.hibernate.dialect.H2Dialect"/>

CAPÍTULO 3. OPCIONES DE INSTALACIÓN

17

Page 22: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

NOTA

El dialecto para DB2 es org.hibernate.dialect.DB2Dialect, paraDB2 en AS/400 es org.hibernate.dialect.DB2400Dialect, paraOracle es org.hibernate.dialect.Oracle10gDialect y para elservidor Microsoft SQL es org.hibernate.dialect.SQLServerDialect

d. Cambie el archivo business-central/WEB-INF/classes/META-INF/persistence.xml de manera que la máquina de procesos BPMS pueda usar lanueva base de datos.

El código a continuación demuestra la información de la fuente de datos original para persistence.xml:

Cambie este valor a la fuente de datos definida anteriormente:

3. Ahora puede iniciar JBoss Web Server para iniciar sesión en la central empresarial.

a. Ejecute startup.sh en el directorio $TOMCAT_HOME/bin.

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 tomcat-users.xml en donde definió los roles de usuario.

Reportar un error

3.2.2.3. Configuración de Dashbuilder para Red Hat JBoss Web Server 2.0 (Tomcat 7)

Para establecer un panel de construcción en el servidor de red JBoss Red Hat, haga lo siguiente:

1. Definir usuarios y roles en $TOMCAT_DIR/conf/tomcat-users.xml. Note que Dashbuilderrequiere que los usuarios tengan el rol especificado como admin y/o analyst. Si ya definióestos usuarios para la central empresarial entonces no necesita definirlos de nuevo.

2. Habilitar el inicio de sesión único entre Dashbuilder y la central empresarial borrando elcomentario de las siguientes líneas en el archivo $TOMCAT_DIR/conf/server.xml:

<property name="hibernate.dialect" value="org.hibernate.dialect.MySQLDialect"/>

<jta-data-source>java:comp/env/jdbc/jbpm</jta-data-source>

<jta-data-source>java:comp/env/jdbc/myDatasource</jta-data-source>

./startup.sh

<Valve className="org.apache.catalina.authenticator.SingleSignOn" />

Guía de inicio

18

Page 23: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

3. Así como con la configuración de la central empresarial, si está utilizando una base de datosdiferente de la base de datos H2 integrada y predeterminada entonces necesitará configurar lapersistencia.

En este procedimiento se configura una fuente de datos con el nombre JNDI jdbc/dashbuilderDS tal como se define en uniqueName=jdbc/jbpm en el archivo bitronix resources.properties:

a. En dashbuilder/META-INF/context.xml reemplace el nombre JNDI de la fuente dedatos en el elemento <Resource>. El atributo uniqueName se refiere a la propiedadresource.ds1.uniqueName establecida en resources.properties:

NOTA

Dependiendo de su base de datos es posible que necesite definir algunasotras propiedades aquí también. Por ejemplo, en un entorno Oracle estaentrada puede verse como el siguiente listado.

b. En dashbuilder/WEB-INF/web.xml agregue el nombre JNDI de la fuente de datos enel elemento <res-ref-name> con su nombre de fuente de datos:

c. En dashbuilder/META-INF/context.xml defina la fábrica de transacciones:

d. Actualice el nombre JNDI de la fuente de datos en dashbuilder/WEB-INF/etc/hibernate.cfg.xml en el elemento <session-factory>:

<Resource name="jdbc/dashbuilderDS" uniqueName="jdbc/jbpm" auth="Container" removeAbandoned="true" factory="bitronix.tm.resource.ResourceObjectFactory" type="javax.sql.DataSource"/>

<Resource name="jdbc/jbpm" uniqueName="jdbc/jbpm" auth="Container" removeAbandoned="true" factory="bitronix.tm.resource.ResourceObjectFactory" type="javax.sql.DataSource" username="username" password="password" driverClassName="oracle.jdbc.xa.client.OracleXADataSource" url="jdbc:oracle:thin:YOUR-URL:1521:YOUR-DB" maxActive="8" />

<resource-ref> <description>Dashboard Builder Datasource</description> <res-ref-name>jdbc/dashbuilderDS</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth></resource-ref>

<Transaction factory="bitronix.tm.BitronixUserTransactionObjectFactory"/>

CAPÍTULO 3. OPCIONES DE INSTALACIÓN

19

Page 24: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

4. Reinicie el servidor de red Java para que los cambios tengan efecto. Una vez reiniciado puedenavegar al Dashbuilder desde la central empresarial o directamente a través de: http://localhost:8080/dashbuilder.

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 EAP6entonces ahora puede iniciar su servidor en uno de dos modos disponibles.

NOTA

Si instaló BPMS usando la versión implementable genérica en el servidor de red Java deRed Hat, las instrucciones para descargar e instalar también contienen las instruccionespara iniciar el servidor. Puede ignorar la siguiente discusión.

El script de arranque predeterminado, standalone.sh con el que se envía la suite BPMJBoss de RedHat está optimizado para rendimiento. Para ejecutar su servidor en modo de rendimiento, haga losiguiente:

1. En la línea de comandos vaya al directorio $SERVER_HOME/bin/.

2. En un entorno Unix ejecute:

./standalone.sh

En un entorno Windows ejecute:

./standalone.bat

La suite BPMJBoss Red Hat también se envía con un script separado, standalone-secure.sh queestá optimizado para la seguridad. Este script aplica una política de seguridad por defecto que protegeen contra de alguna vulnerabilidad de seguridad conocida.

NOTA

Se recomienda que los entornos de producción utilicen el script standalone-secure.sh.

<property name="connection.datasource">java:/comp/env/jdbc/dashbuilderDS</property>

Guía de inicio

20

Page 25: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

AVISO

El uso de un administrador de seguridad impone una sanción importante en elrendimiento que debe tener en mente. El intercambio entre la seguridad y elrendimiento se debe realizar teniendo en consideración las circunstanciasindividuales. Consulte Sección 3.4, “Administrador de seguridad Java y gestión derendimiento”.

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/bin/.

2. En un entorno Unix ejecute:

./standalone-secure.sh

En un entorno Windows ejecute:

./standalone-secure.bat

Reportar un error

3.4. ADMINISTRADOR DE SEGURIDAD JAVA Y GESTIÓN DERENDIMIENTO

Como se observó anteriormente el habilitar el administrador de seguridad Java (JSM del inglés JavaSecurity Manager) como un entorno de pruebas completo para la evaluación de scripts MVEL en BPMSintroduce una penalidad de rendimiento en entornos de alta carga. Se deben tener en cuenta losmarcadores de entorno y de rendimiento al implementar una aplicación BPMS. Use las siguientesdirectrices 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 seimplementen aplicaciones que hayan sido desarrolladas en otros sistemas y que hayan sidorevisadas apropiadamente. También se recomienda no crear ningún usuario con el rol Analysten dichos sistemas. Si se toman en cuenta estas medidas entonces es seguro el dejar JSMdeshabilitado en estos sistemas de manera que no introduzca ninguna degradación delrendimiento.

En entornos de prueba y desarrollo sin altas cargas o en entornos en donde la autoría de reglasy procesos está expuesta a redes externas, se recomienda tener JSM habilitado con el fin delograr 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 consolacentral empresarial con JSM inhabilitado.

Reportar un error

CAPÍTULO 3. OPCIONES DE INSTALACIÓN

21

Page 26: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

CAPÍTULO 4. INICIO DE SESIÓN EN LA CENTRALEMPRESARIALInicio 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 seha configurado para ejecutar desde un nombre de dominio, substituya localhost para elnombre 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 = helloworlduser and password = Helloworld@123.

Reportar un error

Guía de inicio

22

Page 27: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

CAPÍTULO 5. PROYECTO HELLO WORLDPara demostrar las funcionalidades básicas de la suite BPM JBoss Red Hat, este capítulo le mostrarácómo configurar el proyecto Hello World con un proceso empresarial Hello World. Todo lo queeste proceso empresarial hará es presentar el mensaje Hello World! 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 delproceso empresarial HelloWorld.

3. Modele la lógica del proceso Hello World en el proceso empresarial usando la herramienta deldiseñ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 ESTRUCTURA DE REPOSITORIO

Todos los activos empresariales viven en repositorios que viven en unidades organizacionales, loscuales son directorios en el repositorio Artifact. Por defecto, el repositorio Artifact no contiene ningunaunidad organizacional. Por lo tanto, para poder crear sus propios activos empresariales tal como unproceso 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 estructurade 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 elrepositorio 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 localmentehttp://localhost:8080/business-central) e inicie sesión como usuario con el rol admin(helloworlduser).

2. Cree una unidad organizacional en el repositorio Artifact:

a. Vaya a Authoring → Administration.

b. En el menú de perspectivas haga clic en Organizational Units → Manage OrganizationalUnits.

c. En la vista que se presenta Organizational Unit Manager haga clic en Add.

En la ventana que se presenta Add New Organizational Unit defina las propiedadesde las unidades y haga clic en OK:

Nombre: helloworld

Propietario: helloworlduser

CAPÍTULO 5. PROYECTO HELLO WORLD

23

Page 28: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

3. Cree un nuevo repositorio en la unidad organizacional helloworld:

a. Vaya a Authoring → Administration.

b. En el menú de perspectivas haga clic en Repositories → New repository.

c. En la ventana que se presenta Create Repository defina las propiedades delrepositorio:

Nombre del repositorio: helloworldrepo

Unidad organizacional: helloworld

4. Vaya a Authoring → Project Authoring.

5. En el explorador de proyectos en la casilla desplegable de la unidad organizacional, seleccione helloworld y en la casilla desplegable del repositorio seleccione helloworldrepo.

Figura 5.1. Seleccione el repositorio helloworldrepo en el grupo organizacional helloworld en el explorador de proyectos

6. Cree un proyecto en el repositorio helloworld:

a. En el menú de perspectivas vaya a New Item → Project

b. En la ventana que se presenta Create new defina sus propiedades del proyecto:

Nombre del recurso (nombre del proyecto): HelloWorld

Ruta: default://master@helloworldrepo/

c. En el diálogo New Project Wizard defina las propiedades maven del proyecto. PresioneIntro después de realiza cada entrada:

Id del grupo: org.jbpm

Id del arterfacto: HelloWorld

Id de la versión: 1.0

Guía de inicio

24

Page 30: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

CAPÍTULO 6. PROCESO HELLO WORLDEn este capítulo continuaremos con el ejemplo de Hello World y crearemos todo un proceso empresarialpara 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 (Authoring → Project Authoring).

2. En la vista del explorador de proyectos a la izquierda, seleccione la unidad organizacional helloworld, el repositorio helloworldrepo, el proyecto HelloWorld y el paqueteorg.jbpm: esto define la ubicación en el repositorio Artifact, en donde creará su definición deproceso empresarial.

NOTA

Asegúrese de seleccionar el paquete org.jbpm. El seleccionar un paqueteincorrecto hace que la implementación falle.

3. En el menú de perspectivas haga clic en New Item → Business Process y defina los detallesde la definición de procesos:

Ingrese el nombre del recurso como HelloWorld.

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

Después de haber creado la definición de procesos empresariales, puede diseñar el procesoempresarial en el diseñador de procesos empresariales: el diseñador del proceso empresarial debeestar abierto en una pestaña a la derecha. Si cerró la pestaña, en el explorador de proyectos haga clicen HelloWorld bajo Business Processes para volver a abrir el diseñador de procesosempresariales. Asegúrese de seleccionar el paquete correcto (org.jbpm.helloworld). Para diseñar elcontenido del proceso, haga lo siguiente:

1. Amplie la paleta Object Library con los elementos del proceso: haga clic en el botón con

doble flecha ( ) en la esquina superior izquierda de la pestaña del diseñador de procesosempresariales.

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 unelemento de tarea conectado al inicio del evento.

Guía de inicio

26

Page 31: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

4. Cree un evento temporizador: de la paleta arrastre y deje caer el Timer (bajo Catching Intermediate Events) y conecte la tarea al elemento temporizador usando el menú deenlace rápido.

5. Cree el elemento Terminar evento conectado al elemento Evento temporizador (ya sea usandola funcionalidad de enlace rápido o arrastrándolo de la paleta).

Figura 6.1. Borrador del proceso HelloWorld

Reportar un error

6.3. DEFINICIÓN DE PROPIEDADES DEL ELEMENTO

Ahora necesita definir las propiedades del elemento:

1. Haga clic en la doble flecha ( ) en la esquina superior derecha para expandir la pestaña Properties.

2. Haga clic en cualquier parte. La pestaña Properties presenta las propiedades del proceso HelloWorld. Las propiedades requeridas son pre-definidas; sin embargo, puede cambiar susvalores si es necesario.

3. El elemento de inicio y el elemento para terminar solo tienen propiedades opcionales. Sinembargo, 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: ScriptTask

Task Type: Script

Script Language: java

Script: System.out.println("Hello World!");

Haga clic en Aceptar.

Ha definido una tarea que realizará un script durante la ejecución. El script está definido en Javay ejecuta el método System.out.println("Hello World!");, eso significa que escribirá Hello World! en la salida estándar del servidor (por defecto, la salida estándar del servidores la consola en la que se inició el servidor).

4. Todavía necesita definir propiedades del evento temporizador para hacer que el procesoespere en tiempo de ejecución de manera que usted pueda inspeccionar su ejecución: haga clicen el elemento temporizador y defina las propiedades requeridas:

Time Cycle Language: Cron

CAPÍTULO 6. PROCESO HELLO WORLD

27

Page 32: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

Duration: 1m y presione Intro.

Por lo tanto el proceso esperará por un minuto en el evento temporizador después de queejecuta 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 elproceso para asegurarse de que el proceso definido es válido. El esquema de cualquierelemento con uno o múltiples errores de validación se vuelve naranja (consulte la Red HatJBoss 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 JBossBPMS User Guide.

Reportar un error

6.4. CONSTRUCCIÓN E IMPLEMENTACIÓN

Antes de poder instanciar, es decir, ejecutar su proceso Hello World, necesita construir todo elproyecto e implementarlo en el servidor de ejecución:

1. En el menú principal de la central empresarial vaya a Authoring → Project Authoring.

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 Tools →Project Editor.

4. Verifique que los detalles del proyecto estén correctos en el Project Screen y haga clic en elbotón Build & Deploy en la esquina superior derecha de la vista de la pantalla del proyecto.

Figura 6.2. Editor de proyectos con las siguientes propiedades del proyecto helloWorld

Aparecerá una notificación en verde en la parte superior de la pantalla informándole que el proyecto seha construído e implementado en el servidor de ejecuciones y está disponible para instanciación.

Guía de inicio

28

Page 33: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

Reportar un error

6.5. INSTANCIACIÓN DE PROCESOS EMPRESARIALES

Para crear una instancia del proceso Hello World, es decir, ejecutar el proceso empresarial, haga losiguiente:

1. Haga clic en Process Management → Process Definitions en el menú principal.

2. En la pestaña Process Definitions que se presenta ubique el Hello World. Es posibleque tenga que hacer clic en Refresh 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 Form haga clic en el botón play ( ) para confirmar que quiere instanciar el proceso.

El proceso se instancia con el usuario que actualmente está en sesión como propietario delproceso y el formato del proceso se presenta (el formato puede servir para solicitar entrada deun usuario en la instanciación de procesos si está definido; consulte la Red Hat JBoss BPMSUser Guide).

Se presenta la vista Process Instance Details con los detalles sobre la instancia del procesoiniciado. Aparece el mensaje Hello World! en la salida estándar, usualmente el emulador terminal enel que se inició el servidor. Luego la instancia del proceso espera por el evento temporizador. Haga clicen Views - Process Model para ver el estado actual de ejecución.

Figura 6.3. Diagrama de ejecución en tiempo real HelloWorld: el evento temporizador enejecución

Reportar un error

6.6. CANCELACIÓN DE PROCESOS EMPRESARIALES

En este momento está ejecutando una instancia del proceso HelloWorld en el servidor de ejecución(siendo ejecutado). Puede chequear la vista Process Instances: para presentar la vista vaya aProcess Management → Process Instances.

CAPÍTULO 6. PROCESO HELLO WORLD

29

Page 34: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

Desde 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 HelloWorld está esperando por el evento temporizador, cancélela:

haga clic en ( ) en la línea con la información sobre la instancia del proceso HelloWorld: lainstancia desaparecerá de la lista de instancias de procesos activos y aparecerá en la lista de instanciasAborted.

Figura 6.4. Instancias de procesos cancelados incluyendo la instancia del proceso HelloWorld

Reportar un error

Guía de inicio

30

Page 35: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

CAPÍTULO 7. REGLAS EMPRESARIALES HELLO WORLDYa que BPMS viene con BRMS integrado, este capítulo proporciona una introducción a la manera enque 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á unaregla 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 ytécnicas más avanzadas tal como tablas de decisiones. Para mayor información sobre las reglasempresariales 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 verdaderoentonces algo pasa (por ejemplo, cuando la persona es mayor de 18 años, pueden acceder elcontenido particular). Las reglas empresariales se almacenan en archivos DRL.

Para definir la regla empresarial helloworldrule en el proyecto HelloWorld haga lo siguiente:

1. En el Project Explorer seleccione la unidad organizacional helloworld, el repositorio helloworldrepo, el proyecto HelloWorld y el paquete default.

NOTA

Asegúrese de seleccionar el paquete default. El seleccionar un paqueteincorrecto causa que la implementación falle.

2. Crear el archivo DRL:

a. En el menú de perspectivas haga clic en New Item → DRL file.

b. En la casilla Create new defina el nombre del recurso como helloworldrule yverifique que la ruta destino sea default://master@helloworldrepo/HelloWorld/src/main/resources.

c. Haga clic en Aceptar.

3. En el editor DRL que se presenta con el archivo helloworldrule.drl defina la regla:

Esta regla no define ninguna condición cuando, es decir que siempre será verdadera cuando sedispare (llamada a ejecutar) y se imprimirá la frase Hello World!.

4. Haga clic en Save.

rule "helloworldrule"ruleflow-group "helloworldgroup"when then System.out.println("Hello World!");end

CAPÍTULO 7. REGLAS EMPRESARIALES HELLO WORLD

31

Page 36: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

5. Se presenta un campo Save this item. Ingrese el Check-in comment y haga clic enguardar.

NOTA

El comentario de registro sería una descripción corta de la clase de cambio querealizó y se tiene que ingresar cada vez que se guarda un activo.

Reportar un error

7.2. AGREGACIÓN DE LA TAREA DE REGLAS EMPRESARIALES

Una tarea de reglas empresariales es una tarea que dispara reglas que pertenecen a cierto grupo deflujo 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 Project Explorer seleccioneel proyecto HelloWorld, el paquete org.jbpm, haga clic en BUSINESS PROCESSES y haga clicen el proceso HelloWorld.

NOTA

Asegúrese de seleccionar el paquete org.jbpm. El seleccionar un paqueteincorrecto causa que la implementación falle.

2. En el diseñador de procesos empresariales que se presenta con el proceso helloworld, ampliela paleta Object Library con los elementos del proceso: haga clic en el botón con doble

flecha ( ) en la esquina superior izquierda de la pestaña del diseñador de procesosempresariales.

3. Amplie el menú Tasks 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 Properties:

Nombre: BusinessRule

Grupo de flujo de reglas: helloworldgroup

La propiedad Ruleflow Group define el grupo de reglas que se deben disparar cuando seestá ejecutando la tarea. En este ejemplo, solo una regla, la reglahelloworldgroupdefinida en el archivo helloworldrule.drl, está presente en el grupo helloworldgroup.

Guía de inicio

32

Page 37: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

Figura 7.1. El proceso helloworld con la tarea de reglas empresariales y sus propiedades

5. Haga clic en el botón para guardar para mantener los cambios.

Reportar un error

7.3. CONSTRUCCIÓN E IMPLEMENTACIÓ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 Authoring → Project Authoring.

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 Tools →Project Editor.

4. Verifique que los detalles del proyecto estén correctos en el Project Screen y haga clic en elbotón Build & Deploy en la esquina superior derecha de la vista de la pantalla del proyecto.

Figura 7.2. Editor de proyectos con las siguientes propiedades del proyecto helloWorld

Aparece una notificación en verde en la parte superior de la pantalla informándole que el proyecto seconstruyó e implementó en el servidor de ejecuciones y que está disponible para ser instanciado. Noteque la versión anterior de la implementación helloWorld se substituye con la nueva versión con la

CAPÍTULO 7. REGLAS EMPRESARIALES HELLO WORLD

33

Page 38: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

tarea de la regla empresarial. Para mantener ambas implementaciones, cambie el número de la versióndel proyecto en el editor de proyectos.

Reportar un error

7.4. INSTANCIACIÓN DE PROCESOS EMPRESARIALES

Para crear una instancia del proceso Hello World, es decir, ejecutar el proceso empresarial, haga losiguiente:

1. Haga clic en Process Management → Process Definitions en el menú principal.

2. En la pestaña Process Definitions que se presenta ubique el Hello World. Es posibleque tenga que hacer clic en Refresh 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 Form haga clic en el botón play ( ) para confirmar que quiere instanciar el proceso.

El proceso se instancia con el usuario que actualmente está en sesión como propietario delproceso y el formato del proceso se presenta (el formato puede servir para solicitar entrada deun usuario en la instanciación de procesos si está definido; consulte la Red Hat JBoss BPMSUser Guide).

Se presenta la vista Process Instance Details con los detalles sobre la instancia del procesoiniciado. Aparece el mensaje Hello World! en la salida estándar, usualmente el emulador terminal enel que se inició el servidor. Luego la instancia del proceso espera por el evento temporizador. Haga clicen Views - Process Model para ver el estado actual de ejecución.

Figura 7.3. Diagrama de ejecución en tiempo real HelloWorld: el evento temporizador enejecución

Reportar un error

Guía de inicio

34

Page 39: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

CAPÍTULO 8. BAM

8.1. ACCESO AL CONSTRUCTOR DE PÁNELES DE LA SUITE BPMJBOSS RED HAT

El constructor de páneles es la interfaz de usuario basada en red de la suite BPM JBoss Red Hat paramonitoreo de actividades empresariales. Para acceder el constructor de páneles desde la centralempresarial vaya a Dashboards → Process & Task Dashboards.

El pánel que se presenta proporciona estadísticas sobre los datos en tiempo de ejecuciónseleccionados a su izquierda. Puede crear su propio pánel en el constructor de páneles que sepresenta al hacer clic en Dashboards → Business Dashboards.

Reportar un error

8.2. MONITORIZACIÓN DE INSTANCIAS

El constructor de páneles proporciona un pánel especial que le permite monitorear el estado de losdatos en tiempo de ejecución (instancias de procesos y tareas) en su máquina de ejecución.

Para ver estos datos vaya a Dashboards → Process & Task Dashboard.

Figura 8.1. Pánel de tareas y procesos

En el panel de la izquierda puede seleccionar una entidad para la cual presentar estadísticas. Las tablasy los datos a la derecha se actualizan de acuerdo con esto.

Reportar un error

CAPÍTULO 8. BAM

35

Page 40: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

CAPÍTULO 9. ESTUDIO DEL DESARROLLADOR JBOSS DERED HATRed Hat JBoss Developer Studio es el entorno de desarrollo integrado de JBoss (IDE del inglésintegrated development environment) basado en Eclipse y disponible en el portal de soporte del clientede Red Hat en https://access.redhat.com. Red Hat JBoss Developer Studio proporciona plug-ins conherramientas e interfaces para Red Hat JBoss BRMS y Red Hat JBoss BPM Suite. Estos plugins sebasan en la versión de la comunidad de estos productos. Así que el plugin BRMS se llama el pluginDrools 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óny configuración.

Reportar un error

9.1. CENTRAL DE JBOSS

Cuando se inicia por primera vez JBoss Developer Studio 7.0, se presenta la central de JBoss en laventana principal del banco de trabajo. Desde la central de JBoss es posible crear nuevos proyectosseleccionando las opciones del menú bajo Start from scratch. Los proyectos de ejemplo sepueden iniciar seleccionando los enlaces bajo Start from a sample.

Figura 9.1. Central de JBoss

Guía de inicio

36

Page 41: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

Reportar un error

9.2. INSTALACIÓN DE LOS PLUGINS DEL ESTUDIO DELDESARROLLADOR JBOSS

Los plugins Drools y jBPM para el estudio desarrollador JBoss están disponibles a través del sitio deactualización.

Procedimiento 9.1. Instalación del plugin del estudio desarrollador JBoss Drools y jBPM

1. Inicie el estudio desarrollador JBoss.

2. Seleccione Help → Install New Software.

3. Haga clic en Add para ingresar el menú Add Repository.

4. Dele un nombre al sitio software junto al campo Name y agregue la siguiente url en el campo Location:https://devstudio.jboss.com/updates/7.0/integration-stack/

5. Haga clic en OK

6. Seleccione la funcionalidad JBoss Business Process and Rule Development de lasopciones 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 Finish.

8. Después de que la instalación de los plug-ins se haya completado, reinicie el estudiodesarrollador JBoss.

Reportar un error

9.3. CONFIGURACIÓN DEL TIEMPO DE EJECUCIÓN DROOLS

Con el fin de utilizar el plugin BRMS JBoss con Red Hat JBoss Developer Studio es necesarioestablecer el tiempo de ejecución.

Un tiempo de ejecución es una colección de archivos jar que representan un lanzamiento específico delsoftware y proporciona las bibliotecas que se necesitan para la compilación y ejecución de sus activosempresariales.

Extraiga los archivos jar de tiempo de ejecución que se encuentran en el archivador jboss-brms-engine.zip del archivador zip implementable genérico JBoss BRMS (no el archivador zip implementableEAP6) (disponible en el portal del cliente de Red Hat).

Procedimiento 9.2. Configuración del tiempo de ejecución BRMS

1. Del menú JBoss Developer Studiot seleccione Window y haga clic en Preferences.

2. Seleccione Drools → Installed Drools Runtimes.

3. Haga clic en Add...; proporcione un nombre para el nuevo tiempo de ejecución y haga clic en Browse para navegar al directorio en donde se encuentra el tiempo de ejecución. Haga clic enOK para registrar el tiempo de ejecución seleccionado en JBDS.

CAPÍTULO 9. ESTUDIO DEL DESARROLLADOR JBOSS DE RED HAT

37

Page 42: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

4. Marca el tiempo de ejecución que usted ha creado como el tiempo de ejecución Droolspredeterminado haciendo clic en la casilla al lado de este.

5. Haga clic en OK. Si tiene proyectos existentes, una ventana de diálogo indicará que tiene quereiniciar JBoss Developer Studio para actualizar el tiempo de ejecución.

Reportar un error

9.4. CONFIGURACIÓN DEL TIEMPO DE EJECUCIÓN JBPM

Con el fin de utilizar el plugin jBPM con Red Hat JBoss Developer Studio es necesario establecer eltiempo de ejecución.

Un tiempo de ejecución es una colección de archivos jar que representan un lanzamiento específico delsoftware.

Si descargó previamente el archivador zip implementable genérico de la suite BPM JBoss del portal delcliente de Red Hat, los archivos jars que componen el tiempo de ejecución se encuentran en elarchivador jboss-bpms-engine.zip.

Procedimiento 9.3. Configuración del tiempo de ejecución jBPM

1. Del menú JBoss Developer Studiot seleccione Window y haga clic en Preferences.

2. Seleccione jBPM → Installed jBPM Runtimes.

3. Haga clic en Add...; proporcione un nombre para el nuevo tiempo de ejecución y haga clic en Browse para navegar al directorio en donde se encuentra el tiempo de ejecución.

4. Haga clic en OK, seleccione el nuevo tiempo de ejecución y haga clic en OK de nuevo . Si tieneproyectos existentes, una ventana de diálogo indicará que tiene que reiniciarJBoss Developer Studio para actualizar el tiempo de ejecución.

Reportar un error

9.5. CONFIGURACIÓN DEL SERVIDOR DE LA SUITE BPM JBOSS

El estudio desarrollador JBoss se puede configurar para ejecutar el servidor de la suite BPM JBoss deRed Hat.

Procedimiento 9.4. Configuración del servidor

1. Abra la vista jBPM seleccionando Window → Open Perspective → Other y seleccione Drools y haga clic en OK.

2. Agregue la vista del servidor seleccionando Window → Show View → Other... y seleccioneServer → Servers.

3. Abra el menú del servidor haciendo clic con el botón derecho del ratón en el panel del servidory seleccione New → Server.

4. Defina el servidor seleccionando JBoss Enterprise Middleware → JBoss EnterpriseApplication Platform 6.1+ y haciendo clic en Next.

Guía de inicio

38

Page 43: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

5. Establezca el directorio de inicio haciendo clic en el enlace en el botón Browse. Navegue hastael directorio de instalación y selecciónelo para JBoss EAP 6.1.1, el cual tiene la suite BPMJBoss instalada.

6. Proporcione un nombre para el servidor en el campo Name, asegúrese de que el archivo deconfiguración se establece como y haga clic en Finish.

Reportar un error

9.6. IMPORTACIÓN DE PROYECTOS DESDE UN REPOSITORIO GIT AJBOSS DEVELOPER STUDIO

El estudio desarrollador JBoss se puede configurar para conectarse a un repositorio de activos Gitcentral. En el repositorio se almacenan las versiones de las reglas, modelos, funciones y procesos. Esterepositorio 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.

Procedimiento 9.5. Importación de un repositorio local Git

1. Inicie la suite BPM JBoss de Red Hat (si todavía no está ejecutando) seleccionando el servidorde la pestaña de servidores y haga clic en el ícono de inicio.

2. Seleccione File → Import... y navegue a la carpeta Git. Abra la carpeta Git para seleccionarProjects from Git y haga clic en siguiente.

3. Seleccione la fuente del repositorio Existing local repository y haga clic en siguiente.

Figura 9.2. Detalles del repositorio Git

4. Seleccione el repositorio que se va a configurar de la lista de repositorios disponibles.

CAPÍTULO 9. ESTUDIO DEL DESARROLLADOR JBOSS DE RED HAT

39

Page 44: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

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.

Procedimiento 9.6. Clonación de un repositorio remoto Git

1. Inicie la suite BPM JBoss de Red Hat (si todavía no está ejecutando) seleccionando el servidorde 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 elsiguiente comando. Este comando es específico para Linux y Mac sólamente. En estasplataformas, si sshd ya se inició entonces este comando fallará y puede ignorar de manerasegura este paso.

3. Seleccione File → Import... y navegue a la carpeta Git. Abra la carpeta Git para seleccionarProjects from Git y haga clic en siguiente.

4. Seleccione la fuente del repositorio Clone URI y haga clic en siguiente.

5. Ingrese los detalles del repositorio Git en la siguiente ventana y haga clic en siguiente.

/sbin/service sshd start

Guía de inicio

40

Page 45: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

Figura 9.3. Detalles del repositorio Git

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 (oseleccione) un directorio que no esté vacío, haga los cambios en la configuración y haga clic ensiguiente.

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 PROYECTO DROOLS

Procedimiento 9.7. Creación de un nuevo proyecto Red Hat JBoss Developer Studio

1. Del menú principal seleccione File → New → Project.

CAPÍTULO 9. ESTUDIO DEL DESARROLLADOR JBOSS DE RED HAT

41

Page 46: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

Seleccione Drools → Drools Project y haga clic en Next.

2. Ingrese un nombre para el proyecto en la casilla Project name: y haga clic en Next.

NOTA

JBoss Developer Studio proporciona la opción para agregar un archivo de reglasHelloWorld de ejemplo al proyecto. Acepte esta opción predeterminada haciendoclic en Next para probar el proyecto de ejemplo en los siguientes pasos.

3. Seleccione el tiempo de ejecución Drools (o use el predeterminado).

4. Seleccione el código compatible con Drools 6.0.x. Ingrese un GroupID, un ArtifactID yla Version y haga clic en Finish.

5. Para probar el proyecto, haga clic con el botón derecho del ratón en el archivo Java quecontiene el método principal y seleccione Run → run as → Java Application.

La salida se presentará en la pestaña de la consola.

Reportar un error

9.8. CREACIÓN DE UN PROYECTO JBPM

Procedimiento 9.8. Creación de un nuevo proyecto Red Hat JBoss Developer Studio

1. Del menú principal seleccione File → New → Project.

Seleccione jBPM → jBPM Project y haga clic en Next.

2. Ingrese un nombre para el proyecto en la casilla Project name: y haga clic en Next.

NOTA

JBoss Developer Studio proporciona la opción para agregar un archivo de reglasHelloWorld de ejemplo al proyecto. Acepte esta opción predeterminada haciendoclic 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 jBPM 6 o posteriores y haga clic en Finish.

5. Para probar el proyecto, haga clic con el botón derecho del ratón en el archivo Java quecontiene el método principal y seleccione Run → run as → Java Application.

La salida se presentará en la pestaña de la consola.

Reportar un error

Guía de inicio

42

Page 47: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

CAPÍTULO 10. PLANIFICADOR DE RECURSOSEMPRESARIALESEl planificador de recursos empresariales está disponible como un avance técnico con la suite BPMJBoss de Red Hat. El planeador de recursos empresariales es una máquina ligera incluíble deplaneación que optimiza los problemas de planeación. Ayuda a los programadores TM Java normales aresolver problemas de planeación de manera eficiente y combina heurística de optimización ymetaheurística con cálculos muy eficientes.

El planificador ayuda a solucionar varios casos como los siguientes:

Empleados/lista de pacientes. En planificador ayuda a crear horarios para las enfermeras ymantiene registros de la administración de las camas de los pacientes.

Horarios educacionales. El planificador ayuda a programar clases, cursos, exámenes ypresentaciones de conferencias.

Horarios del taller: El planificador mantiene registros de las cadenas de fabricación, planeaciónde colas de máquinas y planeación de tareas del personal.

Recorte de recursos: El planificador minimiza los desperdicios reduciendo el consumo derecursos tal como papel y acero.

Reportar un error

10.1. INSTALACIÓN DEL PLANIFICADOR DE RECURSOSEMPRESARIALES

1. Navegue al portal del cliente de Red Hat e inicie sesión con sus credenciales de usuario.

2. Seleccione Downloads → Red Hat JBoss Middleware → Download Software.

3. Del menú desplegable Products seleccione BPM Suite.

4. Del menú desplegable Version seleccione la versión del producto 6.0.2.

5. Seleccione Red Hat JBoss BPM Suite 6.0.2 Business Resource Planner y hagaclic en Download.

Reportar un error

10.2. EJECUCIÓN DE LOS EJEMPLOS DEL PLANIFICADOR DERECURSOS EMPRESARIALES

1. En la línea de comandos vaya hasta el directorio examples/.

2. En un entorno Unix ejecute el siguiente comando:

./runExamples.sh

En un entorno Windows ejecute el siguiente comando:

./runExamples.bat

CAPÍTULO 10. PLANIFICADOR DE RECURSOS EMPRESARIALES

43

Page 49: Suite BPM JBoss de Red Hat 6 · componentes de la suite bpm jboss de red hat 1.3. ... configuraciÓn del tiempo de ejecuciÓn jbpm ... introducciÓn 5

APÉNDICE A. HISTORIAL DE REVISIONES

Revisión 1.0.0-1 Wed Aug 06 2014 CS Builder RobotBuilt from Content Specification: 22690, Revision: 684299

APÉNDICE A. HISTORIAL DE REVISIONES

45