Ver código fuente

<keywords content="keywords">Invocar servicios web, Servicios Web, webservice, Web Service, web service, interfaz, integracion</keywords>&nbsp; __FORCETOC__ <br>

= Invocando servicios externos desde Bizagi  =

== Introducción  ==

Bizagi presenta una capa de integración que permite la integración con sistemas existentes (externos a Bizagi) a nivel de proceso. 

Esta capa de integración cumple con los principios de la arquitectura orientada a servicios (SOA), que permite la invocación de servicios web-based (basados en protolos web), tales como servicios web estándar (SOAP) o servicios REST. 

Estos servicios basados en protocolos web, son disponibilizados como métodos web a través de una URL, ya sea en una ubicación de la red interna (intranet) o en una ubicación externa a la misma (internet). 

El siguiente diagrama ilustra este concepto: <br>[[Image:WS diagram.png|center]] <br>

A través de esta funcionalidad y posibilidad, es posible enviar información de negocio desde un proceso en Bizagi como datos de entrada para la invocación del servicio externo. 

Seguidamente, la información de respuesta de este servicio es automáticamente actualizada en Bizagi (de vuelta en el modelo de datos del proceso). 

El intercambio de información entre Bizagi y el sistema externo, se realiza a través de XML estándar. De esta manera, la integración es posible de manera independiente de la plataforma o tecnología, o el lenguage de programación utilizado en la implementación del servicio basado en protocolos web. 

Para configurar ya sea una invocación a un servicio web SOAP, o una invocación a un servicio REST, Bizagi ofrece el asistente gráfico para una configuración rápida, sin la necesidad de programación! 

Tenga en cuenta que Bizagi también permite configurar una integración a nivel de datos (hacia un repositorio existente). 

Vea mayor información sobre los posibles [[Integracion|<u>tipos de integración</u>]] en un proyecto Bizagi. 

<br>

== Acerca del asistente de interfaces  ==

El asistente de interfaces se activa desde el paso 6 del asistente de proceso, y éste presenta 4 pasos guiados para la configuración de la invocación al servicio basado en protocolos web. 

Dicho asistente, provee opciones adicionales para incluir ajustes manuales a las transformaciones XML (para usuarios avanzados), y provee soporte a los 2 tipos de invocaciones: de servicios Web SOAP, o de servicios REST. 

Si desea consultar la información relacionada a la invocación de servicios REST desde Bizagi, revisar el artículo [[Como invocar un servicio REST desde Bizagi|<u>Cómo invocar un servicio REST desde Bizagi</u>]]. 

<br>

== Cómo invocar un servicio web SOAP desde Bizagi  ==

En el siguiente ejemplo y sus secciones, abordaremos cómo invocar un servicio web SOAP desde Bizagi: <br>[[Image:SOAP diagram.png|center]] <br>

<br>

=== Lo que debe hacer en Bizagi  ===

Para configurar la invocación al servicio Web SOAP, se realizan los siguientes pasos: 

1. '''Resolver URL de Servicio Web''' 

2. '''Determinar los parámetros de entrada''' 

3. '''Determinar los parámetros de salida''' 

4. '''Configurar el Manejo de Errores''' 

<br>

=== Ejemplo  ===

En los siguientes pasos , utilizaremos como ejemmplo el proceso de solicitud de vacaciones ("Vacation Request"), en el cual un empleado realiza la solicitud de vacaciones donde se consulta inicialmente el número de dias disponibles con los que cuenta. 

Para esta configuración, ir al paso sexto del asistente de proceso y hacer clic en la opción de Definir interfaces ("Define interfaces"). 

<br>[[Image:SOAInterface Image006.jpg|center|643x517px]]&nbsp; <br>

Una vez que se encuentre en la vista de "definición de interfaces" del proceso, haga clic en la tarea automática donde se invocará el servicio web externo. Nótese que cuando el proceso se muestra desde esta vista (en este paso), solo las tareas de servicio (automáticas) son resaltadas o habilitadas. 

