Exponiendo Servicios REST con JSON usando SOA Suite 12c

Hay dos tipos de Servicios Web: SOAP y REST. Por lo general, en el día a día con Oracle SOA Suite nos ocupamos de los servicios web SOAP, pero también se pueden crear servicios web RESTful.

Los servicios web RESTful están diseñados para funcionar mejor en la Web. REpresentational State Transfer (REST) es lo que sus siglas significan y es un estilo arquitectónico. En REST, los datos se pueden transmitir a través de una interfaz estandarizada (como HTTP).

Enviar Correos Electrónicos HTML Con SOA Suite 12c Usando El Adaptador UMS

Algo muy requerido hoy en día es la necesidad de notificar sobre alguna advertencia y/o errores en la ejecución de un proceso (sea OSB o BPEL) por medio de envío de correos electrónicos a quienes se encargan de solventar estos incidentes.

Esto es posible gracias al Adaptador UMS que provee SOA Suite 12c, haciendo que lograr esto no resulte tan complejo ni caotico.

Configurar GMail como proveedor de correo para SOA Suite 12c

Sobre este tema, en internet ya hay muchos artículos bien elaborados. He pedido prestado al menos una docena para entender lo que debería suceder y para que funcione. Los encontrará listados al final del articulo en la sección recursos.

Todo comenzó cuando traté de que el Adaptador UMS envíe un correo electrónico. La configuración del driver de correo electrónico se realizó en la EM Console (ver a continuación) pero por desgracia WebLogic me arrojó un error bastante peculiar:

JDeveloper 12.2.1.2.0 - "Unable to package module" Fix

Una de las necesidades de hoy en día es migrar codigo de una versión de SOA a otra (ya sea por ejemplo, pasar de 11g a 12c.... o incluso dentro de una misma release en diferentes versiones de liberación, es decir, pasar de un codigo hecho en JDeveloper 12.1.3 a codigo 12.2.1.2.0). Muchas veces es cuestion de un par de clics y ya todo esta funcionando.

A pesar de ello, ultimamente ha frecuentado en la comunidad un error poco descriptivo y critico que impide a un desarrollador poder compilar una aplicación composite en un JAR para luego poder deployarlo en un ambiente SOA. Aca te mostramos como solucionarlo de raiz y algunos trucos para salir del paso.

Introducción al Adaptador LDAP - SOA Suite 12c

En las empresas, los servidores LDAP se utilizan a menudo para almacenar credenciales y grupos de usuarios y compartirlos entre aplicaciones. Oracle SOA Suite 12c introduce un nuevo adaptador. El Adaptador LDAP (o LDAP Adapter) que permite una fácil integración con los servidores LDAP. En este articulo se mostrará una guia rápida y fácil en la instalación de un servidor LDAP y navegador (ApacheDS y Apache Directory Studio). También se describirá la configuración requerida para usar el LDAP Adapter y proveer un ejemplo a través de un proceso BPEL que permita la creación de nuevos usuarios en el servidor LDAP ApacheDS mediante llamadas a webservice.

Referencias de WebServices y uso de Config Plan - BPEL 12c

Con SOA Suite 12c puedes utilizar adaptadores SOAP en tu aplicación (composite) y utilizar un Config Plan para cambiar los endpoints (referencias), de modo que pueda funcionar en otros entornos (como producción o test).

Esto es util ya que como regla general uno como desarrollador no puede modificar el contrato de un proveedor. Solo se nos permite crear un Wrapper y poner alli las modificaciones o hacer uso de un Config Plan que cambie aquellos datos que precisamos.

FTP Adapter en SOA 12c - Dejar archivos en servidor

    Es una practica habitual hacer uso de un adaptador de este tipo. En la mayoria de proyectos y escenarios del mundo real es comun la necesidad de dejar un archivo (cualquiera sea) en una ruta especifica dentro de un servidor FTP.

En este articulo se pretende resolver varios de los conceptos para aprovechar y así tenerlos más claros para poder entender un poco la logica que hay detrás de todo esto.

Por ende, si eres uno de esos desarrolladores en busqueda de algo sencillo y practico... este articulo es para ti!.

Como eliminar WS-Headers en BPEL 12c

    En Oracle SOA Suite 12c, el componente WS-Binding suele incluir alguno de los siguientes elementos de direccionamiento (llamados WS-Addressing) en el Header del Mensaje SOAP:

    • wsa:To

    • wsa:Action

    • wsa:MessageID

    • wsa:RelatesTo

    • wsa:ReplyTo

Aunque el mensaje SOAP generado por la SOA Suite es totalmente compatible con las especificaciones de un mensaje SOAP, existen implementaciones por parte de los proveedores de servicios que no entienden estos encabezados de direccionamiento (WS-Addressing) cuando se incluyen en el mensaje  de solicitud (request) para operaciones síncronas. Es por esto que la invocación a los web service falla.

Logear SOAP Envelope de los mensajes Request y Response en BPEL 12c

En este articulo se explicará como obtener y logear los mensajes SOAP intercambiados con un Web Service desde SOA BPEL 12c.

