Data Everywhere

Notas de actualización

Versión 3.0 - 22/01/2024

Se añade la posibilidad que varias empresas repliquen sobre una misma empresa destino. Para ello se han creado dos nuevas opciones en la tarea de replicación ("Sumar en destino a los campos" y "Reconstruir grupo dimensiones") y otras opciones en los campos de entidad ("Sumar en destino").

Con esta nueva funcionalidad, varias empresas pueden replicar a una misma empresa destino "Mov. contabilidad" (y otras tablas relacinadas, como "Mov. cliente", "Mov. proveedor", ...), quedando cada empresa en un rango concreto de movimientos (gracias "Sumar en destino a los campos" y "Sumar en destino").

Si se activa, en la BBDD destino no debería permitirse la modificación de las tablas, a no ser que el Partner haya incluido alguna modificación para permitirlo

La reconstrucción del grupo de dimensiones requiere que las dimensiones y los valores de dimensión se repliquen antes que los registros que incluyen el Id grupo dimensiones (Mov. contabilidad, Mov. cliente...).

Se recomienda que los maestros sean los mismos en las distintas bases de datos, y si no, que no colisionen en su nº.

Primeros pasos

Primeros pasos

Derechos de aplicación

1. SaaS

Antes de comenzar a usar el producto, un administrador global del tenant de Microsoft debe conceder consentimiento y darle permisos a la aplicación de Data Everywhere en las Aplicaciones de Microsoft Entra (anteriormente conocido como Azure Active Directory).

Desde la "Ficha de configuración de Data Everywhere" está la opción de "Crear aplicación AAD":

Captura de pantalla 2024-01-21 205311_marked.png

Una vez creada la aplicación, en la ficha de la aplicación de Microsoft Entra:

Captura de pantalla 2024-01-21 213832_marked.png

  1. Conceder consentimientos.
  2. Crear y/o añadir un conjunto de permisos para poder realizar los procesos necesarios. Si el objetivo es replicar todos los datos de una o varias empresas, se recomienda utilizar el conjunto de permisos "SUPER (DATA)". Hay que tener en cuenta que una aplicación de Azure Directory funciona como un usuario a la hora de asignar permisos, con la excepción que no puede puede utilizarse el conjunto de permisos SUPER ya que no está autorizado para ello.

2. On-Premise

En On-Premise, los permisos se adquieren del usuario al que se ha asociado las credenciales de acceso. El proceso tendrá los mismos permisos que dicho usuario, por lo que es importante que el usuario tenga acceso a realizar los procesos requeridos por Data Everywhere (lectura, inserción, modificación y/o borrado de los registros de las tablas).


Primeros pasos

Asistente de configuración

Se ha creado un asistente de configuración que se encuentra en la tabla de "configuración asistida" de Business Central:


image.png

1. Configurar Dynasoft Data Everywhere

image.png


Este sistema es válido tanto para crear la empresa MASTER, que será la que recoja todas las configuraciones de las diferentes conexiones, como para añadir bases de datos adicionales. Las opciones disponibles son las siguientes:

image.png

IMPORTANTE: Si ya existe una empresa MAESTRA y se vuelve a crear una empresa Master, el sistema borra todas las configuraciones de todas las tablas relacionadas.

image.png


2. Crear entidades de Dynasoft Data Everywhere

Este proceso sólo es funcional desde la base de datos principal. Este proceso permite seleccionar las tablas (entidades) que se desean sincronizar con el producto. 

image.png

image.png

image.png

En este punto sólo es necesario añadirle un código y un nombre al grupo para posteriormente poder añadir las tablas:

image.png

image.png

Una vez seleccionadas las tablas, la siguiente pantalla muestra una matriz con las tablas y con los valores predefinidos para cada caso.

image.png

Por defecto estas opciones deben quedar marcadas. Estas opciones hacen referencia a cuando se debe ejecutar el proceso de replicación: al registrar, al modificar, al eliminar y/o al cambiar el código.

