Hace poco salió el jBPM 3.3.0GA, y ha tocado pelearse un poco por un par de problemillas… Lo primero es que ya te viene con un bonito instalador con el que tropecé un par de veces (alguna torpeza mia, alguna error que otro del jbpm y algún error que otro de descarga de paquetes…).
En el menú te permite descargarte opcionalmente el Eclipse, el JBoss 4.2.2 y la GWT Console… si estais empezando de cero, bajaros todo… aunque recomiendo bajaros aparte el Eclipse, por claridad más que nada.

Una vez instalado todo, podeis seguir las instrucciones que puse en el post anterior “Instalando jBPM en eclipse 3.4″. a partir de la instalación de las jBossTools.

Eso si… en esta versión hay un pequeño (o gran) error por ahi, como bien nos comentan en el foro de jboss jBPM

“Problems with jBPM 3.3.0 GA and the GPD” . La solución es bien sencilla… simplemente modificar el archivo ‘version.info.xml’ en ’src/resources/gpd’ por esto :

<jbpm-version-info name="jBPM3" namespace="urn:jbpm.org:jpdl-3.3">

  <classpathentry path="lib/jbpm-jpdl.jar" src="src/jbpm-jpdl-sources.jar" />
  <classpathentry path="lib/jbpm-identity.jar" src="src/jbpm-identity-sources.jar" />

  <classpathentry path="lib/antlr.jar" />
  <classpathentry path="lib/asm.jar"/>
  <classpathentry path="lib/bsh.jar"/>
  <classpathentry path="lib/cglib.jar"/>
  <classpathentry path="lib/commons-collections.jar"/>
  <classpathentry path="lib/commons-logging.jar"/>
  <classpathentry path="lib/dom4j.jar"/>
  <classpathentry path="lib/hibernate.jar"/>
  <classpathentry path="lib/hsqldb.jar"/>
  <classpathentry path="lib/junit.jar"/>
  <classpathentry path="lib/log4j.jar"/>

  <config path="config"/>
  <examples path="examples" />

</jbpm-version-info>

También ha salido hace prácticamente una semana el jBPM 4.0.0Alpha, pero mejor me espero un poquillo que los “Alpha” son muy traicioneros…

Vamos a ello :

Hay que bajarse la nueva versión de Eclipse :
http://www.eclipse.org/downloads/

Y te la copias donde gustes… asegurate eso si de dejarte un enlace en el escritorio al eclipse.exe, por aquello de la comodidad y tal.

También nos tenemos que bajar el jbpm :

http://www.jboss.org/jbossjbpm/

Y aqui en el apartado downloads tenemos un buen manojo de ficheros a elegir… para no complicarse lo mejor es elegir el suite, que esta todo y bien ordenadito. Te bajas el archivo y lo descomprimes donde quieras, por ejemplo en C:\jBPM\jbpm-jpdl-3.2.3

