Red Hat Summit Red Hat SummitApoyoConsolaDesarrolladoresIniciar una pruebaContacto

Guía de inicio

Red Hat JBoss BPM Suite 6.2

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

Kanchan Desai

Doug Hoffman

Eva Kopalova

Red Hat Content Services

Resumen

Esta guía ayuda a los usuarios a instalar y configurar Red Hat JBoss BPM Suite por primera vez.

Capítulo 1. Inicio rápido con Red Hat JBoss BPM Suite
Copiar enlace

En esta sección descargamos, instalamos y ejecutamos Red Hat JBoss BPM Suite con el número mínimo de instrucciones. Para obtener pasos detallados y métodos opcionales de instalación, sáltese esta sección y continúe leyendo el resto de esta guía.
Estas instrucciones asumen que tiene instalada en su sistema la versión de Java soportada como mínimo. Se requiere un servidor Red Hat JBoss EAP (versión 6.4 o posteriores) ya existente ya que el instalador 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 acceder a 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 de inicio 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 de nombre de usuario/contraseña para acceder a la aplicación JBoss BPM Suite que creó en el momento de la instalación.
Usted ha instalado correctamente y ejecutado Red Hat JBoss BPM Suite . Ahora puede hacer lo siguiente:
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 2. Opciones de instalación
Copiar enlace

Red 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 del proyecto.

Nota

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

Importante

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

2.1. La instalación agrupada EAP6
Copiar enlace

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

Nota

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

2.1.1. Descarga del paquete Red Hat JBoss EAP6
Copiar enlace

Para descargar el paquete implementable de Red Hat JBoss BPM Suite para JBoss Enterprise Application 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
Copiar enlace

Instalación en una nueva instancia JBoss EAP
Para instalar el paquete implementable para un JBoss EAP que todavía no se ha configurado, haga lo siguiente:
  1. Extraiga el paquete zip implementable para JBoss EAP que descargó del Portal del cliente de Red Hat.
  2. Agrupe el paquete zip extraído para JBoss EAP en el directorio SERVER_HOME de JBoss EAP.

    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 del superusuario.
  3. En este proceso, se sobreescribirán múltiples archivos en el directorio JBoss EAP SERVER_HOME y usted debe permitir que el proceso de descompresión sobreescriba estos archivos. Un ejemplo de un archivo que se sobreescribe es el archivo SERVER_HOME/bin/product.conf. Después de una agrupación exitosa, este archivo debe contener la cadena slot=bpms. Puede abrir este archivo para verificar que los archivos se hayan sobreescrito de manera exitosa.
En Red Hat Enterprise Linux puede utilizar el siguiente comando para extraer el archivo zip Red Hat JBoss BPM Suite y unirlo con su directorio de servidor correctamente en un paso, si ejecuta este comando en el directorio en donde descargó el archivo zip: 
unzip -u jboss-bpms-VERSION-TYPE.zip -d SERVER_HOME_PARENT_DIR
Copy to Clipboard Toggle word wrap

Ejemplo 2.1. El comando para descomprimir

