Guías para la Práctica (3): Uso de ActiveBPEL y Eclipse BPEL ...

IntroducciónActiveBPEL es un motor open-source que implementaBPEL4WS 1.1 y WS-BPEL 2.0.Mantenido por la empresa Active Endpoints, quecomercializa versiones avanzadas del mismo.Otras opciones: JBOSS BPM, Apache ODE.Eclipse BPEL Designer es un plugin para Eclipse quepermite crear gráficamente flujos BPEL.Hay algunas incompatibilidades:E.g. Las rutas Xpath generadas en las expresiones porEclipse BPEL Designer pueden no funcionar directamente enActiveBPEL (no necesarias en nuestra práctica).Los utilizaremos para la implementación de lapráctica (parte opcional).Veremos primero ActiveBPEL y después Eclipse BPELDesigner.

Deploy de procesos (1)Instrucciones en docs/deploy_bpel.txtCrear un directorio con los siguientes componentes:wsdl. Contiene los ficheros .wsdl que describen el servicio webresultante de nuestro proceso BPEL y los servicios web utilizadospor éste.bpel. Contiene el fichero .bpel que define nuestro flujo.META-INF. Contiene el fichero wsdlCatalog.xml, queidentifica los ficheros wsdl necesarios.Fichero .pdd que describe meta-información de deployment.Empaquetado:jar cf mybpel.bpr mybpel.pdd wsdl META-INF bpelDeploy:cp mybpel.bpr $CATALINA_HOME/bprEsperar unos segundos hasta que ActiveBPEL detecte el procesoy finalice su deploy.

Deploy de procesos (2)Ver docs/fileFormats.txtmyBpel.pddEspecifica nombre y localización del proceso BPEL.Define un elemento partnerLink para cada partnerdel proceso, especificando su rol y un elementoEndPointReference (especificación WS-Addressing)para indicar cómo localizarlo.También especifica un conjunto de referencias alos ficheros .wsdl utilizados por el proceso.

Deploy de procesos (3)

Deploy de procesos (4)

Deploy de procesos (5)El elemento process especifica el nombre (cualificado conespacio de nombres) y la localización del fichero .bpel en elfichero .bpr.Habrá un elemento partnerLink para cada PartnerLinkdefinido en nuestro proceso BPEL.La primera definición de partnerLink del ejemplo identifica anuestro proceso (myRole). El valor del atributo service será elnombre de nuestro servicio. El atributo binding dice cómo seinvocará (‘RPC’ o ‘MSG’). ‘RPC’ es un estilo obsoleto, por lo queusamos MSG.La segunda define el PartnerLink para el InternalCRM. Elespacio de nombres debe ser el targetnamespace del fichero.wsdl del servicio.El atributo PortName debe tomar el valor del tipo de puertodefinido en el fichero .wsdl del servicio.El contenido del elemento ServiceName debe ser el nombredel servicio definido en el fichero .wsdl.

Deploy de procesos (6)En el elemento wsdlReferences habrá unsub-elemento wsdl por cada fichero .wsdlque utilice nuestro flujo (incluyendo serviciosweb de apoyo y definición de partner linktypes).El valor del atributo namespace se ignora.El valor del atributo location es una “clave”para el fichero wsdlCatalog.xml.

Deploy de procesos (7)wsdlCatalog.xml

Deploy de procesos (y 8)Una entrada wsdlEntry por cada fichero wsdlutilizado.Una entrada schemaEntry por cada fichero .xsdutilizado.Classpath identifica la ruta al fichero wsdl desde laruta dónde se genera el fichero .bpr.Location es el valor de un atributo location deun elemento dentro de la secciónwsdlReferences del fichero .pdd.Sólo necesario para los wsdl.

Administración y depuraciónHeramienta de administración en:http://maquina:puerto/BpelAdminDepuración en Deployment:Ver salida del Tomcat por la salida estándar.A veces los errores son más explicativos.Ver ‘Deployment Log’ en la herramienta de administración.Ver ‘Deployed processes’ para ver si el proceso ha sidoinstalado con éxito.Depuración en Ejecución:Puede activarse el log escogiendo la opción ‘Configuration’ ymarcando la casilla de ‘Logging Enabled’.Cada ejecución recibe un id (puede verse la lista con laopción ‘Active Processes’).Haciendo click en el proceso, puede accederse a una trazagráfica de su ejecución, viendo el estado de cada variable yde cada actividad, así como acceder al log generado(pinchando en la lupa de la parte superior izquierda).

Pasos para la práctica (1)1. Crear los servicios web de apoyo (Mock)1. CRM Interno (basado en el existente).2. Herramienta comunicación corporativa.3. Asignación de recursos incidencias.NOTA: No es necesario considerar excepciones.2. Colocar los ficheros wsdl de los servicios web deapoyo en el directorio wsdl de mi proyecto BPEL.1. Colocar también los ficheros xsd de apoyo.

Pasos para la práctica (2)3. Usar Eclipse BPEL Designer para crear el flujo.Normalmente generará:1. Fichero wsdl describiendo la interfaz que ofrecerá el servicioweb resultado de mi proceso BPEL. Normalmente tendrá ladefinición de tipos, mensajes, tipos de puerto y elpartnerlinktype que modela la interacción con el cliente.2. Un fichero WSDL llamado MyProcessArtifacts.wsdlque definirá los PartnerLinkTypes para los servicios webexternos utilizados por el proceso BPEL.3. El fichero MyProcess.bpel.4. Pueden ser necesarios algunos pequeños cambiosdebido a bugs de Eclipse BPEL Designer (explicadosmás adelante).5. Colocar los nuevos ficheros en su sitio y empaquetare instalar nuestro proceso BPEL.

Pasos para la práctica (y 3)6. Crear un cliente para invocar el servicio web denuestro proceso BPEL.1. Nuestro servicio colgará de:http://maquina:puerto/active-bpel/services/2. Recordad que la traza de ejecución puede verse en la adminweb de ActiveBPEL, haciendo click en la lista de ‘ActiveProcesses’.

Eclipse BPEL DesignerBPEL es un lenguaje pensado para ser creadográficamente (escribir el XML directamente es tediosoy propenso a errores).Eclipse BPEL Designer permite diseñar gráficamenteflujos BPEL y validarlos.Es independiente del motor de ejecución utilizado.Actualmente, no hace el deploy del proceso nipermite ejecutarlo / depurarlo desde Eclipse.Tenemos que coger los ficheros generados y hacer eldeploy manualmente en el motor de ejecución (ennuestro caso ActiveBPEL) para probarlo.http://www.eclipse.org/bpel/

Crear Proyectos1. Crear Proyecto:1. New - Project -BPEL 2.0 - Especificar nombre - BPEL 2.0Facet.2. Añadir fichero BPEL al proyecto:1. New - Other -BPEL2.0 File - Escoger nombre parael proceso y espacio de nombres,2. Escoger plantilla1. Synchronous BPEL Process. Receive / Replysíncrono. El más adecuado para la práctica.2. Asynchronous BPEL Process. Receive / Replyasíncrono3. Empty BPEL Process. Proceso vacío.3. Guardar en carpeta del proyecto.

Editar y Crear Partner Links (1)1. Necesitamos un PartnerLink para el cliente y unopara cada servicio externo.2. Si usamos la plantilla “Synchronous Process”, se noscrea ya un PartnerLink para el cliente. Puede serconveniente editarlo. Para ello, debemos ir al ficheroMyProcess.wsdl que se creó junto con nuestroproceso:1. Podemos editar las partes de los mensajes de request yresponse ya creados, poniendo un nombre.2. Para la práctica, seguramente querremos fijar Referencekind a "type" y escoger string (en las partes de ambosmensajes).3. También podemos editar los nombres y parámetros de laoperación (es la que nuestro servicio BPEL expondrá hacialos clientes).4. Para refrescar los cambios en el fichero BPEL puede sernecesario cerrar Eclipse y volverlo a abrir.

