red hat jboss bpm suite 6 · 2017-11-22 · 3. en la página descargas de productos que se abre,...

45
Red Hat JBoss BPM Suite 6.2 Guía de inicio La guía de inicio para Red Hat JBoss BPM Suite Last Updated: 2017-11-22

Upload: others

Post on 04-Jun-2020

16 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

Red Hat JBoss BPM Suite 6.2

Guía de inicio

La guía de inicio para Red Hat JBoss BPM Suite

Last Updated: 2017-11-22

Page 2: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione
Page 3: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

Red Hat JBoss BPM Suite 6.2 Guía de inicio

La guía de inicio para Red Hat JBoss BPM Suite

Kanchan [email protected]

Doug Hoffman

Eva Kopalova

Red Hat Content Services

Page 4: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

Legal Notice

Copyright © 2015 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 ayuda a los usuarios a instalar y configurar Red Hat JBoss BPM Suite por primera vez.

Page 5: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

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

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

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

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

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

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

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

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

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

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

Table of Contents

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

CAPÍTULO 2. OPCIONES DE INSTALACIÓN2.1. LA INSTALACIÓN AGRUPADA EAP62.2. LA INSTALACIÓN AGRUPADA GENÉRICA IMPLEMENTABLE2.3. INICIO DEL SERVIDOR2.4. ADMINISTRADOR DE SEGURIDAD JAVA Y ADMINISTRACIÓN DE RENDIMIENTO

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

CAPÍTULO 4. PROYECTO HELLO WORLD4.1. CREACIÓN DE UNA ESTRUCTURA DE REPOSITORIO

CAPÍTULO 5. PROCESO HELLO WORLD5.1. CREACIÓN DE PROCESOS EMPRESARIALES5.2. MODELADO DE PROCESOS EMPRESARIALES5.3. DEFINICIÓN DE PROPIEDADES DEL ELEMENTO5.4. CONSTRUCCIÓN E IMPLEMENTACIÓN5.5. INSTANCIACIÓN DE PROCESOS EMPRESARIALES5.6. CANCELACIÓN DE PROCESOS EMPRESARIALES

CAPÍTULO 6. REGLAS EMPRESARIALES HELLO WORLD6.1. CREACIÓN DE LA REGLA EMPRESARIAL6.2. AGREGACIÓN DE LA TAREA DE REGLAS EMPRESARIALES6.3. CONSTRUCCIÓN E IMPLEMENTACIÓN6.4. INSTANCIACIÓN DE PROCESOS EMPRESARIALES

CAPÍTULO 7. BAM7.1. ACCESO A RED HAT JBOSS BPM SUITE DASHBUILDER7.2. MONITORIZACIÓN DE INSTANCIAS

CAPÍTULO 8. RED HAT JBOSS DEVELOPER STUDIO8.1. CENTRAL DE JBOSS8.2. INSTALACIÓN DE JBOSS DEVELOPER STUDIO PLUG-INS8.3. CONFIGURACIÓN DEL TIEMPO DE EJECUCIÓN DROOLS8.4. CONFIGURACIÓN DEL TIEMPO DE EJECUCIÓN DE JBOSS BPM SUITE8.5. CONFIGURACIÓN DEL SERVIDOR JBOSS.8.6. IMPORTACIÓN DE PROYECTOS DESDE UN REPOSITORIO GIT A JBOSS DEVELOPER STUDIO8.7. CREACIÓN DE UN PROYECTO DROOLS8.8. CREACIÓN DE UN PROYECTO JBOSS BPM SUITE

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

APÉNDICE A. HISTORIA DE REVISIONES

3

448

1617

19

2020

22222223242425

2727282930

313131

323233343435353839

404040

41

Table of Contents

1

Page 6: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

Guía de inicio

2

Page 7: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

CAPÍTULO 1. 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. Se requiere un servidor Red Hat JBoss EAP (versión 6.4 o posteriores) ya existente ya que elinstalador no instala uno.

Procedimiento 1.1. Inicio rápido de Red Hat JBoss BPM Suite

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

2. Ejecute el instalador ejecutando el siguiente comando:

java -jar jboss-bpmsuite-6.2.0.GA-installer.jar

3. Siga los pasos del instalador GUI tomando nota del nombre de usuario/contraseña para accedera la aplicación JBoss BPM Suite 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 JBoss BPM Suite.

5. Inicie el servidor JBoss BPM Suite con 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 JBoss BPM Suite que creó en elmomento de la instalación.

Usted ha instalado correctamente y ejecutado Red Hat JBoss BPM Suite . Ahora puede hacer losiguiente:

Aprender más sobre los roles: Sección 2.1.3, “Definición de roles”

Crear usuarios adicionales: Sección 2.1.4, “Creación de usuarios”

Crear un proyecto Hello World: Capítulo 4, Proyecto Hello World

Busque instrucciones detalladas de instalación para usar el instalador: Installation Guide

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

3

Page 8: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

CAPÍTULO 2. OPCIONES DE INSTALACIÓNRed Hat JBoss BPM Suite viene en dos versiones:

Instalador jar para la instalación en Red Hat JBoss Enterprise Application Platform (EAP) 6.4.

Archivo comprimido de instalación, el cual viene en dos versiones:

Según su entorno, puede seleccionar la opción de instalación que mejor se ajuste a las necesidades delproyecto.

NOTA

