Características del mapeo

<< Click to Display Table of Contents >>

Navigation:  Bizagi Studio > Asistente de Procesos > Integrar > Integración con aplicaciones > Conector de servicios Web >

Características del mapeo

Introducción

Para la integración a nivel Proceso en la cual los Procesos de Bizagi invocan servicios externos Web (o servicios REST), se ofrece la posibilidad de utilizar funciones comunes de mapeo y características en su Asistente de configuración de interfaces.

 

Tales funciones incluyen: concatenación de campos o asignación de valores constantes (defecto). Las características de Mapeo involucran comandos de acceso rápido para una configuración amigable y guiada.

 

Estas funciones permiten y facilitan la comparación de datos en la integración, haciedo que Bizagi aplique una transformación para garantizar que ambos sistemas (Bizagi y sistemas externos), tengan un "entendimiento" de los datos intercambiados.

 

Adicional a esto, Bizagi soporta integración con servicios Web utilizando encabezados SOAP.

Para acceder a estas características y funciones de mapeo, utilice el botón de maximizar desde los pasos de configuración de parámetros de entrada o de salida:

 

 

MappingFunctions00_Maximized

 

Funciones y características de Mapeo

Mientras la ventana de mapeo esta maximizada, es posible utilizar nuevos botones y funciones desde la pestaña de Inicio tal como se muestra a continuación:

 

FunctionsFeatures

 

 

Opciones de Mapeo Rápido

Las opciones de mapeo rápido permiten ahorrar tiempo cuando se manejan nultiples entradas o salidas. Estas opciones son:

 

Usar el botón "Mapear todo"

Esta característica configurará un mapeo automático de manera que los campos de la tabla de la izquierda son conectados con sus campos de la tabla de la derecha. Este mapeo se hace de acuerdo a los nombres de los campos (se relacionan aquellos que tengan igual nombre).

 

Usar el botón "Desmapear todo"

Al presionar este botón se removerá el mapeo configurado en todos los campos.

 

Usar el botón "Deshacer"

Al presionar este botón se deshará la última acción realizada.

 

Usar el botón "Rehacer"

Al presionar este botón se restablecerá la última acción anulada.

 

 

Opciones adicionales del Mouse

Las opciones adicionales del Mouse mejoran la usabilidad al utilizar el mapeo gráfico. Estas opciones son:

 

Redimensionar tablas

A lo largo de las opciones de configuración rápida (Mapear todo, desmapear todo, deshacer y rehacer), también es posible cambiar el tamaño de las tablas dando clic en el nombre del sistema externo (el cual se ve como la etiqueta del encabezado de la tabla).

 

Mientras esta seleccionada la tabla, diversos puntos verdes aparecerán para habilitar la edición de su tamaño (utilizando estos puntos verdes para ampliar o reducir la tabla):

 

 

ParameterMapping_advancedMapping_TableSize

 

 

Atributos de Mapeo

Para mapear manualmente un atributo o parámetro de la tabla de la izquierda (datos Bizagi), a un atributo o parámetro de la derecha (sistema externo), usted puede utilizar cualquiera de estas dos opciones: usando clics o usando la funcionalidad arrastrar y soltar.

 

 

Usar clics

Usted puede crear la conexión de mapeo dando clic primero en el atributo o parámetro de la tabla de la derecha. El atributo se resaltará.

 

 

MappingFunctions03_UsingClicks

 

Luego, dé clic sobre el atributo o parámetro de la tabla derecha para dibujar una conexión que representa el mapeo entre estos dos atributos o parámetros.

 

Usar la funcionalidad arrastre y suelte

Usted puede arrastrar una conexión manteniendo el botón izquierdo del mouse pulsado sobre el triangulo saliente del atributo o parámetro de la tabla derecha:

 

MappingFunctions04_DragNDrop

 

Al soltar esta conexión en el triángulo entrante del atributo o parámetro de la tabla derecha, se creará el mapeo.

 

 

Opciones REST

Estas opciones adicionales están disponibles únicamente para tablas en las cuales se ha seleccionado REST como el tipo de servicio para la invocación. Estas opciones REST se brindan para ayudar a la definición y construcción de estructura de las entradas o salidas del servicio.

 

 

Rest2_twitter00_main

 

Las opciones REST presentada en las secciones posteriores se encuentran dando clic en la tabla del servicio REST.

 

 

Para definición manual de la estructura

Cuando se elige crear la definición de la estructura en una forma manual, el primer ítem listado para seleccionar es el de Agregar Nodo Raíz. Esta opción permite iniciar la definición del XML.

 

Agregar Nodo Raíz

Esta opción agrega el nodo raíz a la estructura XML.

 

Para usar esta opción, dé clic en Agregar Nodo Raíz y luego clic derecho en cualquier lugar de la tabla:

 

Rest2_twitter01_addrootnode

 

Dé clic derecho sobre el nodo raíz para mostrar una lista de características asociadas.

 

Rest2_twitter02_addedroot

 

Agregar Nodo de Elemento

Esta característica agregará un elemento como elemento hijo del nodo seleccionado.

 

El elemento añadido se representa inicialmente como un atributo tipo texto con su valor en fuente negra.

 

Una vez este elemento contiene nodos hijos, se representará automáticamente como un nodo.

 

La imagen a continuación muestra los elementos añadidos info1 e info2:

 

Rest2_twitter03_addelements

 

Agregar Nodo de Atributo

Esta característica agregará un atributo directamente bajo el nodo seleccionado.

El atributo hijo añadido se representa como un atributo tipo texto con su valor en fuente azul.

 

Rest2_twitter04_addattributes

 

Renombrar Nodo

Esta característica permitirá renombrar el nodo seleccionado:

 

Rest2_twitter05_rename

 

 

Eliminar Nodo

Esta característica eliminará el nodo seleccionado así como a sus elementos y atributos hijo.

 

Usted necesitará confirmar la eliminación:

 

Rest2_twitter06_delete

 

 

Importar (Para cargar estructura automática)

Cuando se elige proveer la definición de la estructura de manera automática, usted puede importar la definición de respuesta desde un archivo de esquema XSD o un XML o JSON de muestra.

 

Rest2_twitter07_import

 

note_pin

Cualquier estructura definida previamente se eliminará cuando se importa una nueva definición de estructura.

 

Cargar desde XSD

Esta opción cargará la estructura de respuesta desde un archivo .XSD seleccionado:

 

REST_LoadFromXSD

 

Cargar XML de muestra

Esta opción cargará la estructura de respuesta desde un archivo de muestra .XML:

 

REST_LoadFromXML

 

 

note_pin

Cuando se cargue desde un XML de muestra, usted necesitará asegurar que el archivo de muestra no contenga algun caracter XML reservado (como el ampersand "&").

Si estos caracteres reservados se representan como un valor en algún nodo dentro de este archivo, asegúrese que esta contenido dentro de la sección CDATA (de otra manera usted obtendrá el error "An error occurred while parsing... ")

 

Cargar JSON de muestra

Esta opción cargará la estructura de respuesta desde un archivo de muestra .JSON:

 

REST_LoadFromJSON

 

 

Exportar

Una vez cargada la estructura, usted puede guardar esta definición para usos futuros.

 

Rest2_twitter09_export

 

Exportar a XSD

Esta opción guardará la estructura de respuesta actual como un archivo .XSD:

 

REST_ExportXSD

 

 

 

Encabezados SOAP

Mientras se invocan servicios web, frecuentemente se requiere enviar información que no esta relacionada a datos del proceso por si mismos, tales como información de autenticación para validar que el usuario invocando el servicio posea la autorización adecuada. Para estos casos, es útil enviar esta información dentro de un encabezado SOAP (en el protocolo de mensaje SOAP).

 

Es necesario que la definición y creación de ese servicio web cubra específicamente los datos esperados en el encabezado del mensaje. Bizagi soporta el envío de datos en el encabezado SOAP, así como la recepción desde este encabezado con un manejo descomplicado. Para hacer esto, simplemente mapee las conexiones requeridas (entrantes o salientes según aplique) desde los campos correspondientes en Bizagi.

 

Por lo tanto, Bizagi reconoce si un servicio Web espera cierta información en el encabezado. El Mapeo de los datos involucrados para esta integración se especifica de la misma manera que con los datos desde un método de servicio Web.

 

 

700px-ParameterMapping_advancedMapping_SOAPHeaders1