Archive for noviembre 2008

javax.xml.soap.SOAPException: java.security.PrivilegedActionException:oracle.j2ee.ws.saaj.ContentTypeException: Not a valid SOAP Content-Type: text/html; charset=UTF-8 ó javax.xml.soap.SOAPException: Message send failed: Premature EOF

0

Es común que al invocar servicios desde BPEL PM se generen éstos tipos de respuestas por una falla del lado del servicio o bien por causas mismas del flujo (time outs).
En un par de clientes en los que he estado trabajando últimamente se presentó este caso, siendo diferente la causa en cada uno de ellos.
En un primer caso sucede porque el Enpoint del WS que estás consumiendo, está mal escrito o simplemente es una ubicación inexistente. Esto provoca que el HTTP Server te conteste diciendo que el contenido es un text/HTML, pues efectivamente la ubicación al no existir, es como si pusieras una URL inválida en un navegador y éste te contestara un HTML con el error.
Por otro lado, cuando sale:
<summary>
exception on JaxRpc invoke: HTTP transport error:
javax.xml.soap.SOAPException: java.security.PrivilegedActionException:
javax.xml.soap.SOAPException: Message send failed: Premature EOF
encountered
</summary>
 
Puede ser por una cuestión de timeout. En procesos largos que hacen varias invocaciones hacia una misma ubicación de HTTP, bien puede suceder que la sesión en el Web server se vea vencida, y por lo tanto cualquier otro request te retorne ese error.
Para solucionar ésto, se sugiere agregar la siguiente opción en el inicio de la JVM:
<data id="java-options" value="-server -XX:MaxPermSize=128M -Xms2048M -Xmx2048M -DHTTPClient.disableKeepAlives=true ... />

Esto aplica para la versión: Oracle SOA Suite 10g (10.1.3)


Con esto evitarás que el HTTP Server haga un reset de la sesión. En casos cuando pasas por LoadBalancers, ésto puede ser típico (gracias Toño y Daniel).




Integrando Oracle BPM Studio 10gR3 con Microsoft Office 2007

0

 

Introducción

El propósito de este documento es demostrar a través de un ejemplo sencillo y práctico como poder integrar 2 poderosas herramientas Oracle BPM con Microsoft Office 2007 (Word, Excel, Powerpoint).

Muchas veces cuando nos toque diseñar e implementar procesos de negocios se requerirá que en el flujo de actividades se tengan que adjuntar documentos tales como Presentaciones, Notas, Documentos y hojas de cálculo pero también es posible que la ejecución de ciertos procesos sean iniciados por alguna de estas aplicaciones.

 

Pre-Requisitos

    • Oracle BPM Studio 10gR3
    • Microsoft Office 2007
    • .NET Framework (versiones 2.0 o 3.0 o 3.5)

Paso 1: Crear un proceso con Oracle BPM

En en menu Principal seleccionar File/New/BPM Project

clip_image002

En la ventana de New BPM Project ingresar el nombre del proyecto, en nuestro caso le llamaremos TestOffice y seleccionar el botón Next.

clip_image004


Paso 2: Configurar el BPM Engine

Lo que haremos en este paso es habilitar los PAPI Web Services lo que nos permitirá comunicarnos con el Office Ribbon

Primero nos colocamos sobre el Nuevo proyecto que acabamos de crear y con el botón derecho del mouse aparecerá una ventana de opciones y de estas seleccionaremos Engine Preferences

clip_image006

Como siguiente paso seleccionaremos el tab Advanced de la ventana de Engine Preference y hacemos seleccionamos el check del Start PAPI Web Services

clip_image008

Después oprimimos el botón Ok para aceptar los cambios realizados.

Paso 3: Crear un Proceso Simple

Crearemos un proceso simple al cual llamaremos igual que a nuestro Proyecto TestOffice, aceptamos los datos por default y oprimimos el botón Ok

clip_image010

3.1 Crearemos un Role llamado TestRole

Para hacerlo en el project Navigator de nuestro Proceso en Organization / Roles y con el botón derecho del mouse seleccionamos New..

clip_image012

3.2 Crearemos un Participante : test

Para hacerlo en el project Navigator de nuestro Proceso en Organization / Participants y con el botón derecho del mouse seleccionamos New..

clip_image014

Los datos a completar serian los siguientes:

- First Name: test

- Last Name : test

- Display Name: test

- Role: TestRole

3.3 Agregar en el proceso TestOffice lo siguiente:

- Una actividad Interactive la cual le daremos el nombre de ActividadHumana

- Y una actividad Global – Global Creation que le daremos el nombre de Instancia

Al final debería de quedarnos un flujo similar a la siguiente imagen

clip_image016

Una vez terminado el flujo lo que debemos de hacer es iniciar el Engine del BPM eliminando las instancias de los Procesos y los archivos de Logs; luego iniciamos el Workspace y nos autenticamos con el participante test.

4. Instalar Add-inn para Microsoft Office 2007

