BBuussiinneessss AAggiilliittyy!!

MMaannuuaall ddeell TTaalllleerr BBaassee PPlluuss

Business Agility!

2

Taller

TALLER: BASE PLUS es una entidad prestadora de servicios y ayudas de carácter financiero que ha iniciado su estrategia de BPM y ha escogido BizAgi para llevarla a cabo. Usted ha sido seleccionado para implementar el proceso de Solicitud de Productos, el cual se describe a continuación.

En las siguientes páginas encontrará la información sobre el proceso y los datos que necesitan ser controlados y visualizados durante el mismo. Siga las instrucciones de esta guía, teniendo en cuenta siempre la explicación del instructor.

DESCRIPCIÓN DEL PROCESO

Propósito: Ofrecer servicios de ayuda financiera a los clientes de acuerdo con los productos que estos requieran, obteniendo el menor riesgo y la mayor rentabilidad para la Entidad.

En el proceso “Solicitud de Crédito” participan las siguientes áreas funcionales:

Asesores: grupo de personas encargadas de interactuar con el cliente, de capturar los productos que el cliente requiere; así como de consolidar toda la información financiera del cliente.

Área de análisis de solicitudes: grupo de personas responsables de hacer el análisis de los productos solicitados por el cliente con base en el monto de la solicitud, plazos de pago propuestos y los datos financieros.

Operaciones: área encargada de entregar los productos aprobados de cada solicitud.

Solicitud de Productos

El proceso inicia cuando el asesor registra los datos básicos del cliente en el sistema, (Nombre Completo, Tipo de Identificación, Número de Identificación, Teléfono, Dirección, Ciudad, País, otros datos básicos y la Información financiera). Una vez registrados los datos, el asesor le informa verbalmente al cliente cuales son los tipos de productos ofrecidos por la entidad e ingresa al sistema los productos solicitados (en una solicitud se pueden incluir varios productos financieros). Adicionalmente, el sistema calcula el valor potencial de endeudamiento, el valor pre-aprobado, de acuerdo con la ocupación del solicitante. A continuación, el asesor le entrega una carta al cliente en la cual se le indica el consolidado de productos, los valores y plazos solicitados, además de otros datos que servirán de soporte escrito del registro de la solicitud.

Una solicitud puede o no requerir un análisis adicional, esto dependerá de si el monto total solicitado (la suma de todos los productos incluidos) excede el tope máximo fijado por las políticas de la entidad o excede el valor pre aprobado para el cliente. En caso contrario, la solicitud será pre-aprobada automáticamente.

Si la solicitud requiere análisis adicional, el proceso continúa al subproceso de Análisis, donde se realizará la consulta del cliente en las Centrales de Riesgo y posteriormente un analista revisará la información de la solicitud y de la consulta para aprobar o no cada producto. En caso de que la solicitud tenga algún producto aprobado o la solicitud haya sido pre aprobada se entregan los productos con lo cual se finaliza el proceso de forma exitosa.

En caso contrario, se continúa el proceso enviándole una notificación formal al cliente para informarle sobre la no aprobación de la totalidad de su solicitud.

Business Agility!

3

Taller

Adicionalmente, es importante tener en cuenta que el proceso podría ser cancelado en cualquier momento después de registrados los productos de la solicitud; razón por la cual existe un evento manual de cancelación el cual permite capturar los comentarios o razones por las cuales se realiza la cancelación del caso.

Políticas Generales

Una solicitud puede contener uno o varios productos de diversos tipos y cada uno con sus valores y plazos correspondientes.

Si el total de productos de una solicitud excede el valor pre-aprobado para el cliente o el valor máximo establecido por gerencia (50 mil), la solicitud requiere de análisis por parte de un analista (aprobación independiente de los productos solicitados), de lo contrario los productos se aprueban automáticamente.

La entrega de los productos aprobados se realiza de manera conjunta; no producto por producto.

IMPORTANTE: En todos los casos propuestos para el taller, identifique previamente los elementos y componentes de BizAgi a utilizar para cumplir con cada objetivo parcial propuesto o en su defecto busque la orientación del instructor.

Business Agility!

4

Taller

PASO 1: DIAGRAMACIÓN DEL PROCESO

EJERCICIO: Después de la explicación sobre cómo crear un proceso y en particular del caso del taller, por favor diagrame los procesos en BizAgi.