Editar y Crear Partner Links ( y 2)3. Para añadir los PartnerLinks para los serviciosexternos:1. Pulsar ‘+’ al lado de PartnerLinks.2. Necesitamos crear un PartnerLinkType. Podemos hacerlográficamente partiendo de un tipo de puerto WSDL:1. Pulsar Browse – Pulsar botón ‘Add WSDL’.2. Escoger ‘File’ y añadir el fichero .wsdl del servicio externo.3. Aparecerán los tipos de puerto, se selecciona el deseado(normalmente sólo habrá uno y se pulsa ‘ok’).4. Proporcionar un nombre para el PartnerLinkType5. Añadir roles. Para cada rol hay que especificar un nombre yun tipo de puerto (en la práctica lo normal es quenecesitemos un solo rol por PartnerLinkType).6. Pulsar ‘Finish’.3. En las propiedades del PartnerLink, escoger el nuevo rolcomo ‘Partner Role’.

Variables1. Si usamos la plantilla “Synchronous Process”, se noscrean ya variables para la entrada y la salida delproceso:1. Podemos editar las variables haciendo click y cambiando sutipo. Puede ser necesario hacerlo después de editar losmensajes del PartnerLink con el cliente.2. Para añadir variables:1. Pulsar ‘+’ al lado de Variables.2. Pulsar ‘Browse’ para escoger el tipo.3. Si el tipo es de un mensaje definido en un WSDL delproyecto, marcar ‘Messages’ y escoger el adecuado.4. Si es de un WSDL externo hay que marcar antes 'FromImports'.

Crear el Flujo1. Si usamos la plantilla “Synchronous Process”, se noscrea una actividad Sequence que tiene dentro unreceive y un reply.2. Para añadir una actividad antes de otra, nosponemos sobre la segunda y usamos el menúcontextual ‘Insert Before’.3. Para añadir nuevas actividades a un flow o unsequence puede usarse el menú contextual ‘Add’.4. Para configurar una actividad hacemos click sobreella y usamos el panel de propiedades.5. Para añadir links en un flow, usamos el menúcontextual ‘Add Link’ desde la actividad origen yllevamos la flecha a la actividad destino.6. Para añadir una transitionCondition, nos ponemossobre el link y pulsamos ‘New Condition’ en lapestaña de propiedades.

Expresiones y validación1. En las actividades ASSIGN y en las condiciones detransición, podemos tener que definir expresiones.2. Eclipse BPEL Designer incluye un editor de condicionesque sugiere opciones válidas en cada paso.1. E.g. cuando tecleamos el prefijo utilizado para indicar unavariable en una expresión (‘$’) se nos abre un desplegable conlas variables definidas. Si tras el nombre de la variableponemos ‘.’ se nos muestran las partes de dicha variable,…3. El editor incluye un auto-validador. Los componentesmal configurados se muestran con un botón amarillo(warning) o rojo (error) en su parte inferior izquierda.Ratón sobre botón -> mensaje explicativo. Problemas:1. Guardar o incluso reiniciar Eclipse para que refresque.2. En ocasiones raras puede indicar algún warning o inclusoalgún error que no lo son realmente (bugs).

Deploy en ActiveBPEL (1)Los archivos .bpel y .wsdl generados los tenemos en elworkspace de Eclipse, en el directorio del proyecto.Puede haber que editar manualmente los ficheros.BPEL y .WSDL generados para que el deploy enActiveBPEL sea exitoso.En Windows, BPEL Designer hace mal los imports de losWSDL externos (pone paths en lugar de URIs). Workaround:Ir al fichero MyProcessArtifacts.wsdl y modificar los import de loswsdl de los servicios web externos.Es suficiente con quitar la ruta, dejando sólo el nombre delfichero .wsdl (asumiendo que dicho fichero .wsdl va incluido enel directorio wsdl del fichero .bpr del proceso de ActiveBPEL,recordad instrucciones más atrás).

Deploy en ActiveBPEL (y 2)Eclipse BPEL Designer puede generar assigns parainicializar variables que no funcionan en ActiveBPEL.Ocurre con JAX-WS cuando las operaciones JAVAutilizan parámetros que pueden ser nulos (e.g. String).Ejemplo: tipo creado por JAX-WS para representar unparámetro de entrada simple de tipo String para unaoperación llamada getLastTradePrices.Para que funcione correctamente, quitarminOccurs=0.Entonces, al inicializar una variable de ese tipo, EclipseBPEL la inicializará a la cadena vacía. En casocontrario, la inicializará a nada y fallará en ActiveBPEL.