4.1 Verificar la versión del Framework de .NET

Para verificar si se tiene instalado o no el framework de .net lo primero que debemos de hacer ir a Control Panel y hacer double click en Add o Remove Programs y en la lista de programas nos debería aparecer algo similar a esto

clip_image018

4.2 Descargar el add-in

Para descargar e instalar el add-inn nos vamos Oracle BPM Workspace y hacemos click donde dice Download BPM Add-in….

clip_image020

y ahi en la pagina que nos abre este link hacemos clik en download

clip_image021

Ejecutamos la instalación y seguimos las instrucciones del instalador.

5. Configurar Word/Excel para Integracion con BPM

Debemos abrir Excel o Word y en el menu principal seleccionamos el TAB que dice Business Process

clip_image023

Ahora seleccionamos el botón Chage Settings para configurar el BPM Server.

NOTA: Debe de estar ejecutándose el BPM Server o haber iniciado el Engine de BPM

clip_image025

En User ingresamos el Participante que definimos en nuestro proceso de ejemplo y hacemos el Test Connection dándonos como resultado Successfully connected to server….

Después hacemos click en el botón Next

clip_image027

Seleccionamos nuestro Proceso de Ejemplo TestOffice y nuevamente click en el botón Next

clip_image029

Y para finalizar hacemos click en el boton Accept

6. Prueba de Iniciar el proceso con Word/Excel

clip_image031

Hacemos clik en el Submit to Business Process, e inicia un proceso y nos aparece una ventana para seleccionar el Proceso que deberia de recibir el documento.

clip_image027[1]

Una vez que seleccionamos el proceso, hacemos click en el botón Next. Nos aparece una ventana donde podemos ingresar una descripción del documento que esta iniciando el proceso de BPM.

AttachInformacion

Hacemos click en el boton Accept y para concluir nos debería de aparecer una ventana de Confirmation, para confirmarnos que se inicio del proceso de forma exitosa en base a un documento Word/Excel.

Confirmation

Como último paso iremos a nuestro Workspace y nos autenticamos con el usuario test y deberíamos de tener al menos un proceso iniciado llamado TestOffice1 con un documento adjunto.

clip_image037

Felicidades! Ya termino de instalar y configurar su ambiente para iniciar procesos de Oracle BPM basado en Office 2007



Invocando un proceso Síncrono de Oracle BPEL PM desde Oracle BPM Studio

3

Una colaboración de un compañero y gran amigo - Carlos Toso desde Costa Rica. El es un Senior Sales Consultant especialista en los temas de SOA y BPM.

En los últimos meses ha estado trabajando con un producto nuevo de Oracle llamado Oracle BPM y en este artículo se explica cómo integrarlo con Oracle BPEL PM.

Objetivo

El propósito de este documento es mostrar la facilidad y flexibilidad de integrar las 2 herramientas de Oracle para el diseno de flujos humanos utilizando Oracle BPM Studio y Oracle BPEL para la integracion con aplicaciones o flujos estructurados, ambas herramientas forman parte de la nueva suite de Oracle denominada Oracle BPM Suite.

PreRequisitos:

  • Jdeveloper 11.1.0
  • Oracle BPM Studio 10.1.3.4
  • Oracle BPEL 11g

Software Descargable

- Oracle Bea Products Download : http://www.oracle.com/technology/software/products/ias/bea_main.html?rssid=rss_otn_soft

- Oracle Products Download:

http://www.oracle.com/technology/software/index.html

Nota Importante:

Si se quiere replicar esta misma nota con versiones anteriores de JDeveloper 10.1.3.x, Oracle BPEL 10.1.3.x y Oracle Business Process Management Studio 6.0 MP4 se puede hacer sin mayor diferencia tan solo cambian algunas pantallas por la version de los productos


Paso 1

Crear un proyecto SOA Project

Y crear un ejemplo de un proceso muy sencillo utilizando Oracle BPEL, en este ejemplo utilice un Proceso Sincronico que invoca una consulta a la base de datos atraves de un parametro.

clip_image002

Paso 2

Una vez contruido el proceso en Oracle BPEL ejecutar el proyecto desde el archivo composite.xml

clip_image004


Paso 3

Ingresar a la consola de Enterprise Manager, por ejemplo: http://maquina:8988/SOAConsole, donde maquina es el nombre del server o de la maquina donde se instalo y se configuro SOA 11g en Jdeveloper.

clip_image006

Paso 4

Se debe de hacer una primera prueba o testing del proceso hecho en BPEL. Para hacerlo se selecciona el proceso y en el boton Actions seleccionar Test Service - Client

clip_image008

Paso 5

Cuando hacemos Testing sobre el proceso esto nos abre una pagina para definir los parametros de entrada al proceso y la definicion y ubicacion del Service Description

clip_image010

Paso 6

Hacemos un click sobre Service Description para poder capturar el WSDL del servicio del proceso BPEL

Ejemplo:

http://ctosovoy-cr:8988/soa-infra/services/default/BPMinvocaBPEL!1.0*2008-08-28_13-56-33_078/client?WSDL

clip_image012

Paso 7

Abrimos un proyecto o creamos un nuevo proyecto de Oracle BPM Studio y en el proceso con el Rol de Developer creamos a nivel del Project Navigator en Catalog creamos un nuevo module al cual denominaremos OracleBPEL

clip_image014

Paso 8

Ahora a nivel del module OracleBPEL hacemos boton derecho y en la lista de valores seleccionamos Catalogue Component / Web Service

clip_image016

Paso 9

Ahora en la pantalla Catalog Component Wizard copiamos en WSDL Address el EndPoint del proceso BPEL que obtuvimos en el Paso 6 y si dejamos el nombre del Module que te crea apartir del WSDL y hacer click en el boton Next

clip_image018

Paso 10

Deberia de aparecer una pantalla de Instropesting y haber completado el 100% de analisis del WSDL y de generarlo en tu BPM Studio.

clip_image020

Paso 11

Ahora verificamos en el Project Navigator bajo el Catalog / OracleBPEL / el cliente ClienteWSDL (el nombre del cliente puede variar dependiendo del nombre que se le dio en el paso 9) fue generado automaticamente

clip_image022

Paso 12

Ahora agregamos una actividad automatica en el flujo del proceso y la llamamos InvocacionBPEL y hacemos double click en esa actividad

clip_image024

Paso 13

Ahora debemos de arrastrar al editor de codigo lo siguiente: el Service, el Request y el Response, que en nuestro ejemplo serian

BPELProcess2Service, BpelProcess2ProcessRequest, BpelProcess2ProcessResponse y esto genera automaticamente el siguiente codigo

bpelProcess2Service = OracleBPEL.ClientWSDL.BPELProcess2Service()

clip_image026

Paso 14

El editor nos da un Warning donde nos solicita que las variables las debemos inicializar por tanto hacemos el siguiente cambio en el editor como a continuacion se describe

bpelProcess2Service as OracleBPEL.ClientWSDL.BPELProcess2Service = OracleBPEL.ClientWSDL.BPELProcess2Service()

bpelProcess2ProcessRequest as OracleBPEL.ClientWSDL.BpelProcess2ProcessRequest = OracleBPEL.ClientWSDL.BpelProcess2ProcessRequest()

bpelProcess2ProcessResponse as OracleBPEL.ClientWSDL.BpelProcess2ProcessResponse = OracleBPEL.ClientWSDL.BpelProcess2ProcessResponse()

clip_image028

Paso 15

Ahora escribimos a continuacion la variable que definimos bpelProcess2Service y le agregamos un punto al final para que nos muestre las opciones de los metodos y seleccionamos el que dice process y ENTER

clip_image030


Paso 16

Automaticamente nos crea un metodo para invocar al servicio de BPEL

process bpelProcess2Service

using payload = null

returning payloadOutput =

payloadOutput

Paso 17

Ahora le pasaremos un valor estatico al metodo que incorporamos en el paso anterios y para hacerlo escribimos la siguiente variable bpelProcess2ProcessRequest y le agregamos un punto al final para que nos muestre las opciones de los metodos y seleccionamos el que dice input y ENTER

clip_image032

Paso 18

A esta variable le asignamos un valor estatico por ejemplo :

bpelProcess2ProcessRequest.@input = "100"

Y reemplazamos el metodo que teniamos en el paso 16 de esta forma

process bpelProcess2Service

using payload = bpelProcess2ProcessRequest

returning bpelProcess2ProcessResponse =

payloadOutput

Paso 19

Dejando de esta manera el codigo en la actividad de invocacion de Oracle BPEL

clip_image034

Paso 20

Lo unico que nos hace falta para verificar el valor de respuesta del proceso de BPEL agregaremos al codigo la siguiente instruccion

Display bpelProcess2ProcessResponse.result

clip_image036

Con este ultimo paso el resultado del proceso de BPEL lo mostraremos en el LogViewer del Proceso BPM.

clip_image038

Listo!!! Ya tienen un ejemplo muy sencillo de como integrar tanto Oracle BPM Studio con Oracle BPEL.

Lo unico que hace falta es ejecutar el proceso de BPM Studio y tener el servicio de BPEL ejecutandose.

Conclusión:

A nivel de BPM (Business Process Management) que es una metodologia empresarial para la mejora de procesos hay muchos enfoques de abordar el modelaje de estos flujos por tanto se debe de contar diferentes alternativas de solucion y soporte a diferentes estandares que nos ayuden tanto en la flexibilidad como en la capacidad de integracion. Oracle BPM Suite incopora estandares tales como BPMN, XPDL, BPEL y el proposito final de esta nota tecnica es demostrar como en pocos pasos integramos ambas herramientas.

Links de interes:

http://www.oracle.com/technology/tech/soa/index.html (SOA)

http://www.oracle.com/technology/products/bpm/index.html (BPM)


Post navigation