Estando en el Modelador de Procesos de BizAgi puede crear o modificar el proceso. Recuerde que todo proceso debe tener un área funcional y por lo menos una fase. Cuando haya terminado, guarde el proceso, cierre la ventana y en BizAgi Studio en el componente de aplicaciones, en la opción de procesos haga clic derecho sobre la versión del proceso y elija la opción de Check –In (Desbloquear) para que se guarde la última versión del proceso y quede disponible para trabajar sobre el diagrama.

Business Agility!

5

Taller

Propiedades de las actividades y figuras del proceso.

Actividad /Evento /

Descripción Texto asistente Duración

Registrar Cliente Actividad donde se registran los datos básicos y financieros del cliente.

Registre los datos básicos y financieros del cliente.

40 minutos

Registrar Productos

Ingrese los productos solicitados por el cliente

40 minutos

Analizar Solicitud Análisis de la Solicitud con Base en los Valores Suministrados.

Realice análisis basándose en los valores suministrados.

2 días

Entregar Productos Aprobados

Entrega de los productos aprobados al cliente.

Entregue al cliente los productos aprobados.

8 horas

Evento Cancelar Solicitud

Evento manual que permite capturar las razones de la cancelación y cancelar la solicitud.

Capture justificaciones o comentarios de la cancelación.

Evento. N/A.

Subproceso reusable Análisis

N/A. 2 días

Business Agility!

6

Taller

PASO 2: CREACIÓN DEL MODELO DE DATOS DEL PROCESO

EJERCICIO: De acuerdo con el modelo propuesto grupalmente, y la demostración del instructor al respecto, por favor cree las entidades, atributos y relaciones en BizAgi Studio

NOTA: Para los valores de las entidades paramétricas use los valores lógicos que le sean indicados por el instructor.

Business Agility!

7

Taller

PASO 3: CREACIÓN DE LAS FORMAS (FORMULARIOS / PANTALLAS) DEL PROCESO

EJERCICIO: Cree las siguientes formas en las actividades indicadas.

ACTIVIDAD: Registrar Cliente

ACTIVIDAD: Registrar Productos

Business Agility!

8

Taller

Forma asociada a la adición / edición de registros de la Tabla de Productos de la Solicitud: Registrar Productos de la Solicitud

Pestaña Datos de Registro del Cliente / Reutilizar esta pestaña donde sea necesario.

Business Agility!

9

Taller

En esta actividad se debe totalizar la grilla de productos de la siguiente forma:

ACTIVIDAD: Analizar Solicitud

Business Agility!

1 0

Taller

EVENTO: Cancelar la Solicitud

ACTIVIDAD: Entregar productos aprobados

FORMA GLOBAL Y FORMA RESUMEN DEL PROCESO SOLICITUD DE PRODUCTOS

Una Forma Global es la forma asociada al proceso, la cual es visualizada por el usuario registrado en la aplicación cuando consulta un caso en el cual no tiene actividades pendientes, un caso cerrado, o al momento de finalizar el caso.

La Forma Resumen debe incluir la información que el usuario considere necesaria visualizar al dar clic sobre el semáforo de un caso pendiente.

Estas formas requieren ser creadas desde la vista de módulos, en Entidades desde la Entidad de Aplicación de cada Proceso (Para cada Proceso de esta guía asuma que la Forma Global y la Forma Resumen son iguales).

Business Agility!

1 1

Taller

En esta forma no se pueden modificar los registros de las tablas o valores de los datos. Por favor diseñe y construya esta forma, solicite orientaciones al instructor si lo requiere.

VALIDACIONES, COMPORTAMIENTOS Y ACCIONES SOBRE LOS FORMULARIOS CREADOS EN EL TALLER

EJERCICIO: Algunas validaciones son presentadas por el instructor. Por favor intente hacerlas y complete las demás que aquí se presentan. Por Ejemplo: Validaciones de Campos de tipo fecha. Use su lógica para establecer los comportamientos de estos campos.

Actividad Campo Validación / Comportamiento /Acción

Registrar Cliente de la Solicitud

email El campo email debe contener un email válido.

Registrar Cliente de la Solicitud

Gastos Fijos Si los gastos Fijos son superiores a los Ingresos fijos, el campo gastos fijos debe ponerse de color Rojo, de lo contrario debe verse en Morado.

EJERCICIO: Validaciones en Grillas

Actividad Validación en Grillas

Registrar Productos de la Solicitud

Debe existir al menos un registro en la grilla de Productos de la solicitud.

Business Agility!

1 2

Taller

PASO 4: REGLAS Y POLÍTICAS DE NEGOCIO.

EJERCICIO: Por favor cree las siguientes reglas y asígnelas en la figura correcta del proceso.

Llenar automáticamente la fecha de la solicitud. El objetivo es mostrar en la actividad “Registrar Productos” el campo Fecha de la Solicitud con el valor de la fecha actual. Use la expresión DateTime.Now.

Sumar los ingresos y gastos del cliente y asignarle la sumatoria correspondiente a los campos Total Ingresos y Total Gastos.

Calcular el Valor Pre aprobado: (Total Ingresos menos Total Gastos) * Factor Calculo Valor Pre aprobado.

El factor utilizado para el cálculo del valor pre aprobado o potencial de endeudamiento del cliente depende de la ocupación del cliente:

OCUPACIÓN FACTOR CALCULO VR

PREAPROBADO

Estudiante 1

Comerciante 3

Empleado 5

Independiente 3

Pensionado 4

Valor Potencial Pre aprobado de Productos = Factor * (Total Ingresos – Total Gastos)

Tenga en cuenta: el atributo factor se encuentra en la entidad Ocupación.

Política: Se requiere estudiar los créditos de la solicitud cuando el valor total de la solicitud excede el valor establecido por la compañía (50 dólares) o cuando el valor total de la solicitud excede el valor pre aprobado.

Realizar la expresión asociada al flujo de secuencia que determina que la solicitud requiere análisis. (Compuerta Exclusiva “Requiere Análisis la Solicitud?” ).

Expresión asociada al flujo de secuencia que conduce a la actividad “Entregar Productos”. Compuerta exclusiva “¿Algún producto aprobado?”. Tenga en cuenta cuando la solicitud fue pre-aprobada.

Business Agility!

1 3

Taller

Calcular el Valor Real Aprobado de la Solicitud: este valor es el resultado de sumar el campo “Valor” de todos los registros de la grilla “Productos de la Solicitud” que fueron aprobados.

CARTAS Y NOTIFICACIONES

EJERCICIO: Por favor cree la siguiente carta y asóciela a la actividad Registrar Productos:

<Fecha Actual>

Señor:

<Nombre completo del cliente>

Ciudad

Estimado <Nombre Completo del Cliente>,

Por medio de la presente nos permitimos informarle que su solicitud recibida el día <Fecha del día de la solicitud> y con número de creación <Número de creación de la solicitud> está siendo atendida por nuestro personal.

Productos solicitados:

Tipo producto Monto Solicitado Plazo solicitado

Cordial saludo,

BASE PLUS

Notificación Rechazo

EJERCICIO: Por favor cree la siguiente notificación y asóciela a la actividad Notificar la Negación de la Solicitud, dirigida al cliente de la solicitud.

Cuerpo del mensaje:

Business Agility!

1 4

Taller

Señor <Nombre completo del cliente>,

De acuerdo con su solicitud recibida el día <Fecha de la solicitud> y con número de registro <Número de radicación de la solicitud>, lamentamos informarle que ninguno de los productos solicitados fue aprobado.

Productos solicitados:

Tipo producto Monto Solicitado Plazo solicitado

Gracias y hasta una próxima oportunidad,

BASE PLUS

PASO 5: ASIGNACIÓN DE RECURSOS

Organización

Cree los Siguientes Cargos:

Gerente General

o Gerente Comercial

Director Oficina

Asesores

Analista Junior

Analista Senior

o Gerente Operaciones

Director Back Office

Operador

EJERCICIO: Por favor configure en BizAgi las reglas de asignación de las actividades teniendo en cuenta las condiciones descritas a continuación.

ACTIVIDAD PERSONA A ASIGNAR

REGISTRAR CLIENTE

Creador del caso

REGISTRAR PRODUCTOS Creador del caso

CANCELAR SOLICITUD A todos los asesores

ENTREGAR PRODUCTOS APROBADOS Secuencial a cualquier Operador.

ANALIZAR LA SOLICITUD Por Carga al Analista Jr si el Valor total de la Solicitud de crédito es menor o igual a US$60,000 y a todos los Analistas Sr si el Valor Total de la Solicitud es mayor a US$60,000

Cree las siguientes Áreas:

Análisis de Solicitudes

Operaciones

Business Agility!

1 5

Taller

Asesoría de Clientes

Cree los siguientes usuarios

USUARIOS PASSWORD ÁREAS CARGOS

AnalistaJr AnalistaJr Análisis de Solicitudes

Analista de Solicitud Jr

AnalistaSr AnalistaSr Análisis de Solicitudes

Analista de Solicitud Sr

Operador Operador Operaciones Operador de Empaque y Entrega

Asesor Asesor Asesoría de Clientes

Asesor de Cliente

ADICIONAL OPCIONAL

Configuración del portal de trabajo

Para la aplicación se requiere incluir el color corporativo de la entidad: verde y el logo corporativo es el siguiente (recuerde configurar el tamaño de acuerdo al tamaño requerido en la herramienta). Espere las orientaciones del Instructor en este paso.

Business Agility!

1 6

Taller

PARTE II INTEGRACIÓN Y DESARROLLO

1. CREAR LA BASE DE DATOS EXTERNA.

EJERCICIO: Se debe crear la base de datos CRMExternal en su máquina local. Esta base de datos, va a ser utilizada en los talleres de Replicación y Virtualización de datos.

1. Abrir el SQL Server Management Studio 2005 en su máquina local.

2. Desde esta consola, abrir el archivo proporcionado en el CD para crear la base de datos. Este archivo está en la ruta \Insumos\Data\Create_DemoData.sql

3. El archivo es un script que va a crear la base de datos con dos tablas, clientes (Customers) y tipos de producto (Products). Una vez creada, el mismo script llenara la información que vamos a replicar y virtualizar en nuestros talleres.

Business Agility!

1 7

Taller

2. REPLICAR LA ENTIDAD TIPO PRODUCTO

EJERCICIO: En el sistema externo CRMExternal, existe una entidad que contiene los productos ofrecidos. La idea de la práctica, es que los datos de esta entidad queden replicados en BizAgi.

1. El primer paso, es crear el sistema externo en BizAgi. Para esto dejamos el modulo de asistente en BizAgi Studio, y seleccionamos la opción modulos. Dentro de la opción módulos hay un modulo Sistemas. Damos clic en este modulo y procedemos a crear uno nuevo.

2. En las opciones básicas, llenamos la información con nombres relevantes y que podamos referenciar más adelante. Marcamos la opción Habilitar Virtualización y Replicación para este sistema.

Business Agility!

1 8

Taller

3. Luego, seleccionamos el sistema ya creado, y le damos clic-derecho sobre Proveedores de datos (Providers) y seleccionamos Nuevo Proveedor. Nuevamente llenamos la información con datos relevantes. Debemos marcar las casillas Virtualización y Replicación, ya que utilizaremos este sistema para ambas practicas.

4. El siguiente paso, es digitar la información para que BizAgi pueda conectarse con la base de datos externa. Esta conexión se realiza sobre OLEDB, para la cual vamos a crear una metadata. Damos clic en la pestaña Propiedades del Proveedor y luego clic en el botón OLEDB Config. Debemos digitar el nombre del servidor, nombre del usuario de la base de datos(sa) contraseña del usuario, y nombre de la base de datos. Es requerido que este usuario pueda consultar, editar y guardar información sobre estas tablas.

Business Agility!

1 9

Taller

5. Una vez finalizada esta configuración, podemos realizar una prueba de conexión. Para esto vamos hasta Proveedor de datos creado y damos clic-derecho, luego seleccionamos Probar Proveedor (Test Provider). El mensaje debe ser “Test successfully”. De lo contrario, debemos revisar las propiedades OLEDB y asegurarnos que estas sean las correctas. Debemos también revisar que el servidor y la BD estén disponibles.

6. El siguiente paso es, crear el esquema de replicación. El esquema de replicación es como un cronograma, en donde vamos a definir el inicio y frecuencia de la sincronización de los datos. Vamos entonces, hasta el nodo Entidades Replicadas->Default Replication entity y damos clic derecho y seleccionamos Adicionar Esquema de Replicación.

Business Agility!

2 0

Taller

7. Llenamos los datos básicos para nombrar el esquema y luego pasamos a la

