Sincronizar Exact Online con Visma.net Financials

Ir a la versión en inglés

Resumen

Sincroniza todas las relaciones de una administración de Exact Online con una administración de Visma.net Financials mediante una sola sentencia. Este segundo artículo sobre la sincronización con una sola sentencia SQL (tanto en una como en dos direcciones) ilustra una tarea práctica de sincronización.

Sincronización de relaciones de Exact Online hacia clientes de Visma.net Financials

Una innovación global para Invantive SQL permite la sincronización de datos con una sola sentencia (tanto mono como bidireccional) entre aplicaciones. El concepto y la gramática se introdujeron en Synchroniseer uw gegevens met één SQL-statement over meerdere cloudplatformen heen.

Este artículo ofrece un ejemplo práctico para garantizar que todas las relaciones de una administración de Exact Online estén presentes en una administración de Visma.net Financials como clientes.

La implementación de una sincronización monodireccional de Exact Online a Visma.net Financials requiere solo una sentencia de Invantive SQL. Es importante contar con conceptos claros y una correspondencia unívoca entre sistemas, sobre todo porque en la versión en inglés de Exact Online y Visma.net Financials los términos difieren:

  • En Exact Online, el concepto de «account» (relación) se refiere a una contraparte en un acuerdo legal (posiblemente futuro) con la empresa ejecutora. Sin embargo, el término en inglés «account» en Visma.net se refiere a una cuenta del libro mayor.
  • En Visma.net Financials, un «cliente» se refiere a una lista específica de partes que actúan como cliente en un acuerdo legal para transferir productos. Además de los «clientes», existe una lista separada de proveedores, mientras que en Exact Online todos los clientes, proveedores y otras contrapartes, como los prospectos, se gestionan mayormente como una sola tabla.

Mapeo funcional

En este caso, el mapeo es bastante sencillo.

En Exact Online, el origen es una relación:

En Visma.net Financials, el resultado debe ser:

En principio, el mapeo es el siguiente:

  • Las relaciones de Exact Online se identifican con exactamente un proveedor de Visma.net mediante el valor del campo «Referencia» en Visma.net.
  • La referencia de la relación comienza con ‘EOL-’ para indicar el sistema de origen.
  • El nombre de la relación se copia sin cambios desde Exact Online.

No es necesario modificar caracteres, ya que ambos sistemas parecen admitir un conjunto bastante amplio de los conjuntos de caracteres Unicode. No es necesario truncar, ya que el sistema de origen Exact Online limita el nombre de una parte a 50 caracteres, mientras que Visma.net permite hasta 60 caracteres.

La división de la lista de cuentas de Exact Online en clientes, proveedores (posiblemente superpuestos) y todos los demás queda fuera del alcance de este artículo. Los criterios para dicho mapeo se pueden encontrar en la documentación.

Tampoco entra en el alcance la actualización (basta con agregar «or update» a la sentencia) ni la eliminación de clientes (Visma.net no admite la eliminación de clientes mediante API).

Implementación

La sincronización podría formularse como una inserción en Visma.net Financials a partir de una select con un full outer join en ambos sistemas. Sin embargo, la sentencia synchronize lo simplifica:

use 102673@eolnl,1896329@vismanet

create or replace table exactaccounts@inmemorystorage
as
select to_char(code) number
,      name
,      'EOL-' || to_char(code) accountreference
from   exactonlinerest..accounts@eolnl

synchronize exactaccounts@inmemorystorage
to          customer_getall@vismanet
with        insert
identified 
by          accountreference ignore nulls

Algunas observaciones:

  • La sentencia use selecciona una administración de Exact Online y una administración de Visma.net Financials. Se pueden seleccionar varias administraciones de Exact Online o Visma.net Financials agregando más elementos, una o más consultas select, o los nombres especiales all y default.

  • La tabla en memoria exactaccounts es una tabla temporal que ilustra el mapeo de los conceptos de Exact Online a los conceptos de Visma.net Financials. Por ejemplo, un número de relación en Visma.net Financials se considera texto en las tablas. Esta consulta para la tabla en memoria sería el lugar adecuado para truncar los nombres de las relaciones, agregar prefijos, cambiar los nombres a mayúsculas, etc.

  • La sentencia synchronize utiliza la sentencia insert para cargar clientes en Visma.net Financials. La cláusula ignore nulls es necesaria porque el campo ‘Reference’ en Visma.net probablemente tendrá algunos valores nulos para los clientes ingresados manualmente, por lo que reference no es una clave única que cubra completamente la base de clientes de Visma.net.

  • eolnl y vismanet son dos contenedores de datos definidos en una base de datos distribuida con el siguiente contenido de settings.xml (por supuesto, además de on-premises, estos se pueden definir de forma aún más sencilla en Invantive Cloud):

<?xml version="1.0" encoding="utf-16"?>
<settings xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  version="5" forcedefault="false" >
  <group name="sample">
    <connection name="exact online nl + visma.net">
      <database alias="eolnl" provider="ExactOnlineAll" connectionString="api-url=https://start.exactonline.nl" />
      <database alias="vismanet" provider="VismaNet" />
    </connection>
  </group>
</settings>

Rendimiento

El rendimiento del proceso de sincronización depende de:

  • La cantidad actual de clientes en Exact Online y Visma.net: la sentencia synchronize debe conciliar ambas listas de clientes entre sí, ya sea a partir de una réplica existente en una base de datos SQL Server impulsada por Invantive Data Replicator, o descargando los datos en tiempo real de las dos plataformas en la nube. Por supuesto, también se pueden utilizar otras plataformas de Invantive Data Replicator, como Oracle y PostgreSQL.
  • La cantidad de clientes a intercambiar: la duración aumentará a medida que se deban intercambiar más datos.
  • La disponibilidad de funciones de carga masiva: la sentencia synchronize prefiere las inserciones masivas cuando están disponibles en plataformas como SQL Server, pero recurre a inserciones una por una cuando no lo están.

Actualmente, Visma.net Financials no cuenta con funciones de carga masiva, y en esta prueba se desactivaron Invantive Data Replicator y los distintos mecanismos de caché. Al inicio de la prueba, Visma.net Financials contenía aproximadamente 5.000 clientes y Exact Online más. No se utilizaron las funciones de procesamiento paralelo de Invantive, ni dentro ni entre administraciones.

La fase de reconciliación dura aproximadamente 17 segundos (más/menos 2 segundos), mientras que la carga y validación de clientes costó aproximadamente 500 ms por cliente (más/menos 200 ms).

Así, la carga inicial de 1.000 clientes dura aproximadamente 10 minutos. Con 10 clientes nuevos por día y una sincronización diaria, la base de clientes de Visma.net y Exact Online estaría actualizada en 30 segundos.