Configuración
Se definirán los puntos básicos que se deben configurar para poder comenzar con la sincronización
Básica
En este documento se definirán los puntos básicos para una primera configuración una vez que las conexiones de las diferentes bases de datos están definidas.
1. Activar Data Everywhere
Desde la ficha de configuración de Data Everywhere, debe estar activado el producto:
Se activa en la base de datos Maestra.
2. Creación de las entidades
Las entidades se traducen en las tablas que se desean replicar. Se requiere de un perfil más técnico ya que es necesario saber el número de la tabla de Business Central.
En este punto se debe definir:
- Código grupo de entidades: Si procede, existe la posibilidad de añadir las entidades a un grupo. Esto facilita la posibilidad de crear posteriormente una tarea de replicación donde estén recogidas varias tablas a la vez.
- Tabla origen y tabla destino: Por defecto, se pondrá el mismo número.
- Editable en destino: Lo habitual es que en destino no se puedan insertar, modificar, borrar o renombrar registros, por lo que dejaríamos este valor en "No".
- Accionadores del proceso: Por defecto marcar todas las opciones: enviar al insertar, al modificar, al borrar y al renombrar. Con todo marcado, el sistema, ante cualquier cambio en la tabla elegida ejecutará el proceso de "sincronización"
Se debe crear una ficha de entidad para cada tabla que se quiera usar.
Avanzada
Este documento tiene por objeto descubrir las opciones más avanzadas de cada configuración
1. Ficha configuración Dataeverywhere
Apartado "General":
- Active: indica si Dynasoft Data Everywhere está activo o no
- Master Database: indica si la BBDD actual es la BBDD Master o no
- Management Company: indica cual es la empresa de gestión. La empresa de gestión es aquella en la se gestionan las replicaciones, solo se podrán lanzar las replicaciones desde esta empresa (que es una empresa de la BBDD Master)
- Auto Refresh Every (seconds): indica en segundos, cada cuanto se actualiza de forma automática la página de replicaciones de Data Everywhere. Si se pone 0, esta opción se desactiva y la página de replicaciones no se actualizará automáticamente.
En el apartado "No. Series" se configuran las series que se van a utilizar, según se esté creando una entidad, una replicación o una replicación de configuración.
En el apartado "Replication" existen las siguientes opciones:
- Default Nº Of Retries: número de reintentos por defecto cuando se encuentre algún error.
- Default Minutes Between Retries: especifica el tiempo, en minutos, que el sistema debe dejar pasar entre reintentos
- Wait Before Inmediate Sending (seconds): se trata del tiempo de espera entre que se ejecuta el cambio hasta que se hace el envío de la información.
Disponemos de varias acciones:
- Open Setup Wizard: abre un asistente de configuración que permite configurar la BBDD maestra, una nueva cadena de conexión o añadir otra conexión (no maestra).
- Create AAD Application: permite crear una aplicación de Microsoft Entra para que se pueda conceder consentimiento y asignar los correspondientes permisos de acceso (vea Derechos de aplicación).
- Create No. Series: permite crear y asignar automáticamente los nº de series.
2. Ficha de entidades
Existen 4 detonantes, denominados "triggers", que hacen que se ejecuten el proceso de envío de información. Estos son:
- Send Insert: El sistema ejecuta el proceso si encuentra una nueva CREACION sobre la tabla seleccionada. Por ejemplo, si está configurada la tabla de clientes, sólo se ejecuta si se ha creado una nueva ficha de cliente
- Send Modify: El sistema ejecuta el proceso si existe una MODIFICACIÓN sobre algún campo de la tabla seleccionada.
- Send Delete: Se ejecuta cuando se elimina un registro de la tabla seleccionada.
- Send Rename: Se ejecuta cuando se ha modificado el campo clave de la tabla seleccionada. Por ejemplo, en la tabla de clientes sería el campo "Nº"
Lo normal es activar todas las opciones pero existe la opción de activar sólo los deseados.
Otra información relevante es el campo "Editable In Destination", este campo permite definir si la tabla de esta entidad será modificable en destino. Permite 3 opciones:
- No: La tabal de la entidad no podrá modificar en destino, saltando un error en caso de que en destino se intente insertar, modificar, borrar o renombrar.
- Only Selected Fields: Esta opción permite indicar qué campos se podrán modificar o no, en este caso, dependerá de la columna "Editable In Destination" disponible en la lista de campos.
- Yes: Permite que en destino la tabla de la entidad se pueda insertar, modificar, borrar o renombrar libremente.
En la lista de campos, se pueden establecer varias opciones:
- Replicate: Indicamos si este campo se replica o no
- Sum In Destination: se indica si queremos que en este campo se sume el importe definido en el campo Sum To Destination Fields en la tarea de replicación de Data Everywhere.
- Editable In Destination: si la especificación se ha seleccionado la opción "Only Selected Fields" en "Editable In Destination", aquí se marcarán aquellos campos que se deseen editar en destino.
- Filter Value: Indica el valor del filtro que queremos aplicar a este campo al replicar. Se recomienda utilizar variables de entorno, las cuales van entre llaves {}. Las variables de entorno se especifican en cada tarea de replicación. Revise la sección Opciones Específicas para más información.
- Destination Allowed Editing Filter: Indicamos un filtro para establecer qué datos se pueden modificar en destino, más allá de los campos editables en destino. En este caso afecta a los registros que entran en el filtro indicado. Este campo no acepta variables de entorno.
- Encrypt: Si el campo puede contener información sensible se recomienda cifrarlo. Aquí podríamos tener en cuenta credenciales de acceso o contraseñas. Por defecto, cuando el campo contiene los valores "password", "pwd" o "key" se marca automáticamente para cifrar. El sistema utiliza un sistema de cifrado diferente al que utiliza Business Central.
Mapeo
Opcionalmente se pueden mapear tanto a nivel de tablas como a nivel de campos (por defecto los campos están ocultos, pero se pueden mostrar al personalizar la página). Los campos origen y destino tienen que ser del mismo tipo.
Opciones Específicas
1. Uso de parámetros para filtrar
Existe la posibilidad de definir qué registros de una tabla se debe exportar en base a uno o varios parámetros. A modo de ejemplo, si en una conexión se quiere exportar únicamente los proveedores que tengan un grupo registro proveedor específico.
Para ello, lo primero que se debe hacer es configurar en la ficha de la entidad, el valor que tendrá la variable del campo concreto:
Se pueden especificar valores concretos utilizando las opciones de filtro que nos permite Business Central, pero también se permite utilizar variables de entorno, estas van entre llaves "{ }".
En este caso, para el campo grupo registro proveedor se ha definido el nombre "{grupo}" que, como se indica en la información adicional, debe estar contenido por "{ }" al tratarse de una variable de entorno.
El nombre de la variable es "case sensitive" lo que se traduce en que es importante prestar atención a las mayúsculas y minúsculas
Una vez definido, es en la configuración de ficha de la tarea de replicación donde se especifica el filtro:
Al hacer clic sobre el campo, el sistema desplegará la siguiente ventana donde se podrá definir los diferentes valores de las variables: