En este punto asumimos que ya sabes como crear un proyecto SOA, configurar un Data Source y un Connection Pool desde la consola de WebLogic.

Una vez creado nuestro proyecto SOA lo que sigue es crear un Schema el cual contenga los tipos de datos que usaremos para el Request y Response de nuestro servicio el cual quedaría a sí.

fig.1: Muestra la estructura del schema necesario para crear el servicio de registro de usuarios.

Ya con el schema procedemos a crear un proceso BPEL con el schema anterior y configuramos para que quede de la siguiente manera:

Fig.2: Muestra la configuración del BPEL con el Reques y Response del Schema anterior.

El paso siguiente es crear la tabla de USUARIOS en nuestra base de datos la cual deberá estar accesible con el usuario que usaremos en el registro del DataSource.

En este punto tendremos la Composición SOA de la siguiente manera:

Fig.3: Estado de la Composición después de crear el proceso BPEL.

Lo que sigue a continuación es crear un DataBase Adapter para lo cual arrastramos el DataBase Adaper de la paleta a la sección de External References y nos saldrá el Wizzard y presionamos siguiente en la primera pantalla llevándonos a la siguiente pantalla:

En esta pantalla solo podremos el nombre que le daremos al Adaptador dentro de Composite por lo que ponemos un nombre que lo identifique rápidamente y presionamos Next para continuar.

 La siguiente tendremos que definir la forma en que nos vamos a conectar a la base de datos para lo cual vamos a requerir dos conexiones distintas, la primera(Arriba) es una conexión diracta con la base de datos que se utilizara exclusivamente en tiempo de desarrolla, ya que sera necesaria para introspectar la base de datos y crear los Schemas necesarios para hacer la comunicación. En caso de no tener ninguna disponible tendremos que crear una nueva con el botón verde de +.

Una vez configurada nuestra conexión tendremos que configurar la segunda(Abajo) esta es exclusiva para tiempo de ejecución y tendremos que poner el nombre del JNDI de un Connection Pool (Como crear un Connection Pool) registrado en WebLogic y presionamos Next para continuar.

En la siguiente pantalla tendremos que especificar el tipo de operaciones que realizaremos, En este caso como solo haremos Insert y Select seleccionamos las opciones siguientes y presionamos Next.

 La siguiente pantalla es para seleccionar las tablas con las que estaremos trabajando por lo que el botón de Import Tables y seleccionamos la tabla de usuarios para continuar.

La siguiente pantalla es para realizar las asociaciones pero como no tenemos solo presionamos Next.

El wizzard nos dirigirá a la pantalla para seleccionar los campo con lo cuales podremos interactuar por lo que seleccionamos todos y continuamos.

 En el siguiente paso configuramos el Query del Select de la siguiente manera pues buscaremos al Usuario por medio de su nombre de usuario o correo.

Finalmente presionamos Next en las dos siguientes pantalla para finalizar y tendremos el DBAdapter en nuestra composición.

El siguiente paso sera asociar el DBAdapter al BPEL como se muestra en la siguiente imagen:

En este punto la composición SOA ya esta lista pero faltara programar el BPEL para que realice las operaciones necesaria para registrar al usuario.

En este caso la lógica del BPEL sera la siguiente, Cuando llega una solicitud validara que el nombre de usuario no exista consultando la tabla por medio del nombre de usuario, si no existe registrara al usuario y regresara el código ‘000’ y la leyenda ‘Registro Exitoso’, en caso de que el usuario ya exista regresaremos el error ‘111’ y la leyenda ‘Usuario existente’ y finalizara.

DESARROLLO DEL BPEL

Primero que nada abrimos el BPEL dando doble click sobre el, esto nos llevara al editor y veremos lo siguiente en pantalla:

Si prestamos atención en la imagen veremos en rojo el DBAdapter que configuramos hace un momento como un PartnerLink lo cual indica que todo va bien hasta ahorita.

El siguiente paso sera crear una actividad Invoke de la siguiente manera:

En esta pantalla tendremos que definir primero que nada el nombre de la actividad en en el campo Name, después seleccionar el PartnerLink que deseamos invocar y tener cuidad de seleccionar la Operación de Select, Otro paso importante es crear la variables Input y Output de la parte de abajo y ponerles el nombre QueryUserInputVariable y QueryUserOutputVariable para finalizar.

