Marcel Caceres

Guía de Usuario jBPM 5

Instalación

This guide will assist you in installing and running a demo setup of the
various components of the Esta guía
le ayudará a instalar y ejecutar una instalación de demostración de los
diversos componentes del jBPM project.proyecto
jBPM. If you have any feedback on how
to improve this guide, if you encounter problems, Si tiene algún
comentario sobre cómo mejorar esta guía, si se encuentra con problemas, or if you want to help out, do not hesitate
to contact the jBPM community as described in the "What o si usted
quiere ayudar, no dude en ponerse en contacto con la comunidad jBPM como se
describe en la sección "¿Qué to do
if I encounter problems or have questions?" section. hacer si me
encuentro con problemas o tengo preguntas? ".

2.1. 2.1.
Prerequisites Requisitos
previos

This script assumes you have Java JDK 1.5+ (set as JAVA_HOME), and Ant 1.7+
installed. Este script
se asume que tiene Java JDK 1.5 o superior (fijado como JAVA_HOME) y Ant 1.7 +
instalado. If you Si don't, use the following links to download
and install them: no, utilice los siguientes enlaces para descargar e
instalar:

Java: http://java.sun.com/javase/downloads/index.jsp Java: http://java.sun.com/javase/downloads/index.jsp

Ant: http://ant.apache.org/bindownload.cgi Ant: http://ant.apache.org/bindownload.cgi

2.2. 2.2. Download the installer Descarga el instalador

First of all, you need to download the installer:
jBPM-{version}-install.zip En primer lugar, es necesario descargar el instalador:
jBPM-{version}-install.zip

You can for example find the latest snapshot release here. Por ejemplo, puede encontrar la
última versión instantánea aquí.

http://hudson.jboss.org/hudson/job/jBPM5/lastSuccessfulBuild/artifact/target/ http://hudson.jboss.org/hudson/job/jBPM5/lastSuccessfulBuild/artifact/target/

2.3. 2.3.
Demo setup Demostración
de instalación

The easiest way to get started is to simply run the installation script to
install the demo setup. La forma
más sencilla de empezar es simplemente ejecutar el script de instalación para
instalar el programa de instalación de demostración.

Simply go into the install folder and run: Sólo tienes que ir a la carpeta de instalación y
ejecutar:

This will:

Esto realizará
las siguientes tereas:

• Download JBoss AS • Descarga
de JBoss AS

• Download Eclipse • Descargar
Eclipse

• Install Drools Guvnor into JBoss AS • Instalar
Drools Guvnor en JBoss AS

• Install Oryx Designer into JBoss AS • Instalar de Oryx de diseño en JBoss AS

• Install the jBPM gwt-console into JBoss AS • Instalar el GWT jBPM-consola en JBoss AS

• Install the jBPM Eclipse plugin • Instalar el plugin de Eclipse jBPM

• Install the Drools Eclipse plugin • Instalar el plugin de Eclipse Drools

This could take a while (REALLY, not kidding, we are downloading an
application server and Esto podría
tomar un tiempo (en realidad, no es broma, estamos descargando un servidor de
aplicaciones y unaEclipse
installation). instalación de Eclipse). The script however always shows which file it is downloading (you
could El script sin embargo, siempre muestra que archivo está descargando
(puede  for example check whether it is still downloading by checking the
whether the size of the file in para comprobar ejemplo, si todavía se
está descargando, verificar si el tamaño del archivo en question in the jbpm-installer/lib folder is still
increasing). cuestión en la carpeta jbpm-installer/lib sigue
aumentando). If you want to avoid
downloading specific Si desea evitar la descarga específica components (because you will not be using
them or you already have them installed somewherecomponentes (porque no
los vaya a utilizar o que ya las han instalado en alguna parte else), check below for running only specific
parts of the demo or directing the installer to an already otra cosa),
marque a continuación para ejecutar sólo determinadas partes de la demo o
direccione la instalación de los componentes a installed compoinstalar.

Once the demo setup has finished, you can start playing with the various
components by starting Una vez que
la instalación de demostración ha terminado, puede empezar a jugar con los
distintos componentes de partidathe
demo setup: la instalación de demostración:

This will: Esta sentencia
realizará las siguientes tareas:

• Start
the H2 database • Iniciar
la base de datos h2

• Start
the JBoss AS • Iniciar
el JBoss AS

• Start
Eclipse • Iniciar Eclipse

• Start
the Human Task Service • Iniciar
el servicio de Human Task

Once everything is started, you can start playing with the Eclipse tooling,
Guvnor and gwt-console, Una vez que
todo se inicia, puede empezar a jugar con las herramientas de Eclipse, Guvnor y
gwt-console, as explained in the next
three sections. como se explica en las tres secciones siguientes.

2.4. 2.4.
Using Eclipse Tooling Uso
de herramientas de Eclipse

The following screencast
[http://people.redhat.com/kverlaen/install-eclipse-jbpm.swf] gives an El siguiente screencast [http://people.redhat.com/kverlaen/install-eclipse-jbpm.swf]
provee overview of how to run a simple
demo process in Eclipse. información general sobre cómo ejecutar un
proceso de demostración simple en Eclipse.

Este le It shows you: muestra:

• How to import an existing example project into your workspace, containing • Cómo importar un proyecto de
ejemplo existente en el área de trabajo, que contiene

• a sample
BPMN2 process for requesting a performance evaluation • un ejemplo de proceso BPMN2 para
solicitar una evaluación del desempeño

• a sample
Java class to start the process • una clase Java de ejemplo para iniciar el proceso

• How to start the process • Cómo iniciar los procesos

Once Eclipse has opened, simple import (using "File -> Import
..." and then under the General

Una vez que
ha abierto Eclipse, realice una importación simple (utilizando "File ->
Import ..." y luego seleccione “Existing Projects into Workspace” en el
proyecto de ejemplo existente (en el directorio  jbpm/installer/sample/evaluation
directory).installer/sample/evaluation). This should add the sample project, including a simple
Esto debe agregar el proyecto de muestra, incluyendo un sencillo BPMN2 process and a Java file to start the
process. proceso BPMN2 y un archivo de Java para iniciar el proceso. You can open the BPMN2 process by double-
Usted puede abrir el proceso de BPMN2 haciendo doble clicking it. clic en él. To execute the process, right-click on ProcessTest.java in the
com.sample package Para ejecutar el proceso, haga clic en
ProcessTest.java en el paquete com.sample (under "src/main/java") and select "Run As - Java
Application". (en "src/main/java") y seleccione "Run
As- Java Application". In this
case, it will simply start the En este caso, simplemente se iniciará el process, which will result in the creation of
a new user task for the user "krisv" in the human task
proceso, que dará lugar a la creación de una tarea de usuario nueva para el
usuario "krisv" en el servicio human
task  Using web management consolesservice, after which the process
will wait for its execution.después el proceso estará a la esperar para
su ejecución. We will show you later
how you could Le mostraremos más adelante cómo se puede complete human tasks like this using a human
task client like the jbpm-console. completar las human tasks como está
usando un cliente de human task con
el jbpm-console.

You could also create a new project using the jBPM project wizard.También puede crear un nuevo
proyecto mediante el asistente de proyecto jBPM. This sample project contains Este proyecto muestra
contiene  a simple HelloWorld BPMN2 process and an associated Java file to
start the process.un proceso simple de BPMN2 con un ejemplo HelloWorld y
un archivo asociado de Java para iniciar el proceso. Simple Simple mente select "File - New ... - Project ..."seleccione "File
- New ... – Project..." and under
the "jBPM" category, select "jBPM project" and click
y bajo la categoría  "jBPM",
seleccione "jBPM Project" y haga clic en "Next". "Next". Give the project a name and click
"Finish". Dé un nombre al proyecto y haga clic en "Finish".
You should see a new project containing
a Usted debe poder ver a un nuevo proyecto que contiene un "sample.bpmn" process and a
"com.sample.ProcessTest" Java class. "sample.bpmn" y
una clase Java "com.sample.ProcessTest". You can open the BPMN2 Puede abrir el proceso BPMN2 process by double-clicking it. por el
doble clic en él. To execute the
process, right-click on ProcessTest.java and select Para ejecutar el
proceso, haga clic derecho en ProcessTest.java y seleccione  "Run
As - Java Application". "Run As - Java Application". You should see a "Hello World"
statement in the output console. Usted debe ver una declaración
"Hello World" en la salida de la consola.

2.5. 2.5.
Using web management consoles
Uso de la gestión web de consolas

Open up the process management console: Abra la consola de gestión de procesos con:

http://localhost:8080/jbpm-console http://localhost:8080/jbpm-console

Log in, using krisv / krisv as username / password. Regístrese utilizando krisv/krisv
como nombre de usuario / contraseña. The
following screencast [http://

El screencast siguiente
[http://people.redhat.com/kverlaen/install-gwt-console-jbpm.swf]

nos dará una
visión general de cómo manejar your
process instances. las distintas instancias del proceso. It shows you:

Este le
muestra:

• How to
start a new process • Cómo
iniciar un nuevo proceso

• How to
look up the current status of a running process instance • Cómo consultar el estado actual
de una instancia de proceso en ejecución

• How to
look up your tasks • Cómo
buscar sus tareas

• How to
complete a task • Cómo
realizar una tarea

• How to
generate reports to monitor your process execution • Cómo generar informes para
supervisar su ejecución del proceso

To manage your process instances, click on the "Processes" tab at
the left an select "ProcessPara administrar las instancias de proceso, haga clic
en la pestaña "Procesos" a la izquierda con la selección de
"Proceso Overview". After a
slight delay (if you are using the application for the first time, due to
sessionInformación general". Después de un ligero retraso (si está
utilizando la aplicación por primera vez, debido al período de sesiones

deinitalization etc.), the "Process"
list should show all the known processes. inicialización, etc), el lista
"Process" debería mostrar todos los procedimientos conocidos. The jbpm-console in En el jbpm-console
the demo setup currently loads all the
process in the "src/main/resources" folder of the evaluation
la instalación de demostración en la actualidad todo el proceso de carga en la carpeta
de la evaluación "src/main/resources" sample in "jbpm-installer/sample/evaluation".
muestra en "jbpm-installer/sample/evaluation". If you click the process, it will show you
all current Si hace clic en el proceso, se le mostrará todas las instancias
 actuales running instances. en ejecución. Since there are no running instances at this point, the
"Instance" table will Dado que no existen instancias que se
ejecutan en este momento, la tabla  "instancia" remain empty. permanecer vacío.

You can start a new process instance by click on the "Start"
button.

Puede
iniciar una nueva instancia de proceso haciendo clic en el botón "Start".
After confirming that you want
Después de confirmar que desea to start
a new execution of this process, you will see a process form where you need to
fill in the para iniciar una nueva ejecución de este proceso, podrá ver
un formulario proceso en el que usted necesita para llenar lanecessary information to start the process.
información necesaria para iniciar el proceso. In this case, you need to fill in your username
"krisv", En este caso, tendrá que rellenar su nombre de
usuario "krisv",  after which you can complete the form and
close the window. después de lo cual usted puede llenar el formulario y
cerrar la ventana. A new instance
should show up Una nueva instancia debe aparecer  in the
"Instance" table. en la tabla "Instance". If you click the process instance, you can
check its details below and the Si hace clic en la instancia del
proceso, usted puede comprobar sus datos a continuación haciendo clic en los
botones diagram and instance data by
click on the "Diagram" and "Instance Data" buttons
respectively. “Diagram” y “Instance Data” respectivamente.

The process instance that you just started is first requiring a
self-evaluation of the user and is La instancia de proceso que acaba de comenzar es
solicitar previamente una autoevaluación del usuario y es waiting until the user has completed this
task. esperando hasta que el usuario ha completado esta tarea.

To see the tasks that have been assigned to you, choose the
"Tasks" tab on the left and select Para ver las tareas que se han asignado a usted,
elija la opción "Tareas" ficha a la izquierda y seleccione "Personal Tasks" (you may need to
click refresh to update your task view)."Personal de tareas"
(es posible que tenga que hacer clic en Actualizar para actualizar la vista de
tareas). The personal tasks Las
tareas personales table should show a
"Performance Evaluation" task for you.tabla debe mostrar el
resultado de una "Evaluación del Desempeño" tarea para usted. You can complete this task by Puede
completar esta tarea selecting it and
clicking the "View" button.seleccionarlo y hacer clic en el
botón "Ver". This will open
the task form for performance evaluations. Esto abrirá el formulario de
tareas para las evaluaciones de desempeño.

You can fill in the necessary data and then complete the form and close the
window. Puede
rellenar los datos necesarios y completar el formulario y cerrar la ventana. After Después de completing the task, you could check the
"Process Overview" once more to check the progresscompletar la
tarea, se puede consultar la "Descripción general del proceso" una
vez más para comprobar el progreso of
your process instance.de la instancia de proceso. You should be able to see that the process is
now waiting for your HR Usted debe ser capaz de ver que el proceso está
a la espera de su FC manager and
project manager to also perform an evaluation.gerente y jefe de proyecto
para llevar a cabo también una evaluación. You could log in as "john" / "john"
Usted puede entrar como "john" / "john" and "mary" / "mary" to
complete these tasks.y "mary" / "marya" para
completar estas tareas.

After starting and/or completing a few process instances and human tasks,
you can generate a Después de
iniciar y / o completar un proceso de pocos casos y las tareas humanas, puede
generar un report of what happened so
far.informe de lo sucedido hasta ahora. Under "Reporting", select "Report Templates".
En la sección "Informes", seleccionar "Informe de
plantillas". By default, the
De forma predeterminada, elconsole has
two report templates, one for generating a generic overview for all processes
and consola tiene dos plantillas de informes, uno para generar una
visión genérica para todos los procesos y one for inspecting once specific process definition.un proceso para
la inspección de una definición específica. If you select the latter, make sure to enter Si selecciona
este último, asegúrese de ingresar "com.sample.evaluation"
as the process definition id to see the activity related to the evaluation
"com.sample.evaluation" como la definición del proceso de
identificación para ver la actividad relacionada con la evaluación process.proceso. Click the "Create Report" button to
generate a realtime report of the current status. Haga clic en
"Crear informe" para generar un informe en tiempo real de la
situación actual. Tome en cuenta Noticeque
la inicialización de los informes pueden tardar un poco, sobre todo la primera
vez que utilice la aplicación.

2.6. 2.6.
Using Guvnor repository Usando
el repositorio Guvnor

The Guvnor repository can be used as a process repository to store business
processes. El
repositorio Guvnor se puede utilizar como un proceso de depósito para almacenar
los procesos de negocio. It also
También offers a web-based interface to
manage your processes.ofrece una interfaz basada en web para gestionar
sus procesos. This includes a web-based
editor for Este incluye un editor basado en web para viewing and editing processes.visualización
y edición de los procesos.

Open
up Drools Guvnor: Abrir Drools Guvnor:  http://localhost:8080/drools-guvnor

http://localhost:8080/drools-guvnor

Log in, using any non-empty username / password (we disabled authentication
for demo Registrarse,
usando cualquier nombre de usuario no-vacío / contraseña (que tiene la
autenticación deshabilitada para propósitos del demo purposes).). The following screencast
[http://people.redhat.com/kverlaen/install-guvnor-jbpm.swf]

El screencast siguiente [http://people.redhat.com/kverlaen/install-guvnor-jbpm.swf]

nosgives an overview of how to manage your
repository. da una visión general de cómo administrar su repositorio. It shows you:

Este le
muestra:

• How to import an existing process (in this case the evaluation process)
from eclipse into guvnor • ¿Cómo
importar un proceso existente (en este caso el proceso de evaluación) del Eclipse
en guvnor?

• How to open up the evaluation process in the web editor • ¿Cómo abrir el proceso de
evaluación en el editor web?

• How to build a package so it can be used for creating a session • Cómo crear un paquete para que
pueda ser utilizado para la creación de una sesión

If you want to know more, we recommend you take a look at the rest of the
Drools Guvnor Si quiere
saber más, le recomendamos que eche un vistazo al resto de la documentación Guvnor
Droolsdocumentation..

Once you're done playing: Una vez que hayas terminado de probar se finaliza con:

ant stop.demo

2.7. 2.7.
What to do if I encounter problems
or have Qué hacer si me encuentro con problemas o tengo questions?preguntas?

You can always contact the jBPM community for assistance. Siempre puedes ponerte en contacto
con la comunidad jBPM para obtener ayuda.

Email: jbpm-dev@lists.jboss.org email:
jbpm-dev@lists.jboss.org

IRC: #jbpm at irc.codehaus.org IRC: # jbpm en irc.codehaus.org

jBPM User Forum [http://community.jboss.org/en/jbpm?view=discussions] jBPM User
Forum [http://community.jboss.org/en/jbpm?view=discussions]

2.8. 2.8. Frequently asked questions Preguntas más frecuentes

Some common issues are explained below. Algunos problemas comunes se explican a continuación.

Q: What if the installer
complains it cannot download component X? Q: ¿Qué
pasa si el instalador se queja de que no se puede descargar componente X?

A: Are you connected to the internet? R: ¿Está conectado a Internet? Do you have a firewall turned on?
¿Tienes un firewall activado? Do you
require a proxy? ¿Necesita un proxy? It Pmight be
possible that one of the locations we're downloading the components from is
temporarlyodría ser posible que uno de los lugares que estamos
descargando los componentes de se encuentre temporalmente offline. fuera de línea. Try downloading the components manually
(possibly from alternate locations) and put Trate de descargar los
componentes de forma manual (posiblemente a partir de ubicaciones alternativas)
y ponerlos them in the
jbpm-installer/lib folder. en la carpeta jbpm-installer/lib.

Q: What if the installer
complains it cannot extract / unzip a certain jar/war/zip? Q: ¿Qué pasa si el instalador se queja de que no se puede extraer /
descomprimir un archivo jar/war/zip?

A: If your download failed while downloading a component, it is possible
that the installer is trying R: Si el proceso de descarga falla al descargar un componente, es posible
que el programa de instalación está intentando to use an incomplete file.el uso de un archivo incompleto.
Try deleting the component in question
from the jbpm-installer/lib folder Trate de eliminar el componente en
cuestión de la carpeta jbpm-installer/lib  and
reinstall, so it will be downloaded again. y vuelva a instalar, por lo
que el archivo se volverá a descargar.

Q: What if I have been
changing my installation (and it no longer works) and I want to start over Q: ¿Qué pasa si he ido cambiando mi instalación (y que ya no funciona) y
quiero volver a empezar again with a
clean installation? de nuevo con una instalación limpia?

A: You can use ant clean.demo to remove all the installed components, so you
end up with a R: Puede
utilizar ant clean.demo para eliminar todos los componentes instalados, para
que pueda iniciar con una nueva  fresh installation again.instalación.

Q: I sometimes see
exceptions when trying to stop or restart certain services, what should I do? Q: Algunas veces aparecen excepciones cuando se trata de detener o
reiniciar ciertos servicios, ¿qué debo hacer?

A: If you see errors during shutdown, are you sure the services were still
running? R: Si ve
errores durante el cierre de este, ¿estás seguro de que los servicios están aún
en marcha? If you see Si usted
ve exceptions during restart, are you
sure the service you started earlier was successfully shutdown?excepciones
en el reinicio, ¿está seguro el servicio que inició antes se cerró con éxito?

Maybe try killing the services manually if necessary. Tal vez debe intentar matar a los
servicios manualmente si es necesario.

Q: Something seems to be
going wrong when running Eclipse but I have no idea what. Q: Algo parece ir mal cuando se ejecuta Eclipse, pero no tengo idea que. What ¿Qué can I do? puedo hacer?

A: Always check the consoles for output like error messages or stack
traces. R: Siempre
revise las consolas de salida, como mensajes de error o trazas de pila. You can also check También puede
consultar the Eclipse Error Log for
exceptions. el Eclipse registro de errores para las excepciones. Try adding an audit logger to your session to
figure out what's Trate de añadir un registrador de la auditoría a la
sesión de averiguar lo que está  happening at runtime, or try debugging your
application. sucediendo en tiempo de ejecución, o tratar de depurar la
aplicación.

Q: Algo parece ir mal cuando se ejecuta una aplicación
 basada en web en como el jbpm- console, Guvnor and the Designer.console,
Guvnor y el Designer. What can I do?
¿Qué puedo hacer?

A: You can check the server log for possible exceptions in the
jbpm-installer/jboss-4.2.3.GA/ R: Puede comprobar el registro del servidor para posibles excepciones en
el directorio de jbpm-installer/jboss-4.2.3.GA / server/default/log directory.server/default/log.

For all other questions, try contacting the jBPM community as described
above.

Para todas
las otras preguntas, trate de ponerse en contacto con la comunidad jBPM como se
describe anteriormente.