Por alguna razón, BPEL en sí no posee una actividad "Log" como en el caso de OSB. Por ende, debemos recurrir a otras estrategias a la hora de logear mensajes en composites SOA.

Adicionalmente, es importante remarcar que los atributos bpelx:inputHeaderVariable y bpelx:outputHeaderVariable de una actividad invoke/receive en un BPEL, permiten agregar o recuperar SOAP Headers personalizados a un mensaje SOAP intercambiado con un Web Service.

Spring Adapter SOA 12c - aprende a usarlo!

 

Hace unos días, se precisaba una funcionalidad de negocio para validar un número a través de un proceso particular usando Java. Se podria utilizar Java Embedding en el proceso BPEL, pero hay formas más elegantes de hacer esto, ya que no se desea contaminar la capa de orquestación con funcionalidad de negocio. Una forma más agradable y elegante, en mi opinión, es hacer uso del adaptador Spring. Al utilizar este componente, se puede exponer un Java Bean tan simple como se lo haría llamando a otro webservice. De esta manera la funcionalidad del negocio se puede empaquetar en un .JAR más bonito que se podria también probar por separado del resto del composite. Veamos cómo funciona todo esto:

Formatos para función xp20:format-dateTime() BPEL 12c

Una situación que suele ocurrir bastante a menudo, es establecer un formato específico para la fecha y la hora en un elemento dentro de un Proceso BPEL, y puede resultar algo tedioso no tener a mano una referencia para armar dicho formato mas rapido y de manera sencilla.

A continuación se expone las tablas de referencia para los distintos formatos posibles:

CSF Key - Pasar credenciales dinámicamente a un Web Service en BPEL 12c

Un requisito muy frecuente en estos ultimos tiempos ha sido el proceso de pasar credenciales dinamicamente a llamadas de Web Services externos dentro de un proceso BPEL. Esto conlleva a hacer uso de CSF Keys en los composites SOA pero el reto verdaderamente esta en como usar estas CSF Keys desde SOA a travez del Proceso BPEL. Y por tanto, la magia reside en pasar dichas credenciales de forma separada.

Oracle Sales Cloud Adapter en BPEL - SOA 12c

En este articulo se abordará el uso del Adaptador para Oracle Sales Cloud en una aplicación SOA 12c con BPEL.

Lea este documento para conocer acerca de como crear un Adaptador que se comunique con los servicios que expone Oracle Sales Cloud desde un proceso BPEL que sea ejecutado desde un SOAP Service.

Encuestar una Tabla de Base de Datos usando SOA 12c (Database Adapter - Poll New Records)

Recientemente estuve realizando pruebas de concepto (PoC - Proof of Concept) sobre está característica que posee el Database Adapter para encuestar una tabla de base de datos en especifica a la espera de nuevos registros o registros que cumplan con una condición especifica.

En el presente articulo, se pretende detallar la prueba de concepto llevada a cabo, explicando cada paso para entender bien el funcionamiento de esta característica.

Programar (Cron) Web Services con Enterprise Scheduler Service (ESS) 12c

La Suite SOA 12c de Oracle añade un nuevo componente: Oracle Enterprise Scheduler Service (ESS). ESS proporciona la capacidad de ejecutar diferentes tipos de trabajos distribuidos a través de nodos en un clúster de Oracle WebLogic Server. Oracle Enterprise Scheduler Service ejecuta estos trabajos de forma segura, con alta disponibilidad y escalabilidad, con balanceo de carga y proporciona una monitorización y gestión a través de la Enterprise Manager (EM) Console.

ESS estaba disponible como oferta de productos Fusion Applications. Ahora está disponible en la SOA Suite 12c.

En el presente documento se pretende demostrar cómo utilizar esta nueva extensión de Oracle para la Planificación de tareas, en la SOA Suite 12c para enviar una solicitud de trabajo (Job) ESS de un Web Service.

Eliminar Archivo usando File Adapter en OSB 12c

En algunos casos, se puede llegar a precisar eliminar un archivo desde OSB en un flujo (Pipeline). Esta caracterísitca no está soportada por el asistente gráfico (wizard) del File Adapter en JDeveloper 12c.

Estas opciones para eliminar archivos, no están disponibles en la especificación de interacción
“FileReadInteractionSpec” ubicado dentro del archivo JCA del Adaptador.

Instalar Oracle SOA Suite 12c Quick Start en Ubuntu 14.04+

Muchas veces por distintas razones y en casi la totalidad de los casos, Oracle Fusion Middleware (conocida también por SOA Suite) es instalado en sistemas de tipo UNIX con distintos fines... muy pocas veces se lo instala en GNU/Linux para desarrollar aplicaciones SOA. Todo el contenido presente en este documento es producto del aprendizaje lo que conlleva horas y horas de pruebas y numerosos dolores de cabezas.

Esta guía esta pensada para ser aplicada en sistemas operativos Ubuntu 14.04 o superiores... para explicar todos los pasos y ejemplos se hará uso de la ultima LTS de Ubuntu al momento de escribir este artículo, usaré Ubuntu 16.04 LTS.