Ahora añadimos el JBossTools, que es un conjunto de herramientas diseñadas para el servidor JBoss, entre ellas el jBPM y el Hibernate (http://www.jboss.org/tools/download/index.html).

Yo por si acaso siempre me bajo las cosas estables , en este caso esta disponible el JBossTools 2.1.2.GA

Ejecutas Eclipse y te vas directo a Help/Software Updates, vamos a la pestaña Available Software y le das al botón Add new Site y agregas la dirección del repositorio donde se encuentra:

http://download.jboss.org/jbosstools/updates/stable

Y listo, así de simple, si quereis un nuevo proyecto jBPM vais a File, New, Other, buscais la carpeta jBoss jBPM, Process Project y a jugar!

La primera vez que hagais un nuevo proyecto os preguntará donde están los ficheros del jbpm… una pantallita tal que asi :

Teneis que poner la ruta donde habeis instalado el jbpm y ya está.

1: Paciencia (Igual para vosotros con esta guia no )

2: La ultima versión que te puedas descargar del JDK (yo me instale el jdk1.6.0_06)

3: El jBPM (yo me baje jbpm-jpdl-suite-3.2.3)

4: Eclipse 3.3 (me pegué durante un par de dias con el 3.4 pero no consegui instalar el jBPM… si alguno lo consigue me lo explique plz)

5: El Apache Ant (yo tengo el apache-ant-1.7.1)

6: El WordPad

Lo primero bajarse el JDK, mucho fácil, te vas a esta página y te la descargas :

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

A continuación lo ejecutas y le das a todas las opciones por defecto… es bastante simple, lo unico es que necesitaremos configurar un par de cosillas en nuestro querido sistema operativo para interactuar con Java una vez instalado. Esto lo haremos cuando instalemos el Apache Ant.

Ahora vamos a por el jBPM :

http://www.jboss.org/jbossjbpm/

Y aqui en el apartado downloads tenemos un buen manojo de ficheros a elegir… para no complicarse lo mejor es elegir el suite, que esta todo y bien ordenadito. Te bajas el archivo y lo descomprimes donde quieras, por ejemplo en C:\jBPM\jbpm-jpdl-3.2.3

De ahi te saldra unos cuantos directorios… config, db, deploy… el que nos interesa es “designer”, en ese directorio es donde trabajaremos con Eclipse.

Otro directorio importante es “server” y como su nombre indica es donde esta instalado el servidor jbpm donde miraremos nuestros diseños de workflow, trazas, etc..

Bueno… antes de irnos por las ramas, nos bajamos el Eclipse, como ya  he dicho, no consegui hacer nada con el Eclipse 3.4 (Ganymedes), asi que si no quereis problemas bajaros el 3.3 (Europe).

http://www.eclipse.org/downloads/

Te descargas el .zip en el directorio “designer” del directorio donde te hayas instalado el jBPM. No hace falta descomprimirlo, de eso y de fusionar Eclipse-jBPM se encarga el Apache Ant.

Y ya que hablamos del Ant , vamos a bajarnoslo :

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

Lo descomprimimos donde querais.. yo lo tengo en Archivos de programa\Ant-1.7.1

Y este al igual que el JDK necesitamos configurarlo para interactuar con windows :

Te vas a Variables de Entorno (Propiedades de MiPc, Opciones avanzadas) y “Modificas” la variable de entorno PATH, añades el directorio bin del jdk y del ant (por ejemplo ;C:\Archivos de programa\Ant-1.7.1\bin).

A continuación crearemos un par de nuevas variables entorno :

JAVA_HOME y ANT_HOME y añadis la ruta donde tengais instalado estas aplicaciones.

Bueno, y finalmente le llega el turno al WordPad:

Nos vamos de nuevo al directorio “Designer” y editamos “build.properties”, el archivo debe quedar de la siguiente forma, en negrita pongo lo que he cambiado:

# the next property points to the eclipse zip file on your local
# machine.  the build script in this directory contains a target
# to get eclipse and put it in this directory.  in case you have it
# in another location, update the property below.

eclipse.file.name=eclipse-SDK-3.3-win32.zip

# Replace the eclipse.local.path with the uncomment version if you want
# to supply eclipse in this directory.
eclipse.local.path=.
#eclipse.local.path=${user.home}/jbpm/repository/eclipse/sdk/3.3
eclipse.local.url=${eclipse.local.path}/${eclipse.file.name}

#eclipse.remote.path=http://repository.jboss.com/eclipse/sdk/3.3
#eclipse.remote.url=${eclipse.remote.path}/${eclipse.file.name}

Bueno.. tanta cosa y al final es añadir 3 almohadillas y quitar una… en fin…

En principio ya esta todo en su sitio, ahora solo falta dejar trabajando al Apache Ant, nos vamos a la consola de windows (Inicio, Ejecutar, cmd) y nos vamos al directorio de nuevo “Designer”, desde ahi ponemos “ant install” y si no hay ningun error te saldra un “BUILD SUCCESSFUL”. Si es así, ya lo tienes hecho.

A partir de ahora entraras en Eclipse por el archivo “designer.bat”. Si quieres probar algo sencillito, le das click al icono Workbench, vas a File | New | Other | JBoss jBPM | Process Project y le das de nombre al proyecto “Simple”

También podeis probar el servidor jBPM, para esto vais al directorio “server” y le dais a “start.bat”, cuando termine de cargarse vais a vuestro navegador favorito a la dirección :

http://localhost:8080/jbpm-console

y ahi podeis jugar con una aplicacion ejemplo.