siguiente pestaña para configurar el horario y la frecuencia.

Es recomendable en este caso, seleccionar una hora próxima, por ejemplo en 30 minutos, para revisar posteriormente que los datos sean sincronizados. Recordemos que la Replicación de datos ocurre en segundo plano.

Business Agility!

2 1

Taller

8. Hasta el momento, hemos configurado el sistema externo, los parámetros de conexión y el horario de replicación. Ahora, vamos a seleccionar las o la entidad que va a ser replicada bajo este esquema. Para eso, damos clic derecho sobre el esquema que acabamos de crear, y seleccionamos la opción Adicionar Entidad

9. En este punto entonces, seleccionamos la entidad Tipo Producto del combo desplegable, y en la casilla siguiente, digitamos el nombre de la entidad en el sistema externo, que en este caso sería Products. Es recomendable siempre validar los nombres para evitar errores de integridad. La llave de negocio en nuestra entidad BizAgi es Código, por esta razón la seleccionamos y la “pasamos” al lado derecho, indicándole a BizAgi que vamos a sincronizar los registros en base a este atributo.

Business Agility!

2 2

Taller

10. El paso final, es identificar a cada atributo de nuestra entidad en BizAgi, el origen de datos Externo.

Atributo BizAgi Atributo CRMExternal

Código ProductCode

Producto Name

La entidad Externa, tiene los mismos valores que los anteriormente creados en BizAgi, pero contiene 3 registros mas. Esperar la hora de ejecución y revisar que estos datos estén bien sincronizados.

Business Agility!

2 3

Taller

3. VIRTUALIZAR LA ENTIDAD CLIENTE

EJERCICIO: En el sistema externo CRMExternal, existe una entidad que contiene la información de los clientes (Customers). Le idea del taller, es que los datos de esta entidad sean virtualizados en la entidad Clientes de BizAgi. Más adelante en el proceso, se deben crear registros nuevos para verificar que se creen en el sistema Externo. El paso siguiente, será crear un Join Search dentro de la forma de Datos de Cliente para realizar búsquedas desde la forma de bizagi, hasta el sistema externo.

1. El primer paso, es utilizar el sistema externo creado en el taller de replicación. Esta vez vamos a seleccionar la opción Entidades Virtuales (Virtual Entities). Damos clic derecho y seleccionamos Adicionar Entidad Virtual (Add Virtual Entity).

Business Agility!

2 4

Taller

2. Seleccionamos la entidad Clientes, y en el cuadro de texto de fuente externa, colocamos el nombre de la entidad Customers. De nuevo, tenemos que indicar a BizAgi cuál es la llave de negocio, única tanto en BizAgi como en el sistema externo, para que en base a este atributo sincronice los valores. Para este caso, seleccionamos NumeroDeIdentificacion.

3. Ahora, damos clic sobre la entidad y vamos a indicarle a bizagi la fuente

externa para cada atributo de la entidad. Recordemos, que en Virtualización a diferencia de la replicación, no todos los campos de bizagi es necesario virtualizarlos, excepto los que conforman la llave de negocio. Pero si es importante, que los campos que no estén virtualizados, deben ser removidos de la lista. Es por eso, que en la imagen siguiente no están todos los campos de la entidad Clientes.

Business Agility!

2 5

Taller

4. Ejecutemos la aplicación web, y en la primera actividad, creamos un nuevo

usuario digitando la información básica. Luego, damos siguiente a la actividad. En ese momento, BizAgi guarda la información del nuevo cliente en su base de datos, y automáticamente crea el mismo registro en la base de datos externa.

5. Ahora, que ya comprobamos la inserción de datos desde el BPM hacia el repositorio de datos de clientes, vamos a probar las opciones de búsqueda.

Para esto, vamos al editor de formas en BizAgi Studio y abrimos la forma de la primera actividad “Registrar Cliente”.

Luego, vamos a crear un Join Search en esta forma. Un Join Search, básicamente permite realizar búsquedas sobre una entidad en BizAgi, basado en cadenas que el usuario final de la aplicación requiera. Por ejemplo, buscar un cliente por número de identificación o por nombre. El Join Search, realiza este tipo de búsquedas, arroja los resultados en una grilla y el usuario final es quien selecciona cual de los resultados es el que desea incluir. Inmediatamente, BizAgi obtiene los datos del registro seleccionado y los presenta en la forma. Ahora, al ser esta una entidad virtualizada, pues la búsqueda la realiza tanto en BizAgi como en el sistema externo.