Red Hat JBoss BPM Suite está diseñado para trabajar con la codificación UTF-8. Si laMVJ subyacente, utiliza un sistema de codificación diferente, se presentarán erroresinesperados. Para asegurarse que UTF-8 sea utilizado por la MVJ, use la siguientepropiedad de sistema "-Dfile.encoding=UTF-8".

IMPORTANTE

A partir de BPM Suite JBoss 6.1 y posteriores, debe tener instalado JBoss EAP 6.4 osuperior antes de intentar instalar JBoss BPM Suite.

2.1. LA INSTALACIÓN AGRUPADA EAP6

Esta sección describe la instalación del paquete de Red Hat JBoss BPM Suite implementable para laRed Hat JBoss Enterprise Application Platform (EAP).

NOTA

La versión mínima soportada de Red Hat JBoss EAP para la instalación de Red HatJBoss BPM Suite es 6.4.

2.1.1. Descarga del paquete Red Hat JBoss EAP6

Para descargar el paquete implementable de Red Hat JBoss BPM Suite para JBoss EnterpriseApplication Platform, haga lo siguiente:

1. Vaya al Portal del cliente de Red Hat e ingrese.

2. Haga clic en Descargas → Descargas de productos.

3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite.

4. Del menú desplegable Versión seleccione la versión 6.2.

5. En la página Descargas de software que se abre, navegue a la fila Red Hat JBoss BPM Suite 6.2 implementable para EAP 6.4 y haga clic en Descargar.

2.1.2. Instalación del paquete Red Hat JBoss EAP6

Instalación en una nueva instancia JBoss EAP

Guía de inicio

4

Page 9: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

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

1. Extraiga el paquete zip implementable para JBoss EAP que descargó del Portal del cliente deRed Hat.

2. Agrupe el paquete zip extraído para JBoss EAP en el directorio SERVER_HOME de JBossEAP.

AVISO

Este paso debe ser realizado con la misma cuenta de usuario que se utilizópara instalar JBoss EAP. Esta cuenta no debe ser la cuenta delsuperusuario.

3. En este proceso, se sobreescribirán múltiples archivos en el directorio JBoss EAPSERVER_HOME y usted debe permitir que el proceso de descompresión sobreescriba estosarchivos. Un ejemplo de un archivo que se sobreescribe es el archivo SERVER_HOME/bin/product.conf. Después de una agrupación exitosa, este archivo debecontener la cadena slot=bpms. Puede abrir este archivo para verificar que los archivos sehayan sobreescrito de manera exitosa.

En Red Hat Enterprise Linux puede utilizar el siguiente comando para extraer el archivo zip Red HatJBoss BPM Suite y unirlo con su directorio de servidor correctamente en un paso, si ejecuta estecomando en el directorio en donde descargó el archivo zip:

Ejemplo 2.1. El comando para descomprimir

En el arranque del servidor se implementará Red Hat JBoss BPM Suite.

Instalación en una configuración JBoss EAP existente

AVISO

Estas instrucciones son para instalación y NO para actualizar una instancia deJBoss BPM Suite. Asegúrese de que no haya ninguna instalación JBoss BPM enJBoss EAP de destino.

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

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

CAPÍTULO 2. OPCIONES DE INSTALACIÓN

5

Page 10: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

Para instalar el paquete implementable para un JBoss EAP previamente configurado, haga lo siguiente:

1. Extraiga el paquete zip implementable para JBoss EAP que descargó del Portal del cliente deRed 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.4/domain/configuration/* - (por favor tenga en cuenta que JBossBMP Suite requiere JMS así que JMS se agrega por defecto en todos los perfiles en domain.xml proporcionado por la distribución JBoss BPM Suite).

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

jboss-eap-6.4/modules/layers.conf

jboss-eap-6.4/bin/product.conf

3. Asegúrese de que JBoss EAP de destino no incluya una implementación con un nombre quecree conflictos. Copie la carpeta jboss-eap-6.4/standalone/deployments en eldirectorio EAP_HOME de la distribución JBoss BPM Suite.

4. Asegúrese de que no se ha llamado antes la capa del módulo JBoss EAP denominada JBossBPM Suite y copie la carpeta jboss-eap-6.4/modules/system/layers/bpms en lacarpeta EAP 6.4.

2.1.3. Definición de roles

Antes de iniciar el servidor e iniciar sesión en la Central empresarial necesitará crear algunas cuentasde usuarios. Esta sección describe los diferentes roles de usuario que se utilizan en Red Hat JBossBPM 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 admin tienenacceso a todas las áreas dentro del sistema.

desarrollador: un desarrollador tiene acceso a casi todas las funcionalidades y puedeadministrar reglas, modelos, flujos de procesos, formas y paneles. Puede administrar elrepositorio de activos, crear, construir e implementar proyectos e incluso puede usar Red HatJBoss Developer Studio para ver procesos. Solamente se ocultan ciertas funcionesadministrativas como la creación y clonación de un nuevo repositorio para el rol deldesarrollador.

analyst: un rol de analista tiene acceso a todas las funcionalidades de alto nivel para modelar yejecutar sus proyectos. Sin embargo, el acceso Autoría → Administración no está disponiblepara los usuarios con el rol de analista. Ciertas funcionalidades de menor nivel orientadas a losdesarrolladores como la vista Implementación → Repositorio de artefactos no sonaccesibles para este rol. Sin embargo, el botón Construir e implementar está disponiblepara el rol de analista cuando utiliza el editor de proyectos.

Guía de inicio

6

Page 11: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

usuario: un usuario o un usuario empresarial trabaja en las listas de tareas empresariales quese utilizan para operar cierto proceso. Un usuario con este rol puede acceder el panel yadministrar procesos.

mánager: un mánager es un observador del sistema que está interesado en las estadísticasrelacionadas con los procesos empresariales y su rendimiento, indicadores empresariales yotros reportes del sistema. Un usuario con este rol tiene acceso únicamente al BAM.

NOTA

Ingrese los roles mencionados anteriormente durante el proceso de creación del usuario.Para mayor información sobre roles, consulte Chapter 2. Business Central configuration.Para mayor información sobre roles e interacciones de tareas consulte Appendix 11.5User Task.

2.1.4. Creación de usuarios

Para comenzar a agregar nuevos usuarios, deberá ejecutar el script add-user.sh en un sistema Unix o elarchivo 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 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 de nombre del usuario ingrese un nombre de usuario y confirme. Por ejemplo: helloworlduser.

NOTA

Asegúrese de que los nombres de usuario no estén en conflicto con los gruposconocidos. Por ejemplo, si existe un grupo llamado admin, no debe crear unusuario con el nombre de usuario admin.

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 y debe tener caracteres enmayúsculas y minúsculas (por ejemplo, A-Z, a-z), por lo menos un caracternumérico (por ejemplo,. 0-9) y como mínimo un caracter especial (por ejemplo, ~! @ # $ % ^ * ( ) - _ + =).

6. Ingrese una lista de roles separada por comas en el indicador de roles (consulte Sección 2.1.3,“Definición de roles”).

7. Confirme que desea agregar el usuario.

8. Ingrese 'Sí' en el siguiente campo (con el fin de habilitar el agrupamiento en el futuro si serequiere).

CAPÍTULO 2. OPCIONES DE INSTALACIÓN

7

Page 12: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

2.2. LA INSTALACIÓN AGRUPADA GENÉRICA IMPLEMENTABLE

Para instalar Red Hat JBoss BPM Suite en el Red Hat JBoss Web Server (EWS), necesita utilizar elpaquete implementable genérico del producto.

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

Observe que el paquete implementable genérico requiere los siguientes archivos ZIP:

jboss-bpmsuite-VERSION-deployable-generic.zip: contiene las aplicaciones web business-central.war, dashbuilder.war y kie-server.war.

jboss-bpmsuite-VERSION-engine.zip: bibliotecas de motor de ejecución para incorporarel motor en su aplicación y otras bibliotecas necesarias para implementación genérica.

2.2.1. Descarga del paquete genérico implementable

Para descargar el paquete genérico implementable Red Hat JBoss BPM Suite para JBoss Web Server,haga lo siguiente:

1. Vaya al Portal del cliente de Red Hat e ingrese.

2. Haga clic en Descargas.

3. En la lista de productos haga clic en Red Hat JBoss BPM Suite.

4. Desde el menú desplegable Versión, seleccióne la version 6.2 (si aún no ha seleccionado).

5. En la sección de Descargas de software que aparece, navegue a la fila Red Hat JBoss BPM Suite 6.2 implementable para todos los contenedores soportados y luegohaga clic en Descargar.

6. También navegue a la fila de archivos Red Hat JBoss BPM Suite 6.2 Engine y haga clicen Descargar para descargar los archivos JBoss BPM Suite Engine.

2.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 2.2.2.1, “Configuración del gestor de transacciones para Red Hat JBoss Web Server2.1 (Tomcat 7)”).

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

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

2.2.2.1. Configuración del gestor de transacciones para Red Hat JBoss Web Server 2.1(Tomcat 7)

Guía de inicio

8

Page 13: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

1. Extraiga el paquete zip genérico implementable que descargó del Portal del cliente de Red Hata una ubicación temporal. Este paquete zip contiene los siguientes tres archivos de aplicacionesweb: business-central.war, dashbuilder.war y kie-server.war en un formatoexpandido. Renombre estas carpetas para borrar la extensión .war.

2. Copie estas carpetas directamente en la carpeta $TOMCAT_DIR/webapps.

Al final debe tener tres carpetas en un formato expandido: $TOMCAT_DIR/webapps/business-central, $TOMCAT_DIR/webapps/dashbuilder y $TOMCAT_DIR/webapps/kie-server.

NOTA

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

3. Extraiga el contenido de los archivos JBoss BPM Suite Engine del archivador a una ubicacióntemporal desde donde pueda copiar las bibliotecas requeridas. Esta carpeta ahora contienetodas las bibliotecas centrales JBoss BPM Suite en la carpeta extraída y una carpeta lib.

4. Instale el gestor de transacciones.

AVISO

Por favor observe que la siguiente sección describe la configuración de ungestor de transacciones, Bitronix que no recibe oficialmente soporte de RedHat.

Copie las siguientes bibliotecas jar del administrador de transacciones de la carpeta lib aldirectorio $TOMCAT_DIR/lib/:

btm-VERSION.jar

btm-tomcat55-lifecycle-VERSION.jar

jta-VERSION.jar

slf4j-api-VERSION.jar

slf4j-jdk14-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 datosCopie el archivo jar con el controlador de base de datos relevante para $TOMCAT_DIR/lib/.

CAPÍTULO 2. OPCIONES DE INSTALACIÓN

9

Page 14: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

NOTA

Si utiliza la base de datos H2 integrada, 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 2.2. Definición de la fuente de datos H2

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

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

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=10resource.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

Guía de inicio

10

Page 15: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

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

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

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 archivo setenv.sh con el siguiente contenido:

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/bpmsresource.ds1.driverProperties.user=dbuserresource.ds1.driverProperties.password=dbpasswordresource.ds1.allowLocalTransactions=true

resource.ds1.className=com.microsoft.sqlserver.jdbc.SQLServerDriverresource.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 -Djava.security.auth.login.config=$CATALINA_HOME/webapps/business-

CAPÍTULO 2. OPCIONES DE INSTALACIÓN

11

Page 16: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

La propiedad org.jbpm.designer.perspective se establece como RuleFlow para que laperspectiva para el diseñador sea RuleFlow en lugar de Full. Otórguele al archivo permisosde ejecución si aplica.

La propiedad java.security.auth.login.config debe establecerse para que funcione elclon ssh del repositorio git.

IMPORTANTE

En sistemas Microsoft Windows remplace 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:

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

Para establecer la central empresarial haga lo siguiente:

1. Configure Valve para que la aplicación web de la Central empresarial pueda cargar losusuarios configurados 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 (para más información sobre definiciones de roles y usuarios consulte ladocumentación de Tomcat 7).

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

NOTA

Asegúrese de que los nombres de usuario no entren en conflicto con losroles conocidos. Por ejemplo, no debe crear un usuario con el nombre deusuario admin.

central/WEB-INF/classes/login.config -Dbtm.root=$CATALINA_HOME -Dbitronix.tm.configuration=$CATALINA_HOME/conf/btm-config.properties -Dorg.jbpm.designer.perspective=RuleFlow -Djbpm.tsr.jndi.lookup=java:comp/env/TransactionSynchronizationRegistry"

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"

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

Guía de inicio

12

Page 17: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

b. Desplace (no copie) kie-tomcat-integration-VERSION.jar de $TOMCAT_DIR/webapps/business-central/WEB-INF/lib/ a $TOMCAT_DIR/lib/.

c. Copie jboss-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 válvula Tomcat en elelemento relevante <host>:

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 remplace 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):

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

<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"/>

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

CAPÍTULO 2. OPCIONES DE INSTALACIÓN

13

Page 18: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

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 JBoss BPM Suite puedausar la nueva 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. Vaya a http://localhost:8080/business-central en un navegador web.

c. Inicie sesión con el nombre de usuario/contraseña definidos en el archivo tomcat-users.xml.

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

NOTA

Antes de configurar Dashbuilder en Red Hat JBoss Web Server, debe asegurarse detener instalada correctamente la Central Empresarial como se describe enSección 2.2.2.2, “Configuración de una central empresarial para Red Hat JBoss WebServer 2.1 (Tomcat 7)”. Dashbuilder necesita las tablas de base de datos del registro dehistoria para existir, las cuales son provistas únicamente por la Central empresarial. Siestas tablas no están presentes en la base de datos antes de intentar los pasos de abajo,es posible que se presenten errores de inicialización.

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

1. Defina usuarios y roles en $TOMCAT_DIR/conf/tomcat-users.xml. Observe queDashbuilder requiere que los usuarios tengan el rol especificado como admin y/o analyst. Siya definió estos usuarios para la Central empresarial entonces no necesita definirlos de nuevo.

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

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

./startup.sh

Guía de inicio

14

Page 19: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

2. Habilite 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:

3. Como con la configuración de la Central empresarial, si está utilizando una base de datosdiferente a la predeterminada y una base de datos integrada H2, deberá configurar persistencia.

En este procedimiento, configure una fuente de datos con el nombre JNDI jdbc/dashbuilderDS 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 otraspropiedades aquí también. Por ejemplo, en un entorno Oracle esta entradapuede 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:

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

<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 2. OPCIONES DE INSTALACIÓN

15

Page 20: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

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

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.

2.3. INICIO DEL SERVIDOR

Si ha instalado Red Hat JBoss BPM Suite mediante la instalación del paquete JBoss EAP 6, ahorapuede iniciar su servidor en uno de los dos modos.

NOTA

Si instaló JBoss BPM Suite usando la versión implementable genérica en el servidor dered Java de Red Hat, las instrucciones para descargar e instalar también contienen lasinstrucciones para iniciar el servidor. Puede ignorar la siguiente discusión.

El script de arranque predeterminado,standalone.sh con el que se envía Red Hat JBoss BPM Suiteestá 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/bin/.

2. En un entorno Unix, ejecute:

./standalone.sh

En un entorno Windows, ejecute:

./standalone.bat

Red Hat JBoss BPM Suite 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 predeterminada queprotege contra una 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

16

Page 21: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

AVISO

Debe tener en cuenta que el uso de un administrador de seguridad impone unasanción importante en el rendimiento. El compromiso entre la seguridad y elrendimiento se debe realizar teniendo en consideración las circunstanciasindividuales. Consulte Sección 2.4, “Administrador de seguridad Java yadministració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/bin/.

2. En un entorno Unix, ejecute:

./standalone-secure.sh

En un entorno Windows, ejecute:

./standalone-secure.bat

NOTA

Si instaló JBoss BPM Suite con el instalador, recibirá la opción para aplicar la política deseguridad en el momento de la instalación. El instalador no proporciona un script standalone-secure.sh independiente.

NOTA

Si usted está iniciando el servidor en el modo de dominio, los scripts correspondientesson domain.sh y domain-secure.sh respectivamente.

2.4. ADMINISTRADOR DE SEGURIDAD JAVA Y ADMINISTRACIÓN DERENDIMIENTO

Como se observó anteriormente, al habilitar el administrador de seguridad Java (JSM, por sus siglas eninglés) un entorno de prueba completo para la evaluación de scripts MVEL en Red Hat JBoss BPM Suiteintroduce 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 JBoss BPM Suite. Use lassiguientes directrices para implementar aplicaciones seguras JBoss BPM Suite de alto rendimiento.

En entornos de alto rendimiento en donde el rendimiento es crítico se recomienda queúnicamente se implementen aplicaciones que hayan sido desarrolladas en otros sistemas y quehayan sido revisadas apropiadamente. También se recomienda no crear ningún usuario con elrol de analista en dichos sistemas. Si se tienen en cuenta estas medidas entonces es segurodejar JSM inhabilitado en estos sistemas de manera que no introduzca ninguna degradación derendimiento.

CAPÍTULO 2. OPCIONES DE INSTALACIÓN

17

Page 22: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

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 permitir que usuarios con el rol Analyst inicien sesión en la consolade la central empresarial con JSM inhabilitado.

Guía de inicio

18

Page 23: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

CAPÍTULO 3. INICIO DE SESIÓN EN LA CENTRALEMPRESARIALInicie sesión en la central empresarial después de que el servidor ha iniciado correctamente.

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 con 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:Usuario = helloworlduser y contraseña = Helloworld@123.

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

19

Page 24: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

CAPÍTULO 4. PROYECTO HELLO WORLDPara demostrar las funcionalidades básicas de Red Hat JBoss BPM Suite, 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.

4.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 estrutura lógica de "directorio".Cualquier paquete puede contener sus activos empresariales (para mayor información sobre elrepositorio Artifact consulte la Red Hat JBoss BPM Suite 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 Autoría → Administración.

b. En el menú de perspectivas haga clic en Unidades organizacionales → Gestión deunidades organizacionales.

c. En la vista que se presenta Gestor de unidades organizacionales haga clic en Agregar.

En la ventana que se presenta Agregar nueva unidad organizacional defina laspropiedades de las unidades y haga clic en Aceptar:

Nombre: helloworld

Propietario: helloworlduser

Guía de inicio

20

Page 25: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

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

a. Vaya a Autoría → Administración.

b. En el menú de perspectivas haga clic en Repositorios → Nuevo repositorio.

c. En la ventana que se presenta Crear repositorio defina las propiedades delrepositorio:

Nombre del repositorio: helloworldrepo

Unidad organizacional: helloworld

4. Vaya a Autoría → Autoría de proyectos.

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 4.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 Nuevo ítem → Proyecto

b. En la ventana que se presenta Crear nuevo defina las propiedades del proyecto:

Nombre del recurso (nombre del proyecto): HelloWorld

c. En el diálogo Asistente de nuevos proyectos defina las propiedades maven delproyecto. Presione Intro después de realizar cada entrada:

Id del grupo: org.bpms

Id del arterfacto: HelloWorld

Id de la versión: 1.0

d. Haga clic en Terminar.

CAPÍTULO 4. PROYECTO HELLO WORLD

21

Page 26: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

CAPÍTULO 5. 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.

5.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 (Autoría → Autoría de proyectos).

2. En la vista del explorador de proyectos a la izquierda, seleccione la unidad organizacional helloworld, el repositorio helloworldrepo y el proyecto HelloWorld.

3. En el menú de perspectivas haga clic en Nuevo ítem → Proceso empresarial y defina losdetalles de la definición de procesos:

Ingrese el nombre del proceso empresarial como HelloWorld.

Seleccione el paquete org.bpms. Este define la ubicación en el repositorio Artifact, endonde creará su definición de proceso empresarial.

NOTA

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

4. Haga clic en Aceptar.

Se abre el diseñador de procesos con la vista de la definición del proceso creado.

5.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 Procesos empresariales 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 Biblioteca de objetos 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 deprocesos empresariales.

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.

4. Cree un evento temporizador: de la paleta arrastre y deje caer el Temporizador (bajo Atrapar eventos intermedios) y conecte la tarea al elemento temporizador usando elmenú de enlace rápido.

Guía de inicio

22

Page 27: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

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 5.1. Borrador del proceso HelloWorld

5.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 Propiedades.

2. Haga clic en cualquier parte. La pestaña Propiedades 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 el tiempo que esperará para la ejecución:

Modifique Duración: 1m y presione Intro.

Por lo tanto el proceso esperará 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ú Guardar ( ) y haga clic en Guardar.

CAPÍTULO 5. PROCESO HELLO WORLD

23

Page 28: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

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 RedHat JBoss BPM Suite User Guide.

5.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 Autoría → Autoría de proyectos.

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 enHerramientas → Editor de proyectos.

4. Verifique que los detalles del proyecto estén correctos en la Pantalla del proyecto y hagaclic en el botón Implementar y construir en la esquina superior derecha de la vista de lapantalla del proyecto.

Figura 5.2. Editor de proyectos con las 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.

5.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 Administración de procesos → Definiciones de procesos en el menú principal.

Guía de inicio

24

Page 29: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

2. En la pestaña Definiciones de procesos que se presenta ubique el proceso Hello World. Es posible que tenga que hacer clic en el botón Actualizar para que laimplementación se pueda ver en la lista.

3. Haga clic en el botón Iniciar( ) al lado de la entrada de la definición del proceso y en lacasilla Formulario haga clic en el botón Iniciar para confirmar que quiere instanciar elproceso.

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

Se presenta la vista Detalles de la instancia del proceso con los detalles sobre la instanciadel proceso iniciado. Aparece el mensaje Hello World! en la salida estándar, usualmente elemulador terminal en el que se inició el servidor. Luego la instancia del proceso espera por el eventotemporizador. Haga clic en Opciones - Modelo de procesos para ver el estado actual deejecución.

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

5.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.

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: la

CAPÍTULO 5. PROCESO HELLO WORLD

25

Page 30: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

instancia desaparecerá de la lista de instancias de procesos activos y aparecerá en la lista de instanciasAborted.

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

Guía de inicio

26

Page 31: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

CAPÍTULO 6. REGLAS EMPRESARIALES HELLO WORLDYa que Red Hat JBoss BPM Suite viene con Red Hat JBoss BRMS integrado, este capítulo proporcionauna introducción a la manera en que funcionan las reglas empresariales y cómo se integran en JBossBPM Suite.

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

6.1. CREACIÓN DE LA REGLA EMPRESARIAL

Las reglas empresariales se definen como declaraciones when-then (cuando-entonces): cuando algo esverdadero entonces algo pasa (por ejemplo, cuando la persona es mayor de 18 años entonces puedenacceder el contenido 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 Explorador de proyectos seleccione la unidad organizacional helloworld, elrepositorio 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 Nuevo ítem → ARrchivo DRL.

b. En la casilla Crear nuevo 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 when- cuando, es decir que siempre será verdaderacuando se dispare (llamada a ejecutar) y se imprimirá la frase Hello World!.

4. Haga clic en Guardar.

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

CAPÍTULO 6. REGLAS EMPRESARIALES HELLO WORLD

27

Page 32: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

5. Se presenta un campo Guardar este ítem. Ingrese el Comentario de registro y hagaclic en guardar.

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.

6.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 el Explorador de proyectosseleccione el proyecto HelloWorld, el paquete org.jbpm, haga clic en BUSINESS PROCESSESy haga clic en el proceso HelloWorld.

NOTA

Asegúrese de seleccionar el paquete org.bpms. 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 Biblioteca de objetos 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ú Tareas y arrastre y deje caer la tarea de reglas empresariales en el canvas ala derecha.

Ajuste las conexiones 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 Propiedades:

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

28

Page 33: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

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

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

6.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 Autoría → Autoría de proyectos.

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 enHerramientas → Editor de proyectos.

4. Verifique que los detalles del proyecto estén correctos en la Pantalla del proyecto y hagaclic en el botón Construir e impletar en la esquina superior derecha de la vista de lapantalla del proyecto.

Figura 6.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 6. REGLAS EMPRESARIALES HELLO WORLD

29

Page 34: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

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

6.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 Administración de procesos → Definiciones de procesos en el menú principal.

2. En la pestaña Definiciones de procesos que se presenta ubique el Hello World. Esposible que tenga que hacer clic en Actualizar para que la implementación se pueda ver enla lista.

3. Haga clic en el botón Iniciar( ) al lado de la entrada de la definición del proceso y en la

casilla Formulario haga clic en el botón play ( ) para confirmar que quiere instanciar elproceso.

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

Se presenta la vista Detalles de la instancia del proceso con los detalles sobre la instanciadel proceso iniciado. Aparece el mensaje Hello World! en la salida estándar, usualmente elemulador terminal en el que se inició el servidor. Luego la instancia del proceso espera por el eventotemporizador. Haga clic en Vistas - Modelo de procesos para ver el estado actual de ejecución.

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

Guía de inicio

30

Page 35: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

CAPÍTULO 7. BAM

7.1. ACCESO A RED HAT JBOSS BPM SUITE DASHBUILDER

Dashbuilder es la interfaz de usuario basada en la wed de Red Hat JBoss BPM Suite para monitorearactividades empresariales. Para acceder el constructor de páneles (Dashbuilder) desde la centralempresarial (Business Central) vaya a Paneles → Paneles de procesos & tareas.

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 Paneles → Paneles empresariales.

7.2. MONITORIZACIÓN DE INSTANCIAS

Dashbuilder- el constructor de páneles- proporciona un pánel especial que le permite monitorear elestado de los datos en tiempo de ejecución (instancias de procesos y tareas) en su máquina deejecución.

Para ver estos datos vaya a Paneles → Panel de tareas & procesos.

Figura 7.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.

CAPÍTULO 7. BAM

31

Page 36: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

CAPÍTULO 8. RED HAT JBOSS DEVELOPER STUDIORed Hat JBoss Developer Studio es JBoss Integrated Development Environment (IDE) basado enEclipse. Obtenga la versión más reciente de JBoss Developer Studio en el portal de soporte al cliente deRed Hat en https://access.redhat.com. JBoss Developer Studio proporciona complementos conherramientas e interfaces para Red Hat JBoss BRMS y Red Hat JBoss BPM Suite. Estos complementosse basan en la versión de la comunidad de estos productos. Por lo tanto, JBoss BRMS plug-in seconoce como el Drools plug-in y JBoss BPM Suite plug-in se conoce como jBPM plug-in.

Consulte la documentación de Red Hat JBoss Developer Studio para obtener instrucciones deinstalación y configuración.

AVISO

Debido a un problema en la forma como se manejan los nombres de reglasmultibytes, debe verificar si la instancia de JBoss Developer Studio se inicia con elset de codificación del archivo para UTF-8. Para ello, modifique el archivo $JBDS_HOME/studio/jbdevstudio.ini y agregue la siguiente propiedad: "-Dfile.encoding=UTF-8"

8.1. CENTRAL DE JBOSS

Cuando se inicia por primera vez JBoss Developer Studio 8.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 Iniciar desde cero. Los proyectos de ejemplo sepueden iniciar seleccionando los enlaces bajo Inciar desde un ejemplo.

NOTA

Debido a problemas en GWT3, JBDS se debe configurar para que no lo utilice. Puedelograr esto configurando la propiedad del sistema como 0:

# No use GTK 3 export SWT_GTK3=0

Guía de inicio

32

Page 37: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

Figura 8.1. Central de JBoss

8.2. INSTALACIÓN DE JBOSS DEVELOPER STUDIO PLUG-INS

Los plug-ins Drools para JBoss Developer Studio están disponibles a través del sitio de actualización.

Procedimiento 8.1. Instale el plug-in Drools JBoss Developer Studio

1. Inicie JBoss Developer Studio.

2. Seleccione Ayuda → Instalar nuevo software.

3. Haga clic en Agregar para ingresar el menú Agregar repositorio..

4. Nombre el sitio de software en el campo Nombre y agregue el URL en el campo Ubicación:https://devstudio.jboss.com/updates/8.0/integration-stack/

5. Haga clic en Aceptar.

6. Seleccione la funcionalidad JBoss Business Process and Rule Development de lasopciones disponibles, haga clic en Siguiente y luego Siguiente otra vez.

7. Lea la licencia y acéptela seleccionando el botón de radio apropiado, luego haga clic en Terminar.

CAPÍTULO 8. RED HAT JBOSS DEVELOPER STUDIO

33

Page 38: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

8. Después de completar la instalación de los complementos, reinicie JBoss Developer Studio.

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

Con el fin de utilizar el complemento Red Hat JBoss BRMS con Red Hat JBoss Developer Studio esnecesario establecer 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 necesarias para la creación y ejecución de sus activosempresariales.

Procedimiento 8.2. Configuración del tiempo de ejecución JBoss BRMS

1. Extraiga los archivos JAR localizados en el archivo jboss-brms-VERSION-engine.zip queusted puede descargar del Portal del cliente de Red Hat.

2. Desde el menú JBoss Developer Studiot seleccione Ventana y haga clic en Preferencias.

3. Seleccione Drools → Tiempos de ejecución Drools instalados.

4. Haga clic en Agregar...; proporcione un nombre para el nuevo tiempo de ejecución y hagaclic en Navegar para navegar al directorio en donde se encuentran los archivos de tiempo deejecución en el paso 1. Haga clic en Aceptar para registrar el tiempo de ejecución seleccionadoen JBDS.

5. Indique el tiempo de ejecución que usted ha creado como el tiempo de ejecución Droolspredeterminado haciendo clic en la casilla adyacente.

6. Haga clic en Aceptar. Si tiene proyectos existentes, una ventana de diálogo le indicará quedebe reiniciar JBoss Developer Studio para actualizar el tiempo de ejecución.

8.4. CONFIGURACIÓN DEL TIEMPO DE EJECUCIÓN DE JBOSS BPMSUITE

Con el fin de utilizar el plugin JBoss BPM Suite 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.

Si descargó previamente el archivador zip implementable genérico de JBoss BPM Suite 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 8.3. Configuración del tiempo de ejecución jBPM

1. Desde el menú JBoss Developer Studiot seleccione Ventana y haga clic en Preferencias.

2. Seleccione jBPM → Tiempos de ejecución jBPM instalados.

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

Guía de inicio

34

Page 39: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

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

8.5. CONFIGURACIÓN DEL SERVIDOR JBOSS.

JBoss Developer Studio puede ser configurado para ejecutar el servidor Red Hat JBoss .

Procedimiento 8.4. Configuración del servidor

1. Abra la vista seleccionando Ventana → Abrir perspectiva → Otra, seleccione y haga clic en Aceptar.

2. Agregue la vista del servidor seleccionando Ventana → Mostrar perspectiva → Otra... yseleccione Servidor → Servidores.

3. Abra el menú del servidor haciendo clic con el botón derecho del ratón en el panel deservidores y seleccione Nuevo → Servidor.

4. Defina el servidor seleccionando JBoss Enterprise Middleware → JBoss EnterpriseApplication Platform 6.4 y haga clic en Siguiente.

5. Establezca el directorio de inicio haciendo clic en el botón Navegar. Navegue hasta eldirectorio de instalación y selecciónelo para JBoss EAP 6.4, el cual tiene instalado .

6. Proporcione un nombre para el servidor en el campo Nombre, asegúrese de que el archivo deconfiguración esté definido y haga clic en Terminar.

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

Usted puede configurar JBoss Developer Studio para conectarse a un repositorio de activos Git central.El repositorio almacena reglas, modelos, funciones y procesos.

Puede clonar un repositorio Git remoto o importar un repositorio local Git.

Procedimiento 8.5. Clonación de un repositorio Git remoto

1. Inicie el servidor Red Hat JBoss BRMS/BPM Suite (el que pueda aplicarse) al seleccionar elservidor desde la pestaña del servidor y haga clic en el icono 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 solamente. En estasplataformas, si sshd ya se inició entonces este comando fallará. En este caso, puede ignorareste paso.

3. En JBoss Developer Studio, seleccione Archivo → Importar... y navegue a la carpeta Git. Abrala carpeta Git para seleccionar Proyectos desde Git y haga clic en Siguiente.

4. Seleccione la fuente del repositorio Clonar URI y haga clic en Siguiente.

/sbin/service sshd start

CAPÍTULO 8. RED HAT JBOSS DEVELOPER STUDIO

35

Page 40: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

5. Ingrese la información sobre el repositorio Git en la siguiente ventana y haga clic en Siguiente.

Figura 8.2. Información sobre el repositorio Git

6. Seleccione la rama que quiere importar en la siguiente ventana y haga clic en Siguiente.

7. Para definir el almacenamiento local para este proyecto. Ingrese (o seleccione) un directorioque 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. Dele un nombre al proyecto y haga clic en Terminar.

Procedimiento 8.6. Importación de un repositorio local Git

1. Inicie el servidor Red Hat JBoss BRMS/BPM Suite (el que pueda aplicarse) al seleccionar elservidor desde la pestaña del servidor y haga clic en el icono de inicio.

Guía de inicio

36

Page 41: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

2. En JBoss Developer Studio, seleccione Archivo → Importar... y navegue a la carpeta Git. Abrala carpeta Git para seleccionar Proyectos desde Git y haga clic en Siguiente.

3. Seleccione la fuente del repositorio Repositorio local existente y haga clic en Siguiente.

Figura 8.3. Información sobre el repositorio Git

4. Seleccione el repositorio que va a configurar de la lista de repositorios disponibles y haga clicen Siguiente.

5. En el diálogo que se abre, seleccione el botón de radio Importar como proyecto generaldesde el Asistente para grupo de importación de proyectos y haga clic en Siguiente.Nombre el proyecto y haga clic en Terminar.

CAPÍTULO 8. RED HAT JBOSS DEVELOPER STUDIO

37

Page 42: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

Figura 8.4. Asistente para importación de proyectos

8.7. CREACIÓN DE UN PROYECTO DROOLS

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

1. Del menú principal seleccione Archivo → Nuevo → Proyecto.

Seleccione Drools → Drools Project y haga clic en Next.

2. Ingrese un nombre para el proyecto en la casilla Nombre del proyecto: y haga clic en Siguiente.

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 Siguiente para probar el proyecto de ejemplo en los siguientes pasos.

Guía de inicio

38

Page 43: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

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 Versión 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 Ejecutar → ejecutar como → Aplicación Java.

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

8.8. CREACIÓN DE UN PROYECTO JBOSS BPM SUITE

Procedimiento 8.8. Creación de un nuevo proyecto JBoss BPM Suite enRed HatJBoss Developer Studio

1. Del menú principal seleccione Archivo → Nuevo → Proyecto.

Seleccione jBPM → jBPM Project y haga clic en Next.

2. Ingrese un nombre para el proyecto en la casilla Nombre del proyecto: y haga clic en Siguiente.

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 Siguiente 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 Terminar.

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 Ejecutar → ejecutar como → Aplicación Java.

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

CAPÍTULO 8. RED HAT JBOSS DEVELOPER STUDIO

39

Page 44: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

CAPÍTULO 9. PLANIFICADOR DE RECURSOSEMPRESARIALESEl planificador de recursos empresariales es una máquina liviana integrable que optimiza los problemasde planificación. Ayuda a los programadores de Java TM normales a resolver problemas de planificacióny combina heurística de optimización y metaheurística con cálculos de puntajes muy eficientes.

El planificador ayuda a resolver varios casos de uso como los siguientes:

Empleado/listas de pacientes. El planificador ayuda a crear horarios para enfermeros y haceel seguimiento de la administración de camas hospitalarias.

Horarios para educación. El planificador ayuda a programar lecciones, cursos, exámenes ypresentaciones de conferencias.

Secuenciación: El planificador hace el seguimiento a líneas de ensamblaje de carros,planificación de colas de máquinas y planificación de tareas del personal.

Problema de corte: El planificador minimiza el desperdicio al reducir el consumo de recursostales como el papel y acero.

9.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 Descargas → Descargas de productos.

3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite.

4. Del menú desplegable Versión seleccione la versión 6.2.

5. Seleccione Red Hat JBoss BPM Suite 6.2 Business Resource Planner y luegohaga clic en Descargar.

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

1. En la línea de comandos, desplácese al directorio examples/

2. En un entorno Unix, ejecute el siguiente comando:

./runExamples.sh

En un entorno de Windows, ejecute el siguiente comando:

./runExamples.bat

3. Elija un ejemplo de los ejemplos de la aplicación GUI que se abre y ejecútelo en su IDEpreferido.

Guía de inicio

40

Page 45: Red Hat JBoss BPM Suite 6 · 2017-11-22 · 3. En la página Descargas de productos que se abre, haga clic en Red Hat JBoss BPM Suite. 4. Del menú desplegable Versión seleccione

APÉNDICE A. HISTORIA DE REVISIONES

Revisión 6.2.0-3.1 Thu Dec 10 2015 Red Hat Localization ServicesLos archivos de traducción sincronizados con fuentes XML 6.2.0-3

Revisión 6.2.0-3 Mon Nov 30 2015 Tomas RadejSe agregó una nota sobre las versiones en el historial de revisiones, se modificaron las fechas del changelog.

Revisión 6.2.0-2 Mon Nov 30 2015 Tomas RadejSe corrigieron los nombres de los productos y errores de ortografía menores.

Revisión 6.2.0-1 Mon Nov 30 2015 Tomas RadejConstrucción inicial para el lanzamiento 6.2.0 de JBoss BPM Suite.

APÉNDICE A. HISTORIA DE REVISIONES

41