unzip -u jboss-bpms-6.2-redhat-7-deployable-eap6.x.zip -d /home/john/myServers/
Copy to Clipboard Toggle word wrap
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 de JBoss BPM Suite. Asegúrese de que no haya ninguna instalación JBoss BPM en JBoss EAP de destino.
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 de Red Hat.
  2. Descomprima el archivador comprimido descargado; sin embargo, no sobreescriba todos los archivos. Agrupe manualmente los siguientes archivos en el directorio SERVER_HOME.
    • jboss-eap-6.4/domain/configuration/* - (por favor tenga en cuenta que JBoss BMP 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 que JBoss BMP Suite requiere JMS así que JMS se agrega por defecto en todos los archivos de configuració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 que cree conflictos. Copie la carpeta jboss-eap-6.4/standalone/deployments en el directorio 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 JBoss BPM Suite y copie la carpeta jboss-eap-6.4/modules/system/layers/bpms en la carpeta EAP 6.4.

2.1.3. Definición de roles
Copiar enlace

Antes de iniciar el servidor e iniciar sesión en la Central empresarial necesitará crear algunas cuentas de usuarios. Esta sección describe los diferentes roles de usuario que se utilizan en Red Hat JBoss BPM Suite :
  • admin: los usuarios con el rol admin son los administradores de la aplicación. Los administradores pueden administrar los usuarios, administrar los repositorios (crear y clonar) y tienen acceso completo para realizar los cambios requeridos en la aplicación. Los admin tienen acceso a todas las áreas dentro del sistema.
  • desarrollador: un desarrollador tiene acceso a casi todas las funcionalidades y puede administrar reglas, modelos, flujos de procesos, formas y paneles. Puede administrar el repositorio de activos, crear, construir e implementar proyectos e incluso puede usar Red Hat JBoss Developer Studio para ver procesos. Solamente se ocultan ciertas funciones administrativas como la creación y clonación de un nuevo repositorio para el rol del desarrollador.
  • analyst: un rol de analista tiene acceso a todas las funcionalidades de alto nivel para modelar y ejecutar sus proyectos. Sin embargo, el acceso Autoría → Administración no está disponible para los usuarios con el rol de analista. Ciertas funcionalidades de menor nivel orientadas a los desarrolladores como la vista Implementación → Repositorio de artefactos no son accesibles para este rol. Sin embargo, el botón Construir e implementar está disponible para el rol de analista cuando utiliza el editor de proyectos.
  • usuario: un usuario o un usuario empresarial trabaja en las listas de tareas empresariales que se utilizan para operar cierto proceso. Un usuario con este rol puede acceder el panel y administrar procesos.
  • mánager: un mánager es un observador del sistema que está interesado en las estadísticas relacionadas con los procesos empresariales y su rendimiento, indicadores empresariales y otros 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.5 User Task.

2.1.4. Creación de usuarios
Copiar enlace

Para comenzar a agregar nuevos usuarios, deberá ejecutar el script add-user.sh en un sistema Unix o el archivo add-user.bat en un sistema Windows desde el directorio bin EAP.
  1. Ejecute ./add-user.sh en un sistema Unix o add-user.bat en un sistema Windows desde el directorio bin.
  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 grupos conocidos. Por ejemplo, si existe un grupo llamado admin, no debe crear un usuario 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. Por ejemplo: Helloworld@123.

    Nota

    La contraseña debe tener por lo menos 8 caracteres y debe tener caracteres en mayúsculas y minúsculas (por ejemplo, A-Z, a-z), por lo menos un caracter numérico (por ejemplo,. 0-9) y 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 se requiere).

2.2. La instalación agrupada genérica implementable
Copiar enlace

Para instalar Red Hat JBoss BPM Suite en el Red Hat JBoss Web Server (EWS), necesita utilizar el paquete implementable genérico del producto.
Para la instalación en EWS, el paquete implementable genérico contiene bibliotecas de seguridad y administradores 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 incorporar el motor en su aplicación y otras bibliotecas necesarias para implementación genérica.

2.2.1. Descarga del paquete genérico implementable
Copiar enlace

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 luego haga clic en Descargar.
  6. También navegue a la fila de archivos Red Hat JBoss BPM Suite 6.2 Engine y haga clic en Descargar para descargar los archivos JBoss BPM Suite Engine.

2.2.2. Instalación del paquete implementable genérico
Copiar enlace

Para instalar el paquete implementable genérico, necesita configurar lo siguiente después de haber instalado la plataforma subyacente (Red Hat JBoss WS):
  1. Extraiga el paquete zip genérico implementable que descargó del Portal del cliente de Red Hat a una ubicación temporal. Este paquete zip contiene los siguientes tres archivos de aplicaciones web: business-central.war, dashbuilder.war y kie-server.war en un formato expandido. 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 su servidor de red. Remplácelo con la ruta a su directorio de inicio del servidor de red, 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ón temporal desde donde pueda copiar las bibliotecas requeridas. Esta carpeta ahora contiene todas 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 un gestor de transacciones, Bitronix que no recibe oficialmente soporte de Red Hat.
    Copie las siguientes bibliotecas jar del administrador de transacciones de la carpeta lib al directorio $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:
  5. Instale el controlador en su base de datos
    Copie el archivo jar con el controlador de base de datos relevante para $TOMCAT_DIR/lib/.

    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 
      bitronix.tm.serverId=tomcat-btm-node0
bitronix.tm.journal.disk.logPart1Filename=${btm.root}/work/btm1.tlog
bitronix.tm.journal.disk.logPart2Filename=${btm.root}/work/btm2.tlog
bitronix.tm.resource.configuration=${btm.root}/conf/resources.properties
      Copy to Clipboard Toggle word wrap
    • resources.properties (el resource.ds1.uniqueName define el nombre de la fuente de datos utilizado después en la definición de recursos tomcat - tome nota de este valor).
      Asegúrese de cambiar los valores en las siguientes definiciones para que coincidan con su entorno.

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

      resource.ds1.className=bitronix.tm.resource.jdbc.lrc.LrcXADataSource
resource.ds1.uniqueName=jdbc/jbpm
resource.ds1.minPoolSize=10
resource.ds1.maxPoolSize=20
resource.ds1.driverProperties.driverClassName=org.h2.Driver
resource.ds1.driverProperties.url=jdbc:h2:file:~/jbpm
resource.ds1.driverProperties.user=sa
resource.ds1.driverProperties.password=
resource.ds1.allowLocalTransactions=true
      Copy to Clipboard Toggle word wrap

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

      resource.ds1.className=com.mysql.jdbc.jdbc2.optional.MysqlXADataSource
resource.ds1.uniqueName=jdbc/jbpm
resource.ds1.minPoolSize=0
resource.ds1.maxPoolSize=10
resource.ds1.driverProperties.URL=jdbc:mysql://localhost:3306/sampledb
resource.ds1.driverProperties.user=dbuser
resource.ds1.driverProperties.password=dbpassword
resource.ds1.allowLocalTransactions=true
      Copy to Clipboard Toggle word wrap

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

      resource.ds1.className=com.ibm.db2.jcc.DB2Driver
resource.ds1.uniqueName=jdbc/jbpm
resource.ds1.minPoolSize=0
resource.ds1.maxPoolSize=10
resource.ds1.driverProperties.URL=jdbc:db2://localhost:50000/sampledb
resource.ds1.driverProperties.user=dbuser
resource.ds1.driverProperties.password=dbpassword
resource.ds1.allowLocalTransactions=true
      Copy to Clipboard Toggle word wrap

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

      resource.ds1.className=oracle.jdbc.xa.client.OracleXADataSource
resource.ds1.uniqueName=jdbc/jbpm
resource.ds1.minPoolSize=0
resource.ds1.maxPoolSize=10
resource.ds1.driverProperties.URL=jdbc:oracle:thin:@//localhost:1521/bpms
resource.ds1.driverProperties.user=dbuser
resource.ds1.driverProperties.password=dbpassword
resource.ds1.allowLocalTransactions=true
      Copy to Clipboard Toggle word wrap

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

      resource.ds1.className=com.microsoft.sqlserver.jdbc.SQLServerDriver
resource.ds1.uniqueName=jdbc/jbpm
resource.ds1.minPoolSize=0
resource.ds1.maxPoolSize=10
resource.ds1.driverProperties.URL=jdbc:sqlserver://localhost:1433;databaseName=bpms;
resource.ds1.driverProperties.user=dbuser
resource.ds1.driverProperties.password=dbpassword
resource.ds1.allowLocalTransactions=true
      Copy to Clipboard Toggle word wrap
  7. Configure el escucha del gestor de transacciones en $TOMCAT_DIR/conf/server.xml para iniciar y detener Bitronix en el arranque y detención del contenedor:
    Agregue el siguiente elemento como el último elemento <Listener> en el elemento <Server>: 
    <Listener className="bitronix.tm.integration.tomcat55.BTMLifecycleListener" />
    Copy to Clipboard Toggle word wrap
  8. Defina la propiedad del sistema btm.root y la ubicación en donde se ubica el archivo de configuración bitronix:
    En $TOMCAT_DIR/bin/, cree el archivo setenv.sh con el siguiente contenido: 
    CATALINA_OPTS="-Xmx512M -XX:MaxPermSize=512m -Djava.security.auth.login.config=$CATALINA_HOME/webapps/business-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"
    Copy to Clipboard Toggle word wrap
    La propiedad org.jbpm.designer.perspective se establece como RuleFlow para que la perspectiva para el diseñador sea RuleFlow en lugar de Full. Otórguele al archivo permisos de ejecución si aplica.
    La propiedad java.security.auth.login.config debe establecerse para que funcione el clon ssh del repositorio git.

    Importante

    En sistemas Microsoft Windows remplace el valor $CATALINA_HOME en el contenido del archivo con el nombre de la variable de entorno equivalente o use la ruta absoluta y agregue los valores en el archivo setenv.bat, tal como se muestra en el siguiente ejemplo: 
    set "CATALINA_OPTS=-Xmx512M -XX:MaxPermSize=512m -Dbtm.root=C:/Tomcat -Dbitronix.tm.configuration=C:/Tomcat/conf/btm-config.properties -Dorg.jbpm.designer.perspective=RuleFlow"
    Copy to Clipboard Toggle word wrap
Para establecer la central empresarial haga lo siguiente:
  1. Configure Valve para que la aplicación web de la Central empresarial pueda cargar los usuarios configurados en Tomcat:
    1. Defina los usuarios y roles en $TOMCAT_DIR/conf/tomcat-users.xml. Note que la central empresarial requiere que los usuarios tengan los roles especificados como admin y/o analyst (para más información sobre definiciones de roles y usuarios consulte la documentación de Tomcat 7).
      El programa listado a continuación muestra un ejemplo de cómo se agregarían estos dos roles 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 los roles conocidos. Por ejemplo, no debe crear un usuario con el nombre de usuario admin. 
        <role rolename="admin"/>
  <role rolename="analyst" />
  <user username="bpmsadmin" password="P@ssw0rd" roles="admin,analyst"/>
      Copy to Clipboard Toggle word wrap
    2. Desplace (no copie) kie-tomcat-integration-VERSION.jar de $TOMCAT_DIR/webapps/business-central/WEB-INF/lib/ a $TOMCAT_DIR/lib/.
    3. Copie jboss-jaxb-api-VERSION.jar de $TOMCAT_DIR/webapps/business-central/WEB-INF/lib/ a $TOMCAT_DIR/lib/.
    4. En $TOMCAT_DIR/conf/server.xml agregue la declaración de válvula Tomcat en el elemento relevante <host>: 
      <Valve className="org.kie.integration.tomcat.JACCValve" />
      Copy to Clipboard Toggle word wrap
  2. Si está usando una fuente de datos diferente de la predeterminada proporcionada por la base de datos H2 subyacente necesitará configurar la persistencia. Si está utilizando la base de datos H2 predeterminada entonces puede ignorar el resto de pasos en este procedimiento.
    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).
    1. En business-central/META-INF/context.xml reemplace el nombre JNDI de la fuente de datos en el elemento <Resource>. El atributo uniqueName se refiere a la propiedad resource.ds1.uniqueName establecida en resources.properties: 
      <Resource name="jdbc/myDatasource" uniqueName="jdbc/jbpm" auth="Container" removeAbandoned="true" factory="bitronix.tm.resource.ResourceObjectFactory" type="javax.sql.DataSource"/>
      Copy to Clipboard Toggle word wrap
    2. En business-central/WEB-INF/web.xml remplace el nombre JNDI de la fuente de datos en el elemento <res-ref-name> con su nombre de fuente de datos: 
      <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>
      Copy to Clipboard Toggle word wrap
    3. 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 si está utilizando una base de datos diferente de H2. El código a continuación demuestra la información de la base de datos original para persistence.xml: 
      <property name="hibernate.dialect" value="org.hibernate.dialect.H2Dialect"/>
      Copy to Clipboard Toggle word wrap
      Esta información se puede actualizar de la siguiente manera (tal como se demuestra con la base de datos MySQL a continuación): 
      <property name="hibernate.dialect" value="org.hibernate.dialect.MySQLDialect"/>
      Copy to Clipboard Toggle word wrap

      Nota

      El dialecto para DB2 es org.hibernate.dialect.DB2Dialect, para DB2 en AS/400 es org.hibernate.dialect.DB2400Dialect, para Oracle es org.hibernate.dialect.Oracle10gDialect y para el servidor Microsoft SQL es org.hibernate.dialect.SQLServerDialect
    4. Cambie el archivo business-central/WEB-INF/classes/META-INF/persistence.xml de manera que la máquina de procesos JBoss BPM Suite pueda usar la nueva base de datos.
      El código a continuación demuestra la información de la fuente de datos original para persistence.xml: 
      <jta-data-source>java:comp/env/jdbc/jbpm</jta-data-source>
      Copy to Clipboard Toggle word wrap
      Cambie este valor a la fuente de datos definida anteriormente: 
      <jta-data-source>java:comp/env/jdbc/myDatasource</jta-data-source>
      Copy to Clipboard Toggle word wrap
  3. Ahora puede iniciar JBoss Web Server para iniciar sesión en la central empresarial.
    1. Ejecute startup.sh en el directorio $TOMCAT_HOME/bin. 
      ./startup.sh
      Copy to Clipboard Toggle word wrap
    2. Vaya a http://localhost:8080/business-central en un navegador web.
    3. Inicie sesión con el nombre de usuario/contraseña definidos en el archivo tomcat-users.xml.

Nota

Antes de configurar Dashbuilder en Red Hat JBoss Web Server, debe asegurarse de tener instalada correctamente la Central Empresarial como se describe en Sección 2.2.2.2, “Configuración de una central empresarial para Red Hat JBoss Web Server 2.1 (Tomcat 7)”. Dashbuilder necesita las tablas de base de datos del registro de historia para existir, las cuales son provistas únicamente por la Central empresarial. Si estas 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 que Dashbuilder requiere 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. Habilite el inicio de sesión único entre Dashbuilder y la Central empresarial borrando el comentario de las siguientes líneas en el archivo $TOMCAT_DIR/conf/server.xml: 
    <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
    Copy to Clipboard Toggle word wrap
  3. Como con la configuración de la Central empresarial, si está utilizando una base de datos diferente 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 .
    1. En dashbuilder/META-INF/context.xml reemplace el nombre JNDI de la fuente de datos en el elemento <Resource>. El atributo uniqueName se refiere a la propiedad resource.ds1.uniqueName establecida en resources.properties: 
      <Resource name="jdbc/dashbuilderDS" uniqueName="jdbc/jbpm" auth="Container" removeAbandoned="true" factory="bitronix.tm.resource.ResourceObjectFactory" type="javax.sql.DataSource"/>
      Copy to Clipboard Toggle word wrap

      Nota

      Dependiendo de su base de datos es posible que necesite definir otras propiedades aquí también. Por ejemplo, en un entorno Oracle esta entrada puede verse como el siguiente listado. 
      <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" />
      Copy to Clipboard Toggle word wrap
    2. En dashbuilder/WEB-INF/web.xml agregue el nombre JNDI de la fuente de datos en el elemento <res-ref-name> con su nombre de fuente de datos: 
      <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>
      Copy to Clipboard Toggle word wrap
    3. En dashbuilder/META-INF/context.xml defina la fábrica de transacciones: 
       <Transaction factory="bitronix.tm.BitronixUserTransactionObjectFactory"/>
      Copy to Clipboard Toggle word wrap
    4. Actualice el nombre JNDI de la fuente de datos en dashbuilder/WEB-INF/etc/hibernate.cfg.xml en el elemento <session-factory>: 
      <property name="connection.datasource">java:/comp/env/jdbc/dashbuilderDS</property>
      Copy to Clipboard Toggle word wrap
  4. Reinicie el servidor de red Java para que los cambios tengan efecto. Una vez reiniciado puede navegar al Dashbuilder desde la central empresarial o directamente a través de: http://localhost:8080/dashbuilder.

2.3. Inicio del servidor
Copiar enlace

Si ha instalado Red Hat JBoss BPM Suite mediante la instalación del paquete JBoss EAP 6, ahora puede 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 de red Java de Red Hat, las instrucciones para descargar e instalar también contienen las instrucciones para iniciar el servidor. Puede ignorar la siguiente discusión.
El script de arranque predeterminado,standalone.sh con el que se envía Red Hat JBoss BPM Suite está optimizado para rendimiento. Para ejecutar su servidor en modo de rendimiento, haga lo siguiente:
  1. En la línea de comandos vaya al directorio $SERVER_HOME/bin/.
  2. En un entorno Unix, ejecute: 
    ./standalone.sh
    Copy to Clipboard Toggle word wrap
    En un entorno Windows, ejecute: 
    ./standalone.bat
    Copy to Clipboard Toggle word wrap
Red Hat JBoss BPM Suite también se envía con un script separado, standalone-secure.sh que está optimizado para la seguridad. Este script aplica una política de seguridad predeterminada que protege contra una vulnerabilidad de seguridad conocida.

Nota

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

Aviso

Debe tener en cuenta que el uso de un administrador de seguridad impone una sanción importante en el rendimiento. El compromiso entre la seguridad y el rendimiento se debe realizar teniendo en consideración las circunstancias individuales. Consulte Sección 2.4, “Administrador de seguridad Java y administració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
    Copy to Clipboard Toggle word wrap
    En un entorno Windows, ejecute: 
    ./standalone-secure.bat
    Copy to Clipboard Toggle word wrap

Nota

Si instaló JBoss BPM Suite con el instalador, recibirá la opción para aplicar la política de seguridad 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 correspondientes son domain.sh y domain-secure.sh respectivamente.

2.4. Administrador de seguridad Java y administración de rendimiento
Copiar enlace

Como se observó anteriormente, al habilitar el administrador de seguridad Java (JSM, por sus siglas en inglés) un entorno de prueba completo para la evaluación de scripts MVEL en Red Hat JBoss BPM Suite introduce una penalidad de rendimiento en entornos de alta carga. Se deben tener en cuenta los marcadores de entorno y de rendimiento al implementar una aplicación JBoss BPM Suite. Use las siguientes 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 que hayan sido revisadas apropiadamente. También se recomienda no crear ningún usuario con el rol de analista en dichos sistemas. Si se tienen en cuenta estas medidas entonces es seguro dejar JSM inhabilitado en estos sistemas de manera que no introduzca ninguna degradación de rendimiento.
  • En entornos de prueba y desarrollo sin altas cargas o en entornos en donde la autoría de reglas y procesos está expuesta a redes externas, se recomienda tener JSM habilitado con el fin de lograr beneficios de seguridad de una evaluación completa del entorno de prueba de MVEL.
No es seguro y no se recomienda permitir que usuarios con el rol Analyst inicien sesión en la consola de la central empresarial con JSM inhabilitado.

Capítulo 3. Inicio de sesión en la central empresarial
Copiar enlace

Inicie 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 se ha configurado para ejecutar desde un nombre de dominio, substituya localhost con el nombre del dominio. Por ejemplo, http://www.example.com:8080/business-central.
  2. Inicie sesión con las credenciales de usuario que se crearon durante la instalación. Por ejemplo: Usuario = helloworlduser y contraseña = Helloworld@123.

Capítulo 4. Proyecto Hello World
Copiar enlace

Para 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 que este 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 del proceso empresarial HelloWorld.
  3. Modele la lógica del proceso Hello World en el proceso empresarial usando la herramienta del diseñador de procesos gráfico.
  4. Construya e implemente el proyecto en la máquina de ejecución ejecutando localmente.
  5. Ejecute el proceso Hello World.
  6. Monitoree la ejecución del proceso.

4.1. Creación de una estructura de repositorio
Copiar enlace

Todos los activos empresariales viven en repositorios que viven en unidades organizacionales, los cuales son directorios en el repositorio Artifact. Por defecto, el repositorio Artifact no contiene ninguna unidad organizacional. Por lo tanto, para poder crear sus propios activos empresariales tal como un proceso empresarial, necesita crear una unidad organizacional en el repositorio Artifact y un repositorio (Git) en el. Luego el repositorio puede contener su proyecto. Un proyecto puede contener una estructura de paquete arbitraria, la cual le permite estructurar su contenido en una estrutura lógica de "directorio". Cualquier paquete puede contener sus activos empresariales (para mayor información sobre el repositorio 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 localmente http://localhost:8080/business-central) e inicie sesión como usuario con el rol admin (helloworlduser).
  2. Cree una unidad organizacional en el repositorio Artifact:
    1. Vaya a Autoría → Administración.
    2. En el menú de perspectivas haga clic en Unidades organizacionales → Gestión de unidades organizacionales.
    3. 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 las propiedades de las unidades y haga clic en Aceptar:
      • Nombre: helloworld
      • Propietario: helloworlduser
  3. Cree un nuevo repositorio en la unidad organizacional helloworld:
    1. Vaya a Autoría → Administración.
    2. En el menú de perspectivas haga clic en Repositorios → Nuevo repositorio.
    3. En la ventana que se presenta Crear repositorio defina las propiedades del repositorio:
      • 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.
    Seleccione el repositorio helloworldrepo en el grupo organizacional helloworld en el explorador de proyectos
    View larger image
    Seleccione el repositorio helloworldrepo en el grupo organizacional helloworld en el explorador de proyectos

    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:
    1. En el menú de perspectivas vaya a Nuevo ítem → Proyecto
    2. En la ventana que se presenta Crear nuevo defina las propiedades del proyecto:
      • Nombre del recurso (nombre del proyecto): HelloWorld
    3. En el diálogo Asistente de nuevos proyectos defina las propiedades maven del proyecto. Presione Intro después de realizar cada entrada:
      • Id del grupo: org.bpms
      • Id del arterfacto: HelloWorld
      • Id de la versión: 1.0
    4. Haga clic en Terminar.

Capítulo 5. Proceso Hello World
Copiar enlace

En este capítulo continuaremos con el ejemplo de Hello World y crearemos todo un proceso empresarial para demostrar la creación de un proceso básico Hello World.

5.1. Creación de procesos empresariales
Copiar enlace

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 los detalles 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, en donde creará su definición de proceso empresarial.

      Nota

      Asegúrese de seleccionar el paquete org.bpms. El seleccionar un paquete incorrecto 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
Copiar enlace

Después de haber creado la definición de procesos empresariales, puede diseñar el proceso empresarial en el diseñador de procesos empresariales: el diseñador del proceso empresarial debe estar abierto en una pestaña a la derecha. Si cerró la pestaña, en el explorador de proyectos haga clic en HelloWorld bajo Procesos empresariales para volver a abrir el diseñador de procesos empresariales. Asegúrese de seleccionar el paquete correcto (org.jbpm.helloworld). Para diseñar el contenido del proceso, haga lo siguiente:
  1. Amplie la paleta 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 procesos 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 un elemento 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 el menú de enlace rápido.
  5. Cree el elemento Terminar evento conectado al elemento Evento temporizador (ya sea usando la funcionalidad de enlace rápido o arrastrándolo de la paleta).
Borrador del proceso HelloWorld
View larger image
Borrador del proceso HelloWorld

Figura 5.1. Borrador del proceso HelloWorld

5.3. Definición de propiedades del elemento
Copiar enlace

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 sus valores si es necesario.
  3. El elemento de inicio y el elemento para terminar solo tienen propiedades opcionales. Sin embargo, los elementos tareas necesitan su tipo y propiedades específicas de tipo definidas: haga clic en el elemento tarea y defina las propiedades requeridas:
    • Name: 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 Java y 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 servidor es la consola en la que se inició el servidor).
  4. Todavía necesita definir propiedades del evento temporizador para hacer que el proceso espere en tiempo de ejecución de manera que usted pueda inspeccionar su ejecución: haga clic en el elemento temporizador y defina 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 que ejecuta 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.
  6. Haga click en el botón ( ) en la barra de herramientas del diseñador de procesos con el proceso para asegurarse de que el proceso definido es válido. El esquema de cualquier elemento con uno o múltiples errores de validación se vuelve naranja (consulte la Red Hat JBoss BPMS User Guide para obtener información sobre la funcionalidad de validación).
Para obtener mayor información sobre los elementos de procesos y sus propiedades consulte la Red Hat JBoss BPM Suite User Guide.

5.4. Construcción e implementación
Copiar enlace

Antes de poder instanciar, es decir, ejecutar su proceso Hello World, necesita construir todo el proyecto 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 en Herramientas → Editor de proyectos.
  4. Verifique que los detalles del proyecto estén correctos en la Pantalla del proyecto y haga clic en el botón Implementar y construir en la esquina superior derecha de la vista de la pantalla del proyecto.
    The Build & Deploy button located in the upper left corner of the editor view
    View larger image
    The Build & Deploy button located in the upper left corner of the editor view

    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 se ha construído e implementado en el servidor de ejecuciones y está disponible para instanciación.

5.5. Instanciación de procesos empresariales
Copiar enlace

Para crear una instancia del proceso Hello World, es decir, ejecutar el proceso empresarial, haga lo siguiente:
  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 proceso Hello World. Es posible que tenga que hacer clic en el botón Actualizar para que la implementació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 la casilla Formulario haga clic en el botón Iniciar para confirmar que quiere instanciar el proceso.
    El proceso se instancia con el usuario que actualmente está en sesión como propietario del proceso y se presenta el formulario del proceso (el formulario puede servir para solicitar entrada de un usuario en la instanciación de procesos si está definido; consulte la Red Hat JBoss BPMS User Guide).
Se presenta la vista Detalles de la instancia del proceso con los detalles sobre la instancia del proceso iniciado. Aparece el mensaje Hello World! en la salida estándar, usualmente el emulador terminal en el que se inició el servidor. Luego la instancia del proceso espera por el evento temporizador. Haga clic en Opciones - Modelo de procesos para ver el estado actual de ejecución.
Diagrama de ejecución en tiempo real HelloWorld: el evento temporizador en ejecución
View larger image
Diagrama de ejecución en tiempo real HelloWorld: el evento temporizador en ejecución

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

5.6. Cancelación de procesos empresariales
Copiar enlace

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 a Process 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 instancia desaparecerá de la lista de instancias de procesos activos y aparecerá en la lista de instancias Aborted.
Description
View larger image
Description

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

Capítulo 6. Reglas empresariales Hello World
Copiar enlace

Ya que Red Hat JBoss BPM Suite viene con Red Hat JBoss BRMS integrado, este capítulo proporciona una introducción a la manera en que funcionan las reglas empresariales y cómo se integran en JBoss BPM Suite.
Agregará una nueva tarea, una tarea de regla empresarial al proceso HelloWorld, el cual disparará una regla empresarial de un grupo de reglas empresariales particular.
Note que este es un caso de integración muy simple y en producción puede que necesite un concepto y técnicas más avanzadas tal como tablas de decisiones. Para mayor información sobre las reglas empresariales y BRMS consulte la Red Hat JBoss BRMS User Guide

6.1. Creación de la regla empresarial
Copiar enlace

Las reglas empresariales se definen como declaraciones when-then (cuando-entonces): cuando algo es verdadero entonces algo pasa (por ejemplo, cuando la persona es mayor de 18 años entonces pueden acceder 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, el repositorio helloworldrepo, el proyecto HelloWorld y el paquete default.

    Nota

    Asegúrese de seleccionar el paquete default. El seleccionar un paquete incorrecto causa que la implementación falle.
  2. Crear el archivo DRL:
    1. En el menú de perspectivas haga clic en Nuevo ítem → ARrchivo DRL.
    2. En la casilla Crear nuevo defina el nombre del recurso como helloworldrule y verifique que la ruta destino sea default://master@helloworldrepo/HelloWorld/src/main/resources.
    3. Haga clic en Aceptar.
  3. En el editor DRL que se presenta con el archivo helloworldrule.drl defina la regla: 
    rule "helloworldrule"
ruleflow-group "helloworldgroup"
when 
then
	System.out.println("Hello World!");
end
    Copy to Clipboard Toggle word wrap
    Esta regla no define ninguna condición when- cuando, es decir que siempre será verdadera cuando se dispare (llamada a ejecutar) y se imprimirá la frase Hello World!.
  4. Haga clic en Guardar.
  5. Se presenta un campo Guardar este ítem. Ingrese el Comentario de registro y haga clic en guardar.

    Nota

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

6.2. Agregación de la tarea de reglas empresariales
Copiar enlace

Una tarea de reglas empresariales es una tarea que dispara reglas que pertenecen a cierto grupo de flujo de reglas.
Para agregar una tarea de reglas empresariales a su proceso, haga lo siguiente:
  1. Abra su proceso empresarial en el diseñador de procesos: en el Explorador de proyectos seleccione el proyecto HelloWorld, el paquete org.jbpm, haga clic en BUSINESS PROCESSES y haga clic en el proceso HelloWorld.

    Nota

    Asegúrese de seleccionar el paquete org.bpms. El seleccionar un paquete incorrecto causa que la implementación falle.
  2. En el diseñador de procesos empresariales que se presenta con el proceso helloworld, amplie la paleta 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 procesos empresariales.
  3. Amplie el menú Tareas y arrastre y deje caer la tarea de reglas empresariales en el canvas a la 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 se está ejecutando la tarea. En este ejemplo, solo una regla, la reglahelloworldgroup definida en el archivo helloworldrule.drl, está presente en el grupo helloworldgroup.
    El proceso helloworld con la tarea de reglas empresariales y sus propiedades
    View larger image
    El proceso helloworld con la tarea de reglas empresariales y sus propiedades

    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
Copiar enlace

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 en Herramientas → Editor de proyectos.
  4. Verifique que los detalles del proyecto estén correctos en la Pantalla del proyecto y haga clic en el botón Construir e impletar en la esquina superior derecha de la vista de la pantalla del proyecto.
    The Build & Deploy button located in the upper left corner of the editor view
    View larger image
    The Build & Deploy button located in the upper left corner of the editor view

    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 se construyó e implementó en el servidor de ejecuciones y que está disponible para ser instanciado. Note que la versión anterior de la implementación helloWorld se substituye con la nueva versión con la tarea de la regla empresarial. Para mantener ambas implementaciones, cambie el número de la versión del proyecto en el editor de proyectos.

6.4. Instanciación de procesos empresariales
Copiar enlace

Para crear una instancia del proceso Hello World, es decir, ejecutar el proceso empresarial, haga lo siguiente:
  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. Es posible que tenga que hacer clic en Actualizar para que la implementació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 la casilla Formulario 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 del proceso y se presenta el formulario del proceso (el formulario puede servir para solicitar entrada de un usuario en la instanciación de procesos si está definido; consulte la Red Hat JBoss BPMS User Guide).
Se presenta la vista Detalles de la instancia del proceso con los detalles sobre la instancia del proceso iniciado. Aparece el mensaje Hello World! en la salida estándar, usualmente el emulador terminal en el que se inició el servidor. Luego la instancia del proceso espera por el evento temporizador. Haga clic en Vistas - Modelo de procesos para ver el estado actual de ejecución.
Diagrama de ejecución en tiempo real HelloWorld: el evento temporizador en ejecución
View larger image
Diagrama de ejecución en tiempo real HelloWorld: el evento temporizador en ejecución

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

Capítulo 7. BAM
Copiar enlace

7.1. Acceso a Red Hat JBoss BPM Suite Dashbuilder
Copiar enlace

Dashbuilder es la interfaz de usuario basada en la wed de Red Hat JBoss BPM Suite para monitorear actividades empresariales. Para acceder el constructor de páneles (Dashbuilder) desde la central empresarial (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ón seleccionados a su izquierda. Puede crear su propio pánel en el constructor de páneles que se presenta al hacer clic en Paneles → Paneles empresariales.

7.2. Monitorización de instancias
Copiar enlace

Dashbuilder- el constructor de páneles- proporciona un pánel especial que le permite monitorear el estado de los datos en tiempo de ejecución (instancias de procesos y tareas) en su máquina de ejecución.
Para ver estos datos vaya a Paneles → Panel de tareas & procesos.
Pánel de tareas y procesos
View larger image
Pánel de tareas y 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 tablas y los datos a la derecha se actualizan de acuerdo con esto.

Capítulo 8. Red Hat JBoss Developer Studio
Copiar enlace

Red Hat JBoss Developer Studio es JBoss Integrated Development Environment (IDE) basado en Eclipse. Obtenga la versión más reciente de JBoss Developer Studio en el portal de soporte al cliente de Red Hat en https://access.redhat.com. JBoss Developer Studio proporciona complementos con herramientas e interfaces para Red Hat JBoss BRMS y Red Hat JBoss BPM Suite. Estos complementos se basan en la versión de la comunidad de estos productos. Por lo tanto, JBoss BRMS plug-in se conoce 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 de instalación y configuración.

Aviso

Debido a un problema en la forma como se manejan los nombres de reglas multibytes, debe verificar si la instancia de JBoss Developer Studio se inicia con el set 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
Copiar enlace

Cuando se inicia por primera vez JBoss Developer Studio 8.0, se presenta la central de JBoss en la ventana principal del banco de trabajo. Desde la central de JBoss es posible crear nuevos proyectos seleccionando las opciones del menú bajo Iniciar desde cero. Los proyectos de ejemplo se pueden iniciar seleccionando los enlaces bajo Inciar desde un ejemplo.

Nota

Debido a problemas en GWT3, JBDS se debe configurar para que no lo utilice. Puede lograr esto configurando la propiedad del sistema como 0: 
# No use GTK 3 
export SWT_GTK3=0
Copy to Clipboard Toggle word wrap
Central de JBoss
View larger image
Central de JBoss

Figura 8.1. Central de JBoss

8.2. Instalación de JBoss Developer Studio Plug-ins
Copiar enlace

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 las opciones 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.
  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
Copiar enlace

Con el fin de utilizar el complemento Red Hat JBoss BRMS con Red Hat JBoss Developer Studio es necesario establecer el tiempo de ejecución.
Un tiempo de ejecución es una colección de archivos jar que representan un lanzamiento específico del software y proporciona las bibliotecas necesarias para la creación y ejecución de sus activos empresariales.

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 que usted 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 haga clic en Navegar para navegar al directorio en donde se encuentran los archivos de tiempo de ejecución en el paso 1. Haga clic en Aceptar para registrar el tiempo de ejecución seleccionado en JBDS.
  5. Indique el tiempo de ejecución que usted ha creado como el tiempo de ejecución Drools predeterminado haciendo clic en la casilla adyacente.
  6. Haga clic en Aceptar. Si tiene proyectos existentes, una ventana de diálogo le indicará que debe reiniciar JBoss Developer Studio para actualizar el tiempo de ejecución.

8.4. Configuración del tiempo de ejecución de JBoss BPM Suite
Copiar enlace

Con el fin de utilizar el plugin JBoss BPM Suite con Red Hat JBoss Developer Studio es necesario establecer el tiempo de ejecución.
Un tiempo de ejecución es una colección de archivos jar que representan un lanzamiento específico del software.
Si descargó previamente el archivador zip implementable genérico de JBoss BPM Suite del Portal del cliente de Red Hat, los archivos jars que componen el tiempo de ejecución se encuentran en el archivador 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 haga clic en Navegar para navegar al directorio en donde se encuentra el tiempo de ejecución.
  4. Haga clic en Aceptar, seleccione el nuevo tiempo de ejecución y haga clic en Aceptar de nuevo . Si tiene proyectos existentes, una ventana de diálogo indicará que tiene que reiniciar JBoss Developer Studio para actualizar el tiempo de ejecución.

8.5. Configuración del servidor JBoss.
Copiar enlace

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... y seleccione Servidor → Servidores.
  3. Abra el menú del servidor haciendo clic con el botón derecho del ratón en el panel de servidores y seleccione Nuevo → Servidor.
  4. Defina el servidor seleccionando JBoss Enterprise Middleware → JBoss Enterprise Application Platform 6.4 y haga clic en Siguiente.
  5. Establezca el directorio de inicio haciendo clic en el botón Navegar. Navegue hasta el directorio 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 de configuración esté definido y haga clic en Terminar.
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 el servidor 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 el siguiente comando. Este comando es específico para Linux y Mac solamente. En estas plataformas, si sshd ya se inició entonces este comando fallará. En este caso, puede ignorar este paso. 
    /sbin/service sshd start
    Copy to Clipboard Toggle word wrap
  3. En JBoss Developer Studio, seleccione Archivo → Importar... y navegue a la carpeta Git. Abra la 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.
  5. Ingrese la información sobre el repositorio Git en la siguiente ventana y haga clic en Siguiente.
    Información sobre el repositorio Git
    View larger image
    Información sobre el repositorio Git

    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 directorio que no esté vacío, haga los cambios en la configuración y haga clic en Siguiente.
  8. Importe el proyecto como un proyecto general en la siguiente ventana y haga clic en Siguiente. 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 el servidor desde la pestaña del servidor y haga clic en el icono de inicio.
  2. En JBoss Developer Studio, seleccione Archivo → Importar... y navegue a la carpeta Git. Abra la 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.
    Información sobre el repositorio Git
    View larger image
    Información sobre el repositorio Git

    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 clic en Siguiente.
  5. En el diálogo que se abre, seleccione el botón de radio Importar como proyecto general desde el Asistente para grupo de importación de proyectos y haga clic en Siguiente. Nombre el proyecto y haga clic en Terminar.
    Asistente para importación de proyectos
    View larger image
    Asistente para importación de proyectos

    Figura 8.4. Asistente para importación de proyectos

8.7. Creación de un proyecto Drools
Copiar enlace

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 reglas HelloWorld de ejemplo al proyecto. Acepte esta opción predeterminada haciendo clic en Siguiente 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 y la 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 que contiene 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
Copiar enlace

Procedimiento 8.8. Creación de un nuevo proyecto JBoss BPM Suite enRed Hat JBoss 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 reglas HelloWorld de ejemplo al proyecto. Acepte esta opción predeterminada haciendo clic 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 que contiene 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 9. Planificador de recursos empresariales
Copiar enlace

El planificador de recursos empresariales es una máquina liviana integrable que optimiza los problemas de planificación. Ayuda a los programadores de Java TM normales a resolver problemas de planificación y 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 hace el seguimiento de la administración de camas hospitalarias.
  • Horarios para educación. El planificador ayuda a programar lecciones, cursos, exámenes y presentaciones 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 recursos tales como el papel y acero.

9.1. Instalación del planificador de recursos empresariales
Copiar enlace

  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 luego haga clic en Descargar.
  1. En la línea de comandos, desplácese al directorio examples/
  2. En un entorno Unix, ejecute el siguiente comando: 
    ./runExamples.sh
    Copy to Clipboard Toggle word wrap
    En un entorno de Windows, ejecute el siguiente comando: 
    ./runExamples.bat
    Copy to Clipboard Toggle word wrap
  3. Elija un ejemplo de los ejemplos de la aplicación GUI que se abre y ejecútelo en su IDE preferido.

Apéndice A. Historia de revisiones
Copiar enlace

Historial de revisiones
Revisión 6.2.0-3.1Thu Dec 10 2015Red Hat Localization Services
Los archivos de traducción sincronizados con fuentes XML 6.2.0-3
Revisión 6.2.0-3Mon Nov 30 2015Tomas Radej
Se agregó una nota sobre las versiones en el historial de revisiones, se modificaron las fechas del changelog.
Revisión 6.2.0-2Mon Nov 30 2015Tomas Radej
Se corrigieron los nombres de los productos y errores de ortografía menores.
Revisión 6.2.0-1Mon Nov 30 2015Tomas Radej
Construcción inicial para el lanzamiento 6.2.0 de JBoss BPM Suite.

Aviso Legal
Copiar enlace

Copyright © 2015 Red Hat, Inc.
This document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0 Unported License. If you distribute this document, or a modified version of it, you must provide attribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be removed.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
Volver arriba
Red Hat logoGithubredditYoutubeTwitter

Aprender

Pruebe, compre y venda

Comunidades

Acerca de la documentación de Red Hat

Ayudamos a los usuarios de Red Hat a innovar y alcanzar sus objetivos con nuestros productos y servicios con contenido en el que pueden confiar. Explore nuestras recientes actualizaciones.

Hacer que el código abierto sea más inclusivo

Red Hat se compromete a reemplazar el lenguaje problemático en nuestro código, documentación y propiedades web. Para más detalles, consulte el Blog de Red Hat.

Acerca de Red Hat

Ofrecemos soluciones reforzadas que facilitan a las empresas trabajar en plataformas y entornos, desde el centro de datos central hasta el perímetro de la red.

Theme

© 2025 Red Hat