Utilizar la configuración avanzada de Replicación

<< Click to Display Table of Contents >>

Navigation:  Bizagi Studio > Asistente de Procesos > Modelar Datos > Conexiones con fuentes de datos externas > Replicación de datos >

Utilizar la configuración avanzada de Replicación

Introducción

Bizagi presenta el Asistente de Replicación en cual le ayudará en la configuración de la conexión de una base datos externa SQL Server u Oracle (y crear los componentes necesarios).

 

Sin embargo, en escenarios más sofisticados, usted deseará utilizar la opción de Configuración Estándar (Avanzado), la cual es otra alternativa para realizar una Replicación en su proyecto.

 

Estos escenarios se refieren principalmente a:

El uso de fuente de datos que no es SQL Server u Oracle (mediante replicación personalizada).

Los requerimientos para configuración avanzada (por ejemplo, querer utilizar una columna de Oracle que no es soportada).

Necesidad de ajustes manuales en la configuración. Esto puede pasar en escenarios sofisticados donde tiene todo un conjunto de tablas que están relacionadas entre ellas. Esto puede involucrar relaciones entre entidades virtuales, por lo que la configuración requiere que todas las tablas sean replicas y virtualizadas teniendo en cuenta algunas consideraciones.

 

El siguiente artículo ilustra cómo configurar un Replicación en Bizagi utilizando las opciones Avanzadas

Si desea más información y un ejemplo sobre replicación a MySQL visite Replicación Personalizada

Tenga en cuenta que solamente la versión de Bizagi .NET soporta cualquier motor de base de datos. 

 

Utilizando la Configuración Avanzada

Para configurar la Replicación a través de la configuración Avanzada, asegúrese que ya ha creado las entidades paramétricas que necesita y sus atributos (para almacenar los valores de las variables entrantes de la base de datos externa).

Para más información sobre crear entidades en Bizagi, visite ¿Cómo crear un modelo de datos?

 

Note que las entidades creadas en Bizagi deben tener una estructura similar a la estructura de aquellas en la fuente de datos externa (por ejemplo, los tipos de datos que almacenan los valores de las columnas en las tablas externas).

 

Para utilizar las opciones Avanzadas para replicación, diríjase a la vista de Experto en Bizagi Studio y seleccione la opción Sistemas.

 

SystemsModule

 

¿Qué necesita hacer?

Para realizar la configuración de la Replicación a través de la configuración avanzada realice los siguientes pasos:

 

1. Crear las entidades en Bizagi con sus atributos para igualar con la información de la fuente. 

La creación de las entidades se realiza en el segundo paso del asistente Modelar Datos

 

2. Definir el sistema 

Definir la información para el sistema donde se encuentra la fuente de datos externa. 

 

3. Definir el Proveedor 

Especificar detalles por el Proveedor (conexión con la información de la fuente de datos externos).

 

4. Registrar la clase de replicación (el componente que tiene la implementación)

Es necesario definir explícitamente si vamos a utilizar una implementación personalizada. 

 

5. Definir el esquema de Replicación 

Especificar la programación del trabajo, el cual será ejecutado en la sincronización de la Replicación.

 

6. Incluir Entidades paramétricas para la Replicación

Incluir individualmente  las entidades paramétricas que van a ser replicadas para esta conexión (Proveedor)  dada la Replicación del esquema. 

 

7. Emparejando atributos en Bizagi con las columnas de la fuente. 

Mapee cada uno de los atributos de la entidad replicada con la columna correspondiente de la fuente. 

 

8. Utilizando las opciones de configuración adicional

Finalmente, existe la posibilidad de utilizar opciones adicionales para la configuración de cada entidad replicada, por ejemplo, definir filtros para los registros entrantes de la tabla externa, indicando si un atributo (columna) de la entidad debe ser ignorado. 

 

Una vez se haya realizado los pasos de la configuración, se debe ejecutar una importación inicial de las tablas o vistas, de esa forma podemos probar que la integración se creó correctamente (punto de control).

 

Ejemplo

En este ejemplo, vamos a replicar las tablas TerritoriosRegión y Transportistas desde la base de datos Southwind en Oracle.

 

 

HowToIntegrateBizagiWithAnExternalDataSource_Image041

 

El primer paso es asegurase que las tablas que han sido creadas previamente en Bizagi sean entidades paramétricas. 

 

1. Crear las entidades en Bizagi con sus atributos para igualar con la información de la fuente. 

Vamos a crear las entidades paramétricas Región, Ramas y Transportista en Bizagi. 

 

Atributos de la tabla Región en Bizagi

 

HowToIntegrateBizagiWithAnExternalDataSource_Image029

 

Atributos de la tabla Territorios (Entidad Ramas) en Bizagi: 

 

HowToIntegrateBizagiWithAnExternalDataSource_Image030

 

Atributos de la tabla Transportista en Bizagi:

 

HowToIntegrateBizagiWithAnExternalDataSource_Image031

 

 

2. Definir el sistema. 

Para definir el sistema a utilizar en la integración, dé clic derecho en Sistemas y seleccione la opción Nuevo Sistema.

 

NewSystem

 

En la ventana de Nuevo Sistema, debe definir la información del sistema donde se encuentra la fuente de datos externa.

Ingrese los detalles para el nuevo sistema: Nombre a mostrar y Descripción. 

 

 

VR_Both03_SystemProps

 

Asegúrese de que la opción Habilitar proveedores de datos en este sistema esté seleccionada. 

Dé clic en OK.

 

 

3. Definir proveedor 

Una vez haya definido y creado el nuevo sistema en Bizagi, se ingresarán los detalles del proveedor utilizando en la configuración para éste sistema y para la Replicación. 

 

Para realizar esto, dé clic derecho en el nodo de Proveedor ubicado en el sistema recién creado y seleccione la opción Nuevo Proveedor.

 

VR_Both04_NewProvider

 

 

En la pestaña de Configuración Básica, ingrese los detalles del nuevo proveedor: Nombre Visible, Nombre y Descripción.

Asegúrese de marcar la opción Permitir Replicación de datos para este proveedor.

 

VR_Both05_ProviderProps

 

Luego, en la pestaña Conexión Desarrollo dé clic en el botón OLEDB Config.

Note que puede establecer diferentes valores para los diferentes ambientes del proyecto (Desarrollo, Test y producción).

En el siguiente ejemplo, vamos a establecer las propiedades para el ambiente de desarrollo.

 

 

VR_Both06_ProviderOLEDB

 

Si su fuente de datos externa es un Servidor SQL database, seleccione el botón SQL Server y específique los siguientes detalles:

Servidor de base de datos: Nombre del servidor de base de datos que contiene la instancia SQL Server. 

Usuario: Nombre del usuario para iniciar sesión en la base de datos. Es importante mencionar que la cuenta debe tener permisos de lectura para acceder a las tablas o vistas de la replicación. 

Clave: Contraseña para el usuario de la base de datos. 

Base de datos: Nombre de la base de datos donde las tablas o vistas serán replicadas. 

 

SQLProviderProperties

 

Por otro lado, si la fuente de datos externa es Oracle ingrese la siguiente información:

Nombre del Servicio: El texto de conexión con la instancia del servicio Oracle. Debe ser definido como “nombre_del_servidor: puerto/nombre_de_la_instancia”. 

Note que por defecto el puesto para las instancias de Oracle es 1521.

Usuario: Nombre del usuario para iniciar sesión en la base de datos.

Contraseña: Contraseña para el esquema. 

Esquema: El nombre del esquema del usuario.

 

Para este ejemplo, vamos a ilustrar la configuración de la replicación con una fuente de datos externa en Oracle.

En la ventana de configuración virtual de la base de datos, se ingresa el nombre del servicio de red, nombre de usuario y contraseña.

 

VR_Both07_ProviderConn

 

Clic en Ok para guardar la conexión.

De nuevo, clic en OK para regresar a la ventana de nuevo proveedor.

 

 

note_pin

Tenga en cuenta que es necesario definir las propiedades y valores de conexión para la integración en los diferentes ambientes (desarrollo, Test y producción).