Business Agility!

2 6

Taller

Ahora, arrastramos el Join Search y lo ponemos como primer render de esta forma. Vamos a configurarle las características como Display Name. Luego, damos clic derecho sobre el render y seleccionamos la opción Abrir Forma (Open Display Form), en donde vamos a crear una forma con los campos que queremos para realizar la búsqueda sobre la entidad Cliente.

Ahora, arrastramos el Join Search y lo ponemos como primer render de esta forma. Vamos a configurarle las características como Display Name, Data Bindind etc. El origen de datos es Clientes, pero para llegar hasta allá en el modelo de datos, hay que navegar en el modelo de datos así:

SolicitudDeProductos.ClienteSolicitud.Cliente

Luego, damos clic derecho sobre el render y seleccionamos la opción Abrir Forma (Open Display Form)->Nueva Forma, en donde vamos a crear una forma con los campos que queremos para realizar la búsqueda sobre la entidad Cliente : Nombre y Número de Documento.

Business Agility!

2 7

Taller

Colocamos un nombre en la forma (Display Name)y cerramos la edición de la misma guardando los cambios.

Ahora en el render, vamos a indicar que el Atributo para mostrar es Número De Identificación.

Business Agility!

2 8

Taller

Como no es posible mostrar dos veces el mismo atributo en una misma forma, ya que estaríamos duplicando la información y afectando la integridad, vamos a quitar el render anterior que estaba mostrando el Número De Documento. Este paso es obligatorio. Finalmente la forma debe lucir como la imagen siguiente:

Finalmente, vamos a guardar los cambios y a ejecutar la aplicación. Se deben buscar registros de cliente que no estén en BizAgi y si en la aplicación externa, para realizar una prueba completa de búsqueda sobre la entidad externa.

Business Agility!

2 9

Taller

4. CAPA SOA

EJERCICIO: Instalar la aplicación de servicios web de prueba, que vamos a utilizar para integrar en BizAgi. Uno de esos servicios retorna un XML con la estructura requerida por el modelo de datos de BizAgi y adjunta un documento en pdf. El otro servicio, retorna un XmlDocument que tiene su propia estructura, por lo tanto es requerido aplicar una transformación (XSL) entre esta respuesta y una respuesta acorde con el modelo de datos de nuestro proceso en BizAgi.

6. El primer paso, es montar la aplicación de los servicios web en nuestra maquina. Esta se encuentra en \INSUMOS\ESB\WEBSERVICES\*.* . Esta carpeta ESB debe ser copiada a la ruta c:\Inetpub\wwwroot\.

7. Luego, debemos ejecutar el Internet Information Services (Inicio->Panel de Control->Herrr Administr.->Internet Information Services). Este es un servicio de Windows que debe estar instalado en las maquinas como requisito para realizar este taller.

8. Sobre esta consola, vamos a buscar en el lado izquierdo, el directorio que acabamos de copiar, damos clic derecho y configuramos las siguientes propiedades :

En la pestaña Documentos (Documents): adicionamos el documento ESBServices.asmx.

Business Agility!

3 0

Taller

En seguridad de directorios, solamente dejamos anónima, para efectos de estas pruebas.

9. Finalmente, en la pestaña ASP.NET nos aseguramos que este seleccionada la

opción 2.0, el cual indica el framework de .Net sobre el que va a correr los servicios.

Business Agility!

3 1

Taller

Vamos a probar que los servicios estén disponibles. Podemos ejecutar una ventana de Internet Explorer y buscar la aplicación web. La dirección o URL sería algo como:

http://localhost/ESB/ESBServices.asmx

Debemos tener presente esta URL, ya que vamos a necesitarla durante la confirguracion de los sistemas en BizAgi Studio.

EJERCICIO: Vamos a crear un sistema en BizAgi Studio, de igual forma que lo creamos para el taller de Replicación. Pero esta vez, vamos no vamos a seleccionar Virtualización y Replicación, sino Interfaces Para Este Sistema. Dentro de este sistema vamos a crear dos interfaces: una para obtener el archivo pdf con el reporte de un comportamiento financiero de un cliente, y otro con el comportamiento solamente del último mes. Este último, no tiene archivo adjunto.

