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.

Componentes de una Composición SOA:

Service Component

• HumanTask: Cuando automatizamos proceso por medio de BPEL o BPM llega el momento en que la computadora no es capaz de tomar una decisión por si mismo por lo que requiere de la intervención de un Humano para que toma la decisión mas apropiada y a si continuar con el resto del flujo. Estas decisiones se hacen mediante HumanTask las cuales son mini-aplicaciones ADF que son desplegadas en el portal WorkList de la SOA Suite.

• Business Rule: Este componente sirve para exponer reglas de negocio re-utilizables que pueden ser modificadas sin necesidad de desplegar nuevamente. En una Business Rule podemos definir funciones que ayuden a hacer cálculos o tomar sediciones de una forma mas inteligente, También nos da la posibilidad de crear Tablas de sección las cuales arrojan un resultado mediante la evaluación de reglas cruzadas.
• BPEL Process: Los BPEL estan diseñados para orquestar servios y realizar integraciones de forma automática con la menor interacción humana. Ya tengo una Entrada en la cual hablo mucho mas a detalle de lo que es un BPEL y también hablo de como crear un BPEL.
• Mediator: Los mediator están diseñados para mediar entre un component y otro, es decir nos ayuda a convertir el formato de salida de un servicio en la entrada de otro, pero también nos sirve para inyectar nuevos parámetros.
• Spring Context: Para los ya familiarizados con este potente framework se le hará muy simple comprender su funcionalidad pero para lo que no les podría comentar que este componte nos sirve para tener una interacción mas directa con Java ya que a través de este componente es posible ejecutar clases java para hacer funcionalidad muy especificas que con BPEL serie imposible o muy difícil de realizar.

Service Adapter

• B2B Adapter: Este es un adaptador especifico para comunicarnos con la plataforma de B2B de Oracle SOA Suite por medio de una cola de mensajes JMS
• BAM Adapter: Este adaptador nos permite comunicarnos con Business Activity Monitor(BAM) una plataforma de monitorio en tiempo real.
• Data Base Adapter: Adaptador que nos permite interactuar con una base de datos determinada, Esta comunicación se hacer siempre a través de un Pool de conexiones que se tiene que configurar desde la consola de WebLogc y que es accedida por medio del JNDI.
• Direct Binding Adapter: Este es un adaptador que nos permite comunicarnos con nuestros recursos a a través del protocolo propietario de Oracle llamado t3 el cual tiene la ventaja que es mucho mas directo y que ayuda al performance.
• EJB Services: Adaptador que nos ayuda a comunicarnos por medio de EJB los cuales son parte del JavaEE.
• File Adapter:  Este adaptador esta diseñado para interactuar con sistemas de archivos o servidores FTP/SFTP y nos permite hacer operaciones de lectura, escritura y borrado.
• HTTP Binding: Este componente nos permite leer o enviar cualquier tipo dato a través de una conexión HTTP.
• JMS Adapter: Adaptador que nos permite recuperar y encolar mensajes en una Cola(Queue) JMS. Les comparto una entrada que habla de las Colas JMS.
• Web Services: Uno de los mas usados y sirve para exponer un webservice o comunicarse con algún WebService externo.
• MQ Adapter: Bastante parecido al JMS Adapter pero este sirve para comunicarse con el proveedor MQ que le pertenece a IBM, Aun que al final sigue las especificaciones de JMS.

Por lo pronto lo dejo hasta aquí, mas adelante estaré publicando entradas para cada componente.

The post SOA Suite – Componentes de una Composición SOA 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.