Sin embargo, la definición de los ambientes de Test y de producción sólo se puede ejecutar antes de realizar deployment del sistema y del proveedor al ambiente determinado. La edición de las valores en Test o en producción debe realizarse luego del primer deployment utilizando el Management Console.

 

 

4. Registrar la clase de replicación

El siguiente paso es crear la clase de replicación en Bizagi, la cual puede ser definida utilizando los componentes que Bizagi trae por defecto (Implementación de clase), o usar un componente personalizado (por ejemplo, conectar con MySQL, Postgresql, DB2, etc).

 

Aquí necesita definir si se utilizará una implementación personalizada.

 

En el siguiente ejemplo, se utilizarán los componentes que Bizagi tiene por defecto.

Para definir la Clase de Entidad de Replicación, dé clic derecho sobre el nodo de Entidades Replicadas y seleccione la opción Nueva clase de Replicación.

 

Deje los valores que trae por defecto y dé clic en Ok.

 

VR_Replication12_Replicationschema

 

 

5. Definir un esquema de replicación

Una vez la clase de Replicación es creada o registrada, vamos a especificar la repetición de la replicación de forma periódica con un trabajo programado.

 

Para definir este esquema, ubique la clase de replicación (la entidad por defecto se llama Entidad por Defecto de Replicación, Default Replication Entity) bajo la opción entidades replicadas; dé clic derecho en ella y seleccione la opción Adicionar esquema de Replicación.

 

 

VR_Replication13_Defaultentityclass

 

 

En la ventana de configuración, digite un Nombre, Nombre visual y descripción para el esquema de replicación.

 

HowToIntegrateBizagiWithAnExternalDataSource_Image027

 

En la pestaña de propiedades de programación (Schedule Properties), especifique la frecuencia en la cual la información será replicada de la base de datos externa (sincronización con Bizagi).

En el ejemplo, la replicación ocurre los martes y viernes de cada semana a las 8:00 pm empezando el 22 de Agosto de 2015.

 

HowToIntegrateBizagiWithAnExternalDataSource_Image028

 

note_pin

La replicación comenzará a ejecutarse en el día y la hora definida previamente, sin embargo, podrá utilizar la opción de Replicar ahora para que se ejecute de inmediato.

Se requiere que el servicio del programador para el ambiente se encuentre encendido y corriendo.

 

Para más información sobre el servicio del programador y su administración desde el Management Console

Si usted desea correr la sincronización inmediatamente para las entidades replicadas, diríjase a la opción Replicar Ahora descrita en la configuración de opciones Adicionales.

 

Por la configuración presentada en esta pestaña, defina la periodicidad y frecuencia de ejecución de acuerdo a la siguiente tabla:

 

Opciones del programador

Descripción

Habilitar programador para la replicación

Marque esta opción en Bizagi para ejecutar los datos de la replicación desde la fuente de datos externa.

Periodicidad

Marque, diario, semanal o mensual para definir con que frecuencia Bizagi ejecutará el esquema de Replicación.

Cada [...] día(s)

Esta opción cambiara de acuerdo a la opción seleccionada en Periodicidad.

Cuando se selecciona Diario: ingrese el número de días para realizar la repetición.

Cuando se selecciona semanal: ingrese el número de semanas para realizar la repetición. También seleccione en que día de la semana se debe ejecutar el esquema.

Cuando se selecciona mensual: ingrese el número de meses para realizar la repetición. También seleccione en que día del mes se debe ejecutar el esquema.

Frecuencia diaria

Defina si la ejecución ocurre una vez al día (y en que hora), o si se debe ejecutar cada cierto tiempo (horas, minutos).

Inicio

Configure la fecha inicial para que el esquema comience la ejecución.

Descripción de las propiedades del programador

 

 

Dé click en OK.

 

6. Incluir entidades paramétricas para la replicación. 

Luego de definir el esquema de replicación, es necesario incluir las tablas paramétricas y marcarlas como tablas de fuente de datos externa. 

 

Para realizar esto, incluya una por una las tablas paramétricas que se van a replicar con el proveedor de datos.

Por ejemplo, vamos a incluir la tabla de Territorios y la vamos a emparejar con la tabla Rama de la fuente de datos. 

 