1. Creamos el sistema en BizAgi

Business Agility!

3 2

Taller

2. Seleccionamos Nueva Interfaz, dando clic derecho en el nodo de Interfaces del sistema.

3. Creamos una interfaz para el método historicalBehaviour

Business Agility!

3 3

Taller

4. Repetimos el proceso, para crear la interfaz del segundo método lastBehavior.

5. Ahora, vamos a trabajar con el primer método o interfaz que configuramos: historicalBehavior.

Vamos a identificar el tipo de interfaz del método historicalBehavior.

Business Agility!

3 4

Taller

Dentro del WSDL podemos ver que el parámetro de entrada idUSer es de tipo string, por lo que podemos navegar en el modelo de datos más adelante para obtener este valor a consultar.

Si realizamos una prueba en nuestra maquina, de este servicio vemos que la respuesta es un archivo XML.

Si observamos el modelo de datos de BizAgi, tenemos que en el proceso de Análisis, la navegación de datos para llegar a crear un registro en la entidad ConsultaClientes es la misma que tiene el XML. Esto es, por que el servicio fue desarrollado solamente para tal propósito. En este caso, no es necesario hacer una transformación de datos entre la respuesta del servicio y BizAgi.

Business Agility!

3 5

Taller

Miremos la siguiente grafica:

Business Agility!

3 6

Taller

Ahora que sabemos los parámetros de entrada y de salida, sabemos que la interfaz no requiere transformaciones, y podemos seguir con la configuración.

6. Ahora, seleccionamos el proceso de Análisis en el asistente (Wizard) de BizAgi y damos clic en el paso 6 Integración en el carrusel. Con el diagrama del proceso abierto, vamos a seleccionar la Actividad Automática Consultar Central de Riesgo.

7. En la pantalla de configuración, podemos digitar un URL o seleccionar uno de una Sistema-Interfaz que hemos creado anteriormente. Seleccionamos entonces la interfaz que creamos en el paso anterior.

Business Agility!

3 7

Taller

8. Cuando seleccionamos la interfaz, el asistente nos mapea inmediatamente la URL del

servicio y el nombre del método en la parte inferior. De igual forma, nos muestra el método y el tipo de dato que recibe como parámetro, así mismo el tipo de dato que responde. Aquí podemos ver que recibe un string (idUSer) y retorna un documento XML.

9. El siguiente paso, es seleccionar el valor de entrada. El dato que espera el servicio, es el numero de identificación del usuario, por lo tanto, para obtener este dato desde el proceso de Análisis, es decir, desde el contexto en que se va a llamar la interfaz, se debe navegar por el modelo de datos así :

SolicitudDeProductos.ClienteSolicitud.Cliente.NumeroDeIdentificacion

Business Agility!

3 8

Taller

10. Como la respuesta del servicio, es totalmente compatible con el modelo de datos de BizAgi, damos siguiente en el paso de Parámetros de Salida, ya que BizAgi tomara esta respuesta y automáticamente tomara los datos de esta respuesta y los guardara como información del proceso.

11. Para el paso del manejo de error, seleccionamos Throw Validación Error, para que BizAgi capture la excepción de la ejecución y así pueda presentarla más adelante al usuario o al administrador. Damos clic en Finalizar.

12. El último paso, es configurar la interfaz para que quede de forma asíncrona. Para esto cerramos el modo Wizard y vamos hasta módulos, ya que es una configuración avanzada. Seleccionamos el modulo Procesos, seleccionamos el Proceso Análisis y le damos CheckOut.

Business Agility!

3 9

Taller

13. Damos clic derecho a la actividad automática Consultar Centrales de Riesgo y

seleccionamos Opciones. Dentro del tab de opciones, seleccionamos la última pestaña, Tareas Asíncronas. Llenamos la información como se muestra en la grafica, o como usted prefiera.

Business Agility!

4 0

Taller

14. Ahora, guardemos los cambios y ejecutamos el proceso. Debemos llevar un caso hasta la actividad Analizar Solicitud. Debemos ver un registro en la grilla con un link a un documento PDF, tal como se muestra a continuación :

Business Agility!

4 1

Taller

EJERCICIO: El segundo ejercicio, consiste en utilizar esta misma actividad de Consultar Centrales de Riesgo, pero para consumir el segundo método de nuestro bus de servicios: lastBehavior. Como una actividad automática solo puede tener una sola invocación a un servicio, vamos entonces a sobre escribir la configuración de la interfaz anterior.

1. Antes de proceder a la configuración de la interfaz, analicemos con que interfaz nos vamos a comunicar.

El parámetro de entrada del servicio, según vemos en el WSDL, es igualmente un string (idUSer)

<s:element minOccurs="0" maxOccurs="1" name="idUser" type="s:string" />

Pero en la respuesta, notamos que no es compatible con el modelo de datos de BizAgi :

Business Agility!

4 2

Taller

Esto es, por que este servicio, no está diseñado específicamente para BizAgi, sino que en el escenario de prueba planteado, es un servicio que consumen varias aplicaciones, tal como lo explica la teoría de SOA. En estos casos, es requerido hacer una transformación de XMLs entre la respuesta del servicio y la respuesta tal como la necesita BizAgi. BizAgi brinda esta posibilidad, en el momento de la configuración de la interfaz, permitiendo subir un archivo de transformación XSLT. De igual forma, esto se puede aplicar a la información de Salida o Request del servicio, en caso de que el servicio nos solicitara la información en una forma diferente de tipos nativos (int, string etc).

2. Vamos entonces a configurar esta interfaz, seleccionado el proceso de Análisis desde el Asistente (Wizard) de BizAgi, y luego seleccionando el punto 6. Integración del Carrusel, y luego seleccionando la interfaz Consultar Centrales de Riesgo.

3. El parámetro de entrada es igual, ya que es idUser para el sistema externo, que para nosotros es NumeroIdentificacion del Cliente. Seleccionamos entonces, el segundo método en la lista de Sistema-Interfaz :

Business Agility!

4 3

Taller

4. El Xpath para obtener el numero de identificación, es el mismo que en el paso anterior :

5. Damos clic en siguiente, para pasar a configurar los parámetros de salida. En esa pantalla, damos clic sobre Configurar un Esquema de Salida, y se nos habilitan dos opciones : 1 Subir un XSD para validar la respuesta y 2. Subir un XSL para transformar la respuesta. Vamos a dar clic en la segunda opción :

Business Agility!

4 4

Taller

En la ruta \INSUMOS\ESB\ESQUEMAS\ hay un archivo de transformación con el nombre XSL_IN_lastmonth.xslt. Este archivo, ha sido creado para transformar la respuesta del Servicio hacia un XML que corresponda con el modelo de datos de BizAgi. La creación de estos archivos XSLT, no se realiza con BizAgi, se realizan con una herramienta aparte, como por ejemplo Altova Map Force u otras utilidades disponibles en Internet. El resultado de esos programas debe ser un XSLT Versión 1.1 que subimos a BizAgi en este paso :

Seleccionamos el archivo, y podemos visualizarlo si así queremos.

Business Agility!

4 5

Taller

6. Si damos otra mirada a la respuesta del servicio, vemos que también tiene una trama o nodo de mensajes. Este se utiliza, cuando desde el servicio externo se da manejo y codificación de errores. Por ejemplo, en caso de que la BD de datos que consulta el servicio externo, no esté disponible, dicho servicio podría mandarnos un mensaje con esa repuesta, ya que no es posible que nos retorne información de negocio. Para poder tomar estos mensajes y presentarlos al usuario o administrador de BizAgi, podemos indicar un Xpath a evaluar durante la respuesta del servicio.

Seleccionamos entonces la opción Response Xpath y configuramos lo siguiente:

1. En caso de que la consulta sea exitosa, el desarrollador del servicio nos asegura, que siempre retornara el valor de 0 cero en el tag errorcode. Por lo tanto, vamos entonces a crear un Xpath hasta esta repuesta :

Root\message \errorcode

Creamos una validación, en donde vamos a indicar a BizAgi, que si este campo llega con un valor diferente de cero, es porque ocurrió una excepción. Además, en caso de que sea así, vamos a colocar el Xpath del mensaje de error:

Root\message\messageerror

Business Agility!

4 6

Taller

Al final, la configuración de error debe lucir así :

Finalmente, damos clic en Guardar todo, y creamos un caso para probar. Recordemos que este método, no retorna un reporte en pdf, sino una información del último mes, la cual deja en la grilla consulta cliente.

Business Agility!

4 7

Taller