Archive

Archive for the ‘SOA / BPM / WebCenter’ Category

Servicios REST: Uso de parámetros en URI y payload

Muchas veces, al diseñar o usar servicios REST externos, nos encontramos con que, a parte de los parámetros del payload, requieren de parámetros en la URI, como el caso común de versionado de los servicios. Un ejemplo de ello sería el siguiente servicio: http://localhost:7001/empleados/{version}/actualizacion/ donde, a parte de los datos del empleado a actualizar, necesitamos informar de la versión del servicio REST.

La versión 12c del Bus de Oracle nos permite configurar estos servicios destinados a mapear uno de los parámetros de entrada del servicio como parámetro de la cabecera. Con ello ya podremos invocar al servicio correspondiente con el payload adecuado, y el objeto json para la actualización de los datos del empleado no tiene por qué contener el valor de la versión del compuesto.

A lo largo del siguiente ejemplo, iremos descubriendo como mapear estos parámetros y configurar el servicio de forma dinámica.

El primer paso sería la generación de un nuevo proyecto.

Seleccionamos Service Bus Project:

Le pondremos como nombre ServicioRestEjemplo y pulsaremos en Finalizar.

Una vez generado el proyecto, configuraremos el servicio REST al que invocar. Para ello, desde el composite, con botón derecho en External Services generamos un binding REST.

Leer más…

Librerías XQuery sobre Oracle Middleware versión 12c

Hasta la versión 11g de Oracle Service Bus (OSB) no se podían usar librerías XQuery en nuestras soluciones OSB. Esto hacia que tuviéramos que reescribir nuestras funciones XQuery, una y otra vez, en cada transformación XQuery que desarrolláramos o que tuviéramos que usar funciones XPath personalizadas con su correspondiente desarrollo en Java y reinicio del servidor; tal y como nos explicaba Antonio Molina en este post.

2209436Con la llegada de la versión 12c de Oracle Middleware esto ha cambiado, ya que en esta nueva versión se da soporte a este tipo de librerías. Con ello, podemos disponer de una batería de funciones customizadas en una librería XQuery que podremos usar desde cualquiera de nuestras transformaciones XQuery. Eso sí, estas funciones no pueden ser usadas directamente desde un proceso OSB, sino sólo usadas por transformaciones XQuery.

Generación de una librería XQuery

Para la generación de una librería XQuery, necesitamos que nuestro proyecto de JDeveloper sea un proyecto OSB o SOA. Una vez cumplimos estas premisas, seleccionaremos “XQuery Library” en la galería de componentes a generar (File -> New):

1

Posteriormente se abrirá un formulario para que insertemos las características de nuestra librería. En él debemos inserta el nombre, namespace y definir una función inicial para nuestra librería.
En nuestro ejemplo, generaremos una función que nos indique la edad de una persona a partir de su fecha de cumpleaños. Leer más…

Configuración de envíos y recepción de documentos en Oracle B2B

Oracle B2B es un componente de Oracle SOA Suite que permite el intercambio de distintos tipos de ficheros entre distintos participantes de forma segura. Este componente no sólo se encarga del envío/recepción de documentos sino que aporta otras funcionalidades como: definición de documentos, validación, traducción, enrutamiento y seguimiento de los mismos mediante informes. Por otro lado, Oracle B2B permite el envío de mensajes a través de distintos protocolos: Oracle AQ, JMS, File, FTP, FTPs, sFTP, HTTP, HTTPs, SMTP, IMAP, POP3, MLLP, TCP/IP.

A continuación vamos a configurar una interacción entre Oracle B2B en SOA 11g y Oracle B2B en SOA 12c. Desde B2B SOA 11g la compañía avanttic (192.168.56.1:7011) enviará un fichero de texto plano a la compañía CompanyA que utiliza B2B SOA 12c (192.168.56.2:7101). Para ello realizaremos los siguientes pasos en ambos dominios:

  • Definición del documento.
  • Creación de un canal de recepción.
  • Configuración de los participantes en la transacción.
  • Creación y despliegue de acuerdos entre los participantes.
ima1

Configuración del envío desde avanttic a CompanyA en un dominio Oracle B2B SOA 11g

imag2

Configuración de una recepción en CompanyA con emisor avanttic en un dominio Oracle B2B SOA 12c

 

Paso 1: Definición del documento

Para enviar o recibir un documento en Oracle B2B es necesario crear una definición del mismo, que detalla el formato del mensaje. La definición del documento comprende: la selección de un protocolo de documentos, la creación de un nuevo documento, un tipo de documento y una definición del mismo. Oracle B2B proporciona distintos protocolos de documentos como EDIFACT o HL7.

En este ejemplo vamos a enviar un documento sin un formato específico, es decir, un documento binario. Para ello, crearemos la definición dentro del protocolo de documentos Custom, con una nueva versión llamada 1.0, tipo de documento TestDoc y definición de documento TestDefinition:

  1. B2B – Pestaña Documentos – Protocolo de documentos: Custom.
  2. Desde el protocolo CustomNuevo Documento: 0.
  3. Desde el documento 0Nuevo Tipo: TestDoc.
  4. Desde el nuevo tipo de documento – Nueva Definición: En este apartado definiremos el formato del fichero, en este caso indicaremos que los tres primeros caracteres del mensaje deben ser: “ABC”.
img3

Definición del documento en ambos dominios

Leer más…

Oracle WCC “Checkout and Open” al editar documentos de Office

En Oracle WebCenter Content (WCC), antes llamado Universal Content Management (UCM), disponemos de una opción que permite editar un documento Office en línea de forma nativa.

checkoutandopen-1-http

Al seleccionar la opción Edit, un componente Activex lanza el software de Office, descarga el documento del gestor de contenidos en el equipo local (checkout and open) y, tras editarlo, al guardarlo lo sube ya modificado al gestor de contenidos (checkin).

Esta funcionalidad presenta problemas en algunas instalaciones, en la release 7.3.5.185 por ejemplo, ya sea por permisos en el equipo local o por configuración del server o por ambas condiciones.

Una solución a este problema consiste en el siguiente procedimiento, que consta de 3 fases:

1. Registrar el Activex manualmente en los equipos “cliente”

Para lo cual puede seguir el procedimiento de este enlace o el similar que describimos a continuación:

1.1. Obtener el Activex del Server

<Middleware-home>/Oracle_ECM1/.../checkoutandopen.cab     para clientes de 32 bits
<Middleware-home>/Oracle_ECM1/.../checkoutandopenx64.cab  para clientes de 64 bits       

1.2. Extraer del cab CheckoutAndOpen.dll y copiarlo al sistema: C:\Windows\System32

1.3. Registrarlo, usando una ventana de comandos en modo Administrador

> cd C:\Windows\System32
> regsvr32 CheckoutAndOpen.dll 

Leer más…

Activar Web Services Test Client para Oracle SOA Suite 12c en modo Producción

Por defecto la instalación de Oracle SOA Suite 12c en modo Desarrollo trae desplegada y activada la aplicación Web Services Test Client, útil para realizar pruebas de determinados servicios/aplicaciones propias de la SOA Suite o desarrolladas por nosotros.

Pero no es así cuando realizamos la misma instalación en modo Producción: la herramienta viene por defecto desactivada y es necesario realizar una serie de pasos para desplegarla y activarla.

Si no tenemos activada la herramienta y recibimos un mensaje de error HTTP 404 cuando intentamos acceder por ejemplo a la url: http://host:puerto/ws_utc

404

  1. Necesitaras dos pestañas abiertas en un navegador (o dos navegadores distintos): la consola de Administración de Weblogic y la consola de Control de Fusion Middleware.
  2. Desde la consola de Administración (Adminserver) Crear una sesión de cambio mediante el botón “Lock & Edit”.
    lockEditlockEdit2
  3. Desde la consola de Control de Fusion Middleware 12c (/em), pinchar con el botón derecho en el nombre del dominio que se quiera modificar -> Administration -> General Settings -> abrir la sección de configuración avanzada (Advanced section) y seleccionar el check de “Enable Web Service Test page”.
    GeneralSettings
    EnableWebServices

    Confirm
  4. Vuelve a la consola de Weblogic, refresca la página pulsando F5 y verás que el botón de cambios cambia mostrándote la opción de Activar cambios, actívalos.activate
  5. Reinicia los nodos manejados y el Adminserver de la forma convencional.
  6. Ya debes de tener disponible Web Services Test Client para hacer uso de la consola de pruebas y demás funcionalidades en tu servidor en modo Producción (http://host:puerto/ws_utc).deployingWS
    wstc

Comparativa diferentes Enterprise Service Bus (I) – Número de búsquedas en Internet

Recientemente hemos realizado una comparativa sobre los ESBs (Enterprise Service Bus) más destacados en la actualidad. Para iniciar el estudio, nos ha ayudado realizar una búsqueda con Google Trends para establecer una línea base temporal sobre los ESBs objeto del estudio:

  • JBoss Fuse
  • Mule ESB
  • Oracle Service Bus (OSB)
  • Talend ESB
  • WSO2 ESB
ESB Trends 2015

Comparativa Google Trends 2015

De esta comparativa se pueden extraer a primera vista las siguientes conclusiones:

  1. Mule ESB es el bus que lleva más tiempo en el mercado (seguido por Oracle Service Bus).
  2. Tras la aparición de OSB, rápidamente se equiparó en uso y en popularidad con el bus de Mule
  3. WSO2 ESB y JBoss Fuse (dos ESBs open-source puro) llegaron al mercado más tarde pero cogen popularidad rápidamente equiparándose al resto.
  4. Talend ESB se mantiene por debajo (en uso) del resto.

Es necesario destacar que Google Trends es una herramienta de representación numérica/histórica del volumen de búsquedas hechas en Google. Basa su análisis en el impacto que tienen los artículos publicados sobre una temática en cuestión.

Iré publicando varios posts en los que presentaré diferentes aspectos estudiados en la citada comparativa realizada para uno de nuestros clientes.

“Data Source: Google Trends (www.google.com/trends).”

Categorías:SOA / BPM / WebCenter Etiquetas: , ,

ESADE: Oracle BPM migration from version PS3 to PS5

avanttic ESADE BPM Success Story

El 28 y 29 de abril se celebró en Barcelona un nuevo encuentro de Oracle EMEA WebCenter Partner Community Forum, focalizado en Customer Experience and Mobility mediante la combinación de Oracle WebCenter (Portal, Content, Sites), BPM y ADF.

avanttic asistió, presentando un caso de éxito con ESADE sobre el proyecto realizado hace unos meses de migración de BPM de PS3 a PS5. La organización imprimió a tamaño póster los casos de éxito presentados por los partners y los colgó en las estancias del hotel.

ESADE solicitó a avanttic actualizar su plataforma Oracle BPM, sobre nuevos servidores, para solucionar los problemas de caídas del sistema y por la necesidad de mejorar el rendimiento de la plataforma. La migración a una nueva versión de Oracle ADF también ha permitido una mejor compatibilidad con las últimas versiones de los navegadores.

The ESADE business are the students and the Academic Management is based in Oracle architecture that provides high availability, redundancy and business continuity. We stabilized the platform and now we can develop new business processes and new BPEL integrations over a robust platform.

Miguel López, CTO, TIC Departament

Lee los detalles del proyecto en el datasheet del caso de éxito (formato pdf).

avanttic fue el primer partner de España en obtener las certificaciones en Oracle ADF y en Oracle BPM, en diciembre del 2011 y en mayo del 2012, respectivamente.