Una vez finalizado el proceso, en la página "Lista de entidades de Data Everywhere" aparecen las diferentes entidades y asociadas al mismo grupo:

image.png

Primeros pasos

Primera conexión

La primera conexión hace referencia a la conexión inicial y se debe crear en la base de datos que será la principal. Esta base de datos será el centro de las diferentes configuraciones.

Es configuración se puede crear usando el Asistente o desde Ficha conexión Data Everywhere:

1. Usando el Asistente

Se debe buscar el asistente comentado anteriormente y seleccionar en "Crear conexión principal":

image.png

En la siguiente ventana el sistema solicitará un nombre y una descripción para la conexión:

image.png

Al introducirlo el sistema mostrará los datos completados y bastará con finalizar el asistente:


image.png


2. Usando la Ficha de Conexión

A través de este método basta con añadir un código a la conexión y pulsar sobre "Crear primera conexión" para que el sistema termine de completar los datos.

image.png

Primeros pasos

Nueva conexión manual

1. Común

Captura de pantalla 2024-01-23 110221_marked.png

Para añadir una nueva conexión SaaS se debe indicar varios parámetros:

El nombre del localizado es especialmente relevante si se utilizan filtros de fecha, hora o importe, ya que el formato del filtro debe tener en cuenta el nombre del localizado. Si se deja en blanco, en SaaS se utiliza "en-US", en On-Premise el que se haya configurado en el parámetro "Service Language" del fichero de configuración.

En SaaS, el límite son 30MB. En On-Premise depende del parámetro "Max Upload Size" (que, de forma predeterminada, también son 30MB).

Una vez configurados los datos, en la "Connection Subpage", hay que seleccionar la acción "Import Companies", donde podremos verificar que los datos de conexión funcionan correctamente y se pueden descargar las empresas de la conexión configurada.

2. SaaS

Para añadir una nueva conexión SaaS se debe indicar varios parámetros:

 

Estos dos últimos datos se pueden encontrar la propia página de Business Central:

image.png

En Business Central Cloud, no debe preocuparse de habilitar puertos o permitir acceso desde fuera ya que todas las conexiones tienen lugar en el Cloud de Microsoft (aunque puede que tengan IPs diferentes si los servidores de los distintos tenants están en ubicaciones diferentes).

3. On-Premise

Captura de pantalla 2024-01-23 092707_marked.png

Si se desea crear una conexión a una BBDD local (On-Premise), hay que considerar otros campos:

Captura de pantalla 2024-01-23 105148_marked.png

Si dispone de una base de datos On-Premise y una o varias bases de datos SaaS, nuestra recomendación, si quiere olvidarse de problemas de visiblidad entre bases de datos, es que la conexión master sea la base de datos On-Premise, que debería tener visibilidad a las bases de datos SaaS.

 

Configuración

Se definirán los puntos básicos que se deben configurar para poder comenzar con la sincronización

Configuració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:

image.png

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.

Captura de pantalla 2024-01-22 184141_marked.png

En este punto se debe definir:

Se debe crear una ficha de entidad para cada tabla que se quiera usar.

Configuración

Avanzada

Este documento tiene por objeto descubrir las opciones más avanzadas de cada configuración

1. Ficha configuración Dataeverywhere

Captura de pantalla 2024-01-21 205311_marked.png

Apartado "General":

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:

Disponemos de varias acciones:

Captura de pantalla 2024-01-22 173827_marked.png

2. Ficha de entidades

Existen 4 detonantes, denominados "triggers", que hacen que se ejecuten el proceso de envío de información. Estos son:

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:

Captura de pantalla 2024-01-22 181211_marked.png

En la lista de campos, se pueden establecer varias opciones:

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.

Configuración

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:

image.png

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:

Captura de pantalla 2024-01-22 185933_marked.png

Al hacer clic sobre el campo, el sistema desplegará la siguiente ventana donde se podrá definir los diferentes valores de las variables:

image.png



Uso

Escenario 1:

Configuración inicial para replicar las tablas de clientes y proveedores entre 2 empresas con las siguientes características:

El tipo de replicación será inmediata.

1. CREACIÓN CONFIGURACIÓN EMPRESA MASTER

Para realizar la primera conexión se usará el asistente de configuración, accesible desde la ventana de Configuración de Data Everywhere:

image.png


image.png

En este punto se debe informar del Código de conexión y su descripción:

image.png

El sistema reconoce la información necesaria para crear la conexión:

image.png

2. CREACIÓN CONFIGURACIÓN EMPRESA DESTINO

Haciendo uso del mismo asistente se puede configurar la empresas destino. En este caso se compone de 2 pasos:

image.png

image.png

image.png


image.png

En la ventana superior, el sistema recopila los datos necesarios para hacer la conexión.  Es necesario COPIAR las líneas del recuadro.

image.png

En el recuadro se pegarán las líneas anteriormente copiadas:

image.png

image.png

El sistema automáticamente rellenará la información necesaria para crear la empresa destino.

3. ACTIVACIÓN DE LAS CONEXIONES CREADAS

En la tabla de conexiones Data Everywhere se observan las dos conexiones que se han añadido. Ahora, haciendo click sobre el código para entrar en la ficha de la conexión y poder activarla:

image.png

image.png

Esta activación se debe hacer para cada nueva conexión que se añada

4. ELECCIÓN DE LAS ENTIDADES (TABLAS) QUE SE VAN A REPLICAR

Se activará el asistente de configuración que podemos encontrar en la ventana de Lista de entidades de Data Everywhere:

image.png

Siguiendo los pasos, se elegirá "Seleccionar tablas desde una lista":

image.png

image.png

Se debe añadir el código y nombre del grupo que contendrá las tablas seleccionadas. En la siguiente ventana se seleccionará las tablas que forman el grupo. En este caso, las tablas 18 y 23 que hacen referencia a clientes y proveedores respectivamente:

image.png

image.png

El siguiente punto permite seleccionar bajo que acciones se debe activar la replicación. Por defecto se debe dejar todos marcados:

image.png

Una vez creadas aparecerán en el listado:

image.png

5. CREACIÓN DE LA TAREA DE REPLICACIÓN

La tarea de replicación es la encargada de ejecutar los procesos de replicación. Como se ha comentado, en este caso la replicación será inmediata. Para proceder, se debe dirigir a la tabla Tareas de Replicación para crear una nueva tarea:

image.png

image.png

En este punto se debe rellenar:

En el momento que se crea una configuración de empresa destino el sistema crea automáticamente una tarea de replicación de tipo configuración. Esta es necesaria para replicar las diferentes configuraciones que se van añadiendo a las distintas conexiones.

Una vez que el tipo de replicación se ha seleccionado tarea queda activada.

6. ACCION DE REPLICACION

Una vez está configurado todo se puede crear un cliente de prueba. La tarea de replicación actualmente está configurada por defecto para que comience a los 60 segundos de detectar la acción.

Se creará un nuevo cliente:

image.png

image.png

Se observa que está creado en el entorno TestConsultoría y la empresa D.E. Source Company. En el momento de crearse la tarea de replicación se empieza a actualizar y va informando de los pasos que sigue:

image.png

image.png

Una vez el proceso ha finalizado, se observa que ha generado la ficha de cliente en la empresa destino:

image.png

Este escenario se puede hacer para tantas empresas y tablas se deseen replicar.

FAQ - Preguntas frecuentes

1. Si la replicación de datos falla debido a no puede insertar datos en una tabla por tema de permisos. ¿Qué se debería hacer?

Hay dos soluciones para este caso:

  1. Añadir los permisos necesarios de la tabla que ha dado error a la codeunit 7257332 "GDSDE Process Log". 
  2. Darle al botón "Forzar proceso", el cuál procesará el Json e ignorará los errores que haya (Este caso solo se tiene que utilizar si se sabe que la tabla que ha dado error no es prioritaria, y si no se puede hacer la subida al AppSource del producto.)