Seguido creamos un actividad Assign para asignar los valores de entrada(InputVariable) a la variable de entrada del servicio (QueryUserInputVariable) para lo cual aremos la siguiente asignación:

El BPEL nos quedara de la siguiente manera:En este momento la variable QueryUserOutputVariable contendrá los resultados de la invocación del servicio por lo que tendremos que validar si encontró resultados mediante una actividad IF debajo del la actividad Invoke y la configuraremos de la siguiente manera:En este IF contamos los nodos del resultado, si es mayor que cero entonces quiere decir que el usuario ya existe y tendremos que regresar el error. Por lo cual agregamos una actividad Assign y un Reply quedando el IF de la siguiente manera:

La actividad ErrorAssign lo configuramos de la siguiente manera:

La actividad ErrorReply la configuramos de la siguiente manera:

Con esto lograremos que el BPEL regrese el error al detectar que ya existe el usuario.

El siguiente paso sera crear otra actividad Invoke para el mismo PartnerLink pero esta vez para la operación de Insert y definiremos las variables de entrada(InsertUsuarioInputVariable).

Creamos una actividad Assign para asignar los valores de la variable InsertUsuarioInputVariable para que quede de la siguiente manera:

Finalmente con un assign modificamos la variable OutputVariable para regresar el código 000 y la leyenda Registro Exitoso.

y el BPEL quedara de la siguiente manera:

Solo nos queda deployar y probar el servicio.

The post SOA Suite – Como usar el DataBase Adapter appeared first on Oscar Blancarte - Software Architecture.

Paso 1: Crear una proyecto SOA.

Entraremos a JDeveloper y daremos click en File/New/SOA Project y nos saldrá la pantalla siguiente, Solo cambiamos el nombre del proyecto a “Calculadora” y damos Next en las dos pantallas.

En este punto ya habrás creado una SOA Project y te abrirá la pantalla del Composite, de no ser a podemos abrirlo desde el archivo composite.xml que se genera en la estructura del proyecto:

Paso 3: Crear los tipos de datos en un Schema

El siguiente paso es clave ya que es indispensable definir los tipos de datos que recibirá y responderá nuestro servicio para lo cual crearemos un Schema de la siguiente manera File/New/XML Schema asegurándonos que la pestaña All Technologies este seleccionada.

 En la siguiente pantalla solo cambiamos el nombre del archivo a “Calculadora.xsd” y continuamos.

Continuaremos con crear los tipos de tal forma que nuestro Schema quede de la siguiente manera:

NOTA: En la siguiente entrada explico mas a detalle como crear un Schema

Paso 3: Crear un BPEL

 Con el Schema creado ya podemos crear un BPEL que reciba SumaRequestType y que tenga como resultado un SumaResponseType

Abriremos el archivo composite.xml que se crea con el proyecto en el cual daremos click derecho en la sección del medio “Components” y seleccionamos Insert/BPEL Process como se muestra en la siguiente figura.

 Nos deberá aparecer una pantalla como la siguiente y pondremos los datos como aparecen:

Seleccionamos la opción de BPEL 2.0, Cambiamos el nombre a CalculadoraProcess, En NameSpace podemos poner lo que mas nos agrade no es necesario dejarlo igual, En Temple seleccionamos Synchronous BPEL Process para que sea un servicio con entrada y respuesta y finalmente en Input y Output seleccionamos los tipos que definimos en el Schema del paso 2. Seleccionar los correctamente los Input y Output es un paso clave ya que definen los tipos que se utilizaran como parámetro de entrada y salida de nuestro servicio. Finalmente presionamos OK y tendremos creado en BPEL que se mirara a sí:

En el centro tenemos el BPEL(Azul) el cual lo creamos en el paso anterior, Del lado izquierdo tenemos expuesto un WebService que para los parámetros
al BPEL y de igual forma regresara al consumidor el resultado del BPEL, Entre medio de los dos tenemos una linea que indica que el WebService y el BPEL están conectados por lo que la información fluirá entre los dos.

Ya con el BPEL creaso solo faltara programar el BPEL para que realice el calculo de la suma para lo cual daremos doble click sobre el BPEL para abrir el editor y nos dirigirá a la siguiente pantalla:

La imagen anterior nos muestra la forma mas simple del BPEL el cual solo tiene dos actividades receiveInput que solo recibe los parámetros de entrada en la variable llamada “InputVariable” y la actividad replyOutput las cual regresa el resultado del BPEL en la variable “OutputVariable”. Ambas variables son creadas de forma automática y corresponden con los tipos definidos en el Schema (SumaRequestType y SumaResponseType).

El siguiente paso consiste en sumar los dos valores y ponerlos en la variable OutputVariable para que BPEL regrese el resultado al terminar. Para esto tendremos que crear una actividad llamada Assign la cual se encuentra en la paleta de componentes del lado  Derecho:

Presionamos sobre “Assign” y sin soltar arrastramos hasta colocarlo en medio de las dos actividades existentes y le ponemos el nombre de SumaAssign quedando como se muestra en la figura anterior.

La actividad Assign sirve para asignar valores a cualquier variable que tengamos en el BPEL por lo cual daremos doble click sobre la actividad Assign:

Veremos la pantalla anterior la cual esta dividida en tres secciones:

• Izquierda: De esta parte tomaremos los valores para hacer las asignaciones
• Derecho: En esta sección ponemos los valores asignados mediante la sección de la izquierda.
• Abajo: Aquí solo se en listan las asignaciones que vamos haciendo.

Para sumar los dos valores necesitaremos mas de un campo por lo que tendremos que hacer una formula arrastrando la calculadora hasta el nodo llamado result:

En la pantalla siguiente solo seleccionamos el nodo num1 para que se coloque arriba agregamos el operador “+” y hacemos lo mismo para el num2, Con esto ya tenemos lista la formula y damos ok.

Finalmente tendremos la asignación en la parte de abajo y presionamos OK para finalizar la asignación.

Guardamos los cambios del proyecto y nuestro BPEL esta listo para deployarse

Paso 4: Deploy

Para hacer el deploy tendremos que tener corriendo una instancia de WebLogic con la SOA Suite instalada y seguir los siguientes pasos.

Sobre el proyecto hacemos click derecho y precionamos /Deploy/Composite… y nos saldrá una pantalla nueva. Seleccionamos Deploy to Aplicaction server/Next en la pantalla siguiente Next sin hacer ningún cambio, en la siguiente pantalla seleccionamos el servidor al que queremos hacer deploy o damos de alta uno nuevo en caso de no tener ninguno registrado, En la siguiente pantalla solo seleccionamos next, y finish.

Con estos pasos tendremos la composicion SOA y el BPEL deployados y ya solo faltara hacer una prueba con algún cliente de WebServices como soapUI o la consola de Weblogic.

Paso 5: Prueba

Para obtener la URL del webservice nos vamos al portal EnterpriceManager el cual esta en la url

http://localhost:7001/em en caso de no estar instalado el weblogic en la misma maquina cambiar localhost por la IP.

Una vez autenticados del lado izquierdo entramos a la ruta /SOA/soa-infra/default/Calculadora

nos abrirá un dashboard solo de la composición y en ella veremos un icono con un mondo y una pieza de rompecabeza, damos click y aparecera una url que termina en ?wsdl esa la copiamos y la usamos en cualquier cliente para consumir webservices.

NOTA: Mas adelante publicare como instalar JDeveloper, WebLogic, SOA Suite y OSB.. 

The post Oracle SOA Suite – Como crear un BPEL appeared first on Oscar Blancarte - Software Architecture.

Hoy en día los sistemas de información generan una gran cantidad de información mediante la operación del día a día. Estos sistemas generalmente están comunicados con otros sistemas o módulos para compartir o extraer información.  Esta comunicación entre sistemas es llamado “Integraciones” y son muy importantes ya que de no existir los sistemas no se podrían comunicar y se generaría un caos.

Un ejemplo claro de integración:

Imagínate un sistema de punto de venta en donde se capturan las ventas diarias, se cobra y se consulta inventario. El punto de venta cada vez que realiza una venta tiene que descontar del almacén las unidades vendidas las cuales el Sistema de Almacén resta y lleva la cuenta para hacer los pedidos cuando la existencia esta bajando. Por otra parte las vendedoras consultan el inventario para saber si algún producto lo aun lo tiene en existencia y poder dar cotizaciones a los clientes.

Al finalizar el día todas las ventas se van al sistema de contabilidad para hacer las pólizas contables.

Si nos damos cuenta el sistema de ventas necesita una “Integración” constante con el sistema de Almacén ya que desde allí consulta la existencia pero también la modifica cuando venden.

Al final del día el sistema se tiene que “Integrar” con el sistema de contabilidad para realizar las pólizas.

Hora imaginemos que estas integraciones no existieran!!, Te imaginas como se pudiera operar si esta comunicación con los sistemas no se pudiera dar o no fuera eficiente?

SOA Composite

Bien un composite es donde diseñamos a un alto nivel la integración o Integraciones las cuales serán expuestas como servicios para que los sistemas los consuman y logren la integración.

Una composición SOA se divide en tres secciones:

• Exposed Services: En esta sección describimos la forma en que expondremos los servicios ante los consumidores(Aplicaciones), esta sección podemos exponer WebServices, EJB, Servicios HTTP, Sockets los cuales sirven para que los clientes puedan iniciar la integración bajo demanda, pero también existen métodos que hacen que muestra integración se ejecutaba bajo algún evento en especial como por ejemplo, Colas de mensaje(Queue) JMS, Base de datos(Poolling), B2B. En resumen esta sección representa la entrada de la integración y el inicio de su ejecución.
• External References: En esta sección ponemos los servicios externos que requeriremos para que nuestra integración se pueda realizar. Aquí podemos poner WebServices, Base de datos, HTTP, Colas de mensaje, B2B,etc.
• Components: Aquí es donde se programa las acciones a seguir para que nuestra integración realice lo que esperamos, A qui podemos poner BPEL, Human Task, Business Rules,BPM las cuales son componentes diseñados para atacar diferentes problemáticas.

Un composite para la integración del sistema de punto de ventas y almacén se vería algo a sí

Fig.1: Composite para integrar Punto de venta con Almacén.

En la figura anterior podemos ver que tenemos dos servicios del lado izquierdo los cuales representa los servicios que estamos exponiendo para ser consumidos por el Punto de venta.

En medio vemos dos BPEL(En Azul) los cuales se encargan de Orquestar las acciones necesarias para realizar la operación deseada.

Y del lado derecho tenemos el WebService que expone el almacén, el cual tiene las operaciones consultaExistencia y actualizarExistencia necesarias para realizar la integración.

Por ultimo les dejo esta liga donde donde podrán encontrar mucha mas información de lo que es un Composite

http://docs.oracle.com/cd/E14571_01/integration.1111/e10223/arch_02.htm

The post Oracle SOA Suite – Que es un Composite appeared first on Oscar Blancarte - Software Architecture.

Se le llama Orquestar por que BPEL es el encargado de consumir varios servicios en un orden especificado y realizar una función muy concreta.

Escenario practico.

Agencia de viaje: Imagínate que entras a un pagina de agencia de viaje en la cual puedes comprar un paquete que incluye boletos de avión y hotel. Lo único que tenemos que hacer nosotros es decir a donde queremos con la fecha y la agencia de viaje nos arrojara los paquetes con un precio y solo tenemos que pagar con nuestra tarjeta de crédito para que nuestra reservación quede lista.

Una vez que confirmamos nuestra compra la agencia de viaje tendrá que hacer algunas operaciones que no dependen de ella como seria reservar el boleto de avión con la aerolínea, reservar los día del cuarto directamente con el Hotel, Hacer un cargo por el porcentaje que gana la agencia por realizar la venta y por ultimo guardar en el sistema de la agencia el registro de la venta.

Fig.1: Muestra el proceso a realizar para completar una reservación.

Si nos damos cuenta los pasos 2,3,4 no depende de la agencia de viaje si no de servicios que exponen los proveedores como webservices.

Como encaja BPEL en este escenario.

Con BPEL podemos crear un solo servicio que reciba todos los parámetros necesarios para realizar la operación como los datos de la reservación y los datos de la tarjeta de crédito, con estos primero realizaremos la reservación del avión, luego reservaremos el hotel, cargaremos nuestra utilidad al cliente, Guardaremos el registro de la reservación y finalmente regresaremos al cliente la confirmación al cliente. A este proceso se le conoce como orquestar ya que toma el flujo de la ejecución y realiza las tareas de forma automática y en un orden especificado.

Si bien esto te puede parecer algo que cualquier lenguaje pueda realizar la realidad es que BPEL esta diseñador para estos escenarios lo que permite una programación mucho mas rápida.

The post Que es BPEL appeared first on Oscar Blancarte - Software Architecture.