Los Web Services son la manera más sencilla de integrar 2 sistemas sin tener que preocuparse por la compatibilidad ente plataformas y/o lenguajes de programación. Lo único que se necesita es disponer o en su caso generar el archivo WSDL(Web Services Definition Language) y un entorno que permita "consumir" web services.
En este tutorial veremos cómo podemos configurar un Business Service en Siebel y generar el archivoWSDL para su posterior uso en una aplicación externa (el uso del archivo WSDL será tratado en otro post).
Como ejemplo vamos a considerar una función en Siebel que devuelva el nombre completo a partir de 2 parámetros de entrada: Nombre y Apellido.
El primer paso es crear a través de Siebel Tools un nuevo proyecto llamado "ABPWebServices".
Paso seguido creamos un nuevo Business Service "WSAutana" con la clase CSSService y dentro del proyecto "ABPWebServices". Muy importante marcar/activar los siguientes checks:
- External Use
- Service Enabled
- Web Service Enabled
Añadimos un nuevo método WSPrueba con dos parámetros de entrada Nombre y Apellido y uno de salida FullNombre. La lógica del método será muy simple en nuestro ejemplo y básicamente concatenamos los valores de los dos parámetros de entrada y devolvemos el resultado obtenido a través del parámetro de salida.
function WSPrueba (Inputs, Outputs)
{
try
{
var sNombre;
var sApellido;
var sFullNombre;
sNombre = Inputs.GetProperty("Nombre");
sApellido = Inputs.GetProperty("Apellido");
sFullNombre = sNombre + " " + sApellido;
Outputs.SetProperty("FullNombre", sFullNombre);
}
catch(e)
{
Outputs.SetProperty("FullNombre","Hay un error en Siebel");
}
}
Una vez creada la lógica que queramos, bajamos el servicio Siebel Server, compilamos el business service "WSAutana" y levantamos el servicio de nuevo.
Hasta este punto tenemos nuestro business service creado y compilado. Solo falta darlo de alta como servicio web de tipo Inbound y generar el archivo WSDL correspondiente.
Para ello necesitamos conectarnos a la aplicación con un usuario administrador o cualquier usuario que tenga acceso a la pestaña "Servicios Web".
Ingresamos a la aplicación y desde Mapa Sitio navegamos a la vista Administración - Servicios Web y elegimos la opción "Servicios web de entrada"
En el applet superior creamos un nuevo registro con los siguientes datos:
- Espacio de Nombres : http://siebel.com/asi/
- Nombre : WSAutana
- Estado : Activo
- Comentarios: (el comentario que considera oportuno para identificar o describir el web service)
Guardamos el registro y pasamos al applet de abajo "Puertos de Servicio". Creamos un nuevo registro y damos click en el pick applet del campo "Nombre de business service/Flujo de trabajo".
Se abrirá un applet nuevo con el listado de todos los business services y workflows disponibles. Nuestro business service aunque este activo y compilado no aparecerá en la lista y por lo tanto tenemos que crear un nuevo registro con los siguientes datos:
- Nombre: WSAutana
- Tipo de Implementación: Business Services
- Nombre de business service/Flujo de trabajo: (desplegamos la lista y buscamos nuestro business service "WSAutana")
Guardamos el registro (click en el botón Aceptar), seleccionamos el nuevo business service y volvemos aceptar los cambios.
De vuelta al applet padre "Puertos de servicio" rellenamos los siguientes campos:
- Nombre: WSAutana
- Transporte: HTTP
- Dirección: modificamos la URL que Siebel actualiza por defecto a elegir la opción HTTP en el Transporte. La url debería quedar algo así:
http://autanasiebel/eai_esn/start.swe?SWEExtSource=SecureWebService&SWEExtCmd=Execute&UserName=SADMIN&Password=SADMIN
- Enlace: SOAP_DOC_LITERAL
Pasamos al último applet llamado Operaciones y creamos un nuevo registro. El applet de Operaciones prácticamente describe los métodos que se podrán invocar a través del web services.
En nuestro caso solo tenemos un único método que hemos llamado WSPrueba. Damos click en el campo Nombre visible del método se nos abrirá un pick applet con todos los métodos disponibles elegimos el registro que nos interesa y damos aceptar y guardamos los cambios.
Llegados a este punto ya tenemos preparado en Siebel nuestro Web Service. Vaciamos caché (click en el botón Vaciar Cache en el applet principal) y exportamos el archivo WSDL haciendo click sobre el botón Generar WSDL.
¡Importante! Si guardamos directamente el archivo generado por Siebel veremos que por defecto se guarda con la extensión .xml. No es un error si tenemos en cuenta que WSDL es un lenguaje basado en xml. Sin embargo es una buena práctica abrir primero el archivo generado y paso seguido guardarlo con el nombre que queramos y la extensión WSDL.