Clic derecho en el nuevo nodo de esquema de Replicación, seleccione la opción Adicionar Entidad de Replicación.

 

 

HowToIntegrateBizagiWithAnExternalDataSource_Image032

 

 

 

En este paso, además de definir la tabla desde la fuente, también puede definir cuál de las columnas de la fuente debe ser tomada como llave de negocio para los valores de la entidad.

 

note_pin

La llave de negocio debe corresponder a la llave primaria de la tabla de la fuente.

 

Realice esto para cada Entidad Paramétrica (Región, Rama y Transportista de nuestro ejemplo).

 

La tabla Territorios (incluida como Rama) para la configuración de replicación y el esquema:

 

 

HowToIntegrateBizagiWithAnExternalDataSource_Image034

 

La tabla Región (incluida como Región) para la configuración de replicación y el esquema:

 

HowToIntegrateBizagiWithAnExternalDataSource_Image033

 

La tabla Transportista (incluida como Transportista) para la configuración de replicación y el esquema:

 

HowToIntegrateBizagiWithAnExternalDataSource_Image035

 

Esto significa que cuando el esquema de replicación se ejecute, éste sincronizará la información de las entidades Región, Rama y Transportista.

 

 

7. Emparejando atributos en Bizagi con las columnas de la fuente

Una vez se ha incluido el esquema de replicación, este se encontrará en proveedores. 

Dando clic en una entidad especifica (en nuestro ejemplo, es necesario realizar esto por cada una de las tres entidades paramétricas), en el panel del lado derecho se presentarán los atributos actuales de las tablas. 

 

Enlace cada atributo de la entidad replicada con su correspondiente columna en la fuente, dando clic derecho en el atributo y seleccionado la opción Propiedades.

 

 

HowToIntegrateBizagiWithAnExternalDataSource_Image036

 

 

Para el código de la entidad Rama, vamos a escribir su pareja de la fuente externa (columna TerritoryID).

 

 

HowToIntegrateBizagiWithAnExternalDataSource_Image037

 

Repita este paso para todos los atributos de cada entidad replicada.

 

Al final, la configuración de los atributos para Territorios (Rama en Bizagi) es:

 

HowToIntegrateBizagiWithAnExternalDataSource_Image038

 

Los atributos configurados para Región son:

 

HowToIntegrateBizagiWithAnExternalDataSource_Image039

 

Los atributos configurados para Tranportista son:

 

HowToIntegrateBizagiWithAnExternalDataSource_Image040

 

 

Note que todos los atributos nombrados necesitan tener una pareja en la fuente de datos externa. 

Si necesita que algún atributo no sea considerado en la Replicación, consulte la siguiente sección.

 

En este punto, hemos completado la configuración de la Replicación a través de las Opciones Avanzadas.

Usted puede utilizar opciones de configuración adicional cómo se muestra en la siguiente sección y verificar que los valores de las entidades paramétricas se configuren de forma apropiada.

 

8. Opciones adicionales de configuración 

Finalmente, existe la posibilidad de utilizar opciones adicionales para configurar cada entidad replicada, por ejemplo: Definir filtros por registro en las tablas que se van a replicar, definir si un atributo (columna) de la entidad no se debe tener en cuenta, etc. 

 

Dé clic en el siguiente link para obtener más información sobre Configuración avanzada.

 

Verificar la Replicación (Punto de chequeo)

Una vez la Replicación ha sido configurada, usted puede verificar la ejecución de la sincronización de las Entidades Paramétricas con las tablas externas. 

 

Existen dos maneras de realizar esto: Utilizando las opciones que se encuentran en el modulo Sistemas (Vista Experto) o a través de la información mostrada de las entidades (Módulo de Entidades).

Las opciones representadas en el módulo de Sistemas son útiles para los ambientes de producción o pruebas. 

Las opciones representadas en el módulo de Entidades servirán para realizar la verificación mientras se esta realizando la configuración en el Ambiente de desarrollo. 

 

Para más información sobre cómo verificar si la Replicación se ejecuta correctamente, visite Verificar Replicación