<br>En la imagen a continuación, la tarea automática para el ejemplo es la de "Verificar dias disponibles" (Verify Available Vacation Days), en la cual Bizagi obtendrá del sistema externo, ese número de dias vacacionales para el empleado. 

<br>[[Image:SOAInterface Image007.jpg|center|634x229px]]<br><br>

Al hacer clic en la tarea automática, el asistente de interfaces se abrirá. 

Para una guía más detallada sobre el uso de este asistente, referirse al [[Ejemplo Usando el Ayudante para Invocar Servicios Web|<u>ejemplo usando el asistente para invocar servicios web</u>]].&nbsp;<br>

==== Resolver URL de Servicio Web ====

En este primer paso la URL del servicio web se especifica, y se selecciona el método a invocar. 

<br><br>
<div align="center">
{| class="MsoNormalTableNota" border="1" cellspacing="0" cellpadding="0" width="431"
|-
| valign="top" width="100%" | 
<span>'''Nota:''' Para esta configuración desde el asistente de interfaces, primero seleccionamos SOAP como el tipo de servicio: 
[[Image:SOAP servicetype.png|center|350px]] 
</span>

|}
</div>
<br>

<br><br>[[Image:SOAInterface Image001.jpg|center|700px]] <br>

==== Determinar los parámetros de entrada ====

Para cada uno de los parámetros requeridos para establecer comunicación con el sistema externo, el ayudante&nbsp;desplegará las opciones para obtener esta información del modelo de datos usando XPATH.&nbsp;<br>

<br>

[[Image:SOAInterface Image002.jpg|center|661x459px]] 

<br>

Nótese que existen mas posibilidades para facilitar el mapeo en las [[Funciones y opciones avanzadas para el mapeo de datos usando web services|<u>funciones y opciones especiales para el mapeo de datos usando servicios web</u>]]. <br>

<br>

==== Determinar los parámetros de salida ====

Dependiendo en el tipo de datos retornado en el Método Web, es posible guardar la respuesta en un XPath dado. 

<br>[[Image:SOAInterface Image004.jpg|center|621x430px]] 

<br>

Nótese que existen mas posibilidades para facilitar el mapeo en las [[Funciones y opciones avanzadas para el mapeo de datos usando web services|<u>funciones y opciones especiales para el mapeo de datos usando servicios web</u>]]. <br>

==== Configurar el Manejo de Errores ====

Para una interface, al menos tiene configurarse qué hacer si la invocación del servicio Web falla. Adicionalmente existe la posibilidad para validar y respuesta de error, y configurar una acción, dependiendo de la variable que el servicio Web retorne.<br>

<br>

[[Image:SOAInterface Image005.jpg|center|573x397px]] 

<br>
<div align="center">
{| class="MsoNormalTableAlert" border="1" cellspacing="0" cellpadding="0" width="432"
|-
| valign="top" width="100%" | 
'''<span lang="ES-CO">Alerta: </span>'''<span lang="ES-CO">Bizagi guarda la configuración de su invocación y el mapeo, incluso si después se cambia el método del web service (su firma de definición tiene parámetros diferentes o nuevos). De igual manera, se recomienda revisar la configuración de invocación de su servicio web y revisar la asignación de los nuevos parámetros. </span><span lang="ES-CO">.</span>

|}
</div>
<br>

== Temas Relacionados y Avanzados  ==

*[[Ejemplo Usando el Ayudante para Invocar Servicios Web|<u>Ejemplo Usando el Ayudante para Invocar Servicios Web</u>]] 
*[[Opciones Avanzadas para Invocar un Servicio Web|<u>Opciones Avanzadas para Invocar un Servicio Web</u>]] 
*[[Administracion de Interface|<u>Administración de Interfaces</u>]] 
*[[Capa SOA|<u>Interacción con Bizagi vía SOA</u>]] 
*[[Como integrar Bizagi con telefonos inteligentes|<u>Integración de Bizagi con teléfonos inteligentes</u>]] 
*[[Funciones y opciones avanzadas para el mapeo de datos usando web services|<u>Funciones y opciones especiales para el mapeo de datos usando servicios web</u>]]

<comments />