Synkronisera Exact Online med Visma.net Financials

Gå till den engelska versionen

Sammanfattning

Synkronisera alla relationer från en Exact Online-administration med en Visma.net Financials-administration med ett enda statement. Denna andra artikel om synkronisering med ett enda SQL-statement (både i en och i två riktningar) illustrerar en praktisk synkroniseringsuppgift.

Synkronisering av Exact Online-relationer till Visma.net Financials-kunder

En global innovation för Invantive SQL möjliggör synkronisering av data med ett enda statement (både mono- och bidirektionellt) mellan applikationer. Konceptet och grammatiken introducerades i Synchroniseer uw gegevens met één SQL-statement over meerdere cloudplatformen heen.

Denna artikel ger ett praktiskt exempel för att säkerställa att alla relationer från en Exact Online-administration finns i en Visma.net Financials-administration som kunder.

Implementeringen av en monodirektionell synkronisering från Exact Online till Visma.net Financials kräver endast ett enda Invantive SQL-statement. Tydliga begrepp och en entydig mappning mellan systemen är viktiga, inte minst eftersom begreppen skiljer sig åt mellan den engelska versionen av Exact Online och Visma.net Financials:

  • I Exact Online syftar begreppet “account” (relation) på en motpart i ett (eventuellt framtida) juridiskt avtal med det utförande företaget. Den engelska termen “account” i Visma.net syftar dock på ett konto i huvudboken.
  • I Visma.net Financials syftar en “kund” på en specifik lista med parter som agerar som kund i ett juridiskt avtal om att överföra produkter. Utöver “kunder” finns det en separat lista med leverantörer, medan i Exact Online hanteras alla kunder, leverantörer och andra motparter som prospekt i stort sett som en enda tabell.

Funktionell mappning

I detta fall är mappningen ganska enkel.

I Exact Online är källan en relation:

I Visma.net Financials ska resultatet vara:

I princip ser mappningen ut så här:

  • Exact Online-relationer identifieras av exakt en Visma.net-leverantör genom värdet i fältet “Referens” i Visma.net.
  • Relationsreferensen börjar med ‘EOL-’ för att ange ursprungssystemet.
  • Relationsnamnet tas över oförändrat från Exact Online.

Det är inte nödvändigt att ändra tecken eftersom båda systemen verkar stödja ett ganska brett utbud av Unicode-teckenuppsättningar. Avstavning behövs inte eftersom källsystemet Exact Online begränsar en parts namn till 50 tecken, medan Visma.net tillåter upp till 60 tecken.

Uppdelningen av Exact Onlines lista med konton i kunder, leverantörer (eventuellt överlappande) och alla andra har lämnats utanför omfattningen. Kriterierna för en sådan mappning finns i dokumentationen.

Inom omfattningen ingår inte heller uppdatering (lägg bara till “of update” i statementet) eller borttagning av kunder (Visma.net stöder inte API-baserad borttagning av kunder).

Implementering

Synkroniseringen skulle kunna formuleras som en insert i Visma.net Financials från en select med en full outer join mellan de två systemen. Synchronize-statementet gör det dock enklare:

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

Några kommentarer:

  • Use-statementet väljer en Exact Online-administration och en Visma.net Financials-administration. Flera Exact Online- eller Visma.net Financials-administrationer kan väljas genom att lägga till fler poster, en eller flera select-frågor eller de speciella namnen all och default.

  • In-memory-tabellen exactaccounts är en tillfällig tabell som illustrerar mappningen av Exact Onlines begrepp till Visma.net Financials begrepp. Till exempel betraktas ett relationsnummer i Visma.net Financials som text i tabellerna. Denna fråga för in-memory-tabellen skulle vara rätt plats för att avkorta relationsnamn, lägga till prefix, ändra namn till versaler osv.

  • Synchronize-statementet använder insert-statementet för att ladda in kunder i Visma.net Financials. ignore nulls-satsen behövs eftersom fältet ‘Reference’ i Visma.net sannolikt kommer att ha vissa null-värden för manuellt inmatade kunder, och reference därför inte är en fullständigt heltäckande unik nyckel i Visma.nets kundregister.

  • eolnl och vismanet är två datacontainers som definierats i en distribuerad databas med följande innehåll i settings.xml (dessa kan naturligtvis definieras ännu enklare i Invantive Cloud, förutom lokalt):

<?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>

Prestanda

Prestandan för synkroniseringsprocessen beror på:

  • Nuvarande antal kunder i Exact Online och Visma.net: synchronize-statementet måste stämma av båda kundlistorna mot varandra, antingen utifrån en befintlig replika i en SQL Server-databas som drivs av Invantive Data Replicator, eller genom att ladda ner data i realtid från de två molnplattformarna. Naturligtvis kan även andra Invantive Data Replicator-plattformar som Oracle och PostgreSQL användas.
  • Antal kunder som ska utbytas: tiden kommer att öka ju mer data som behöver utbytas.
  • Förekomst av bulkladdningsfunktioner: synchronize-statementet föredrar bulk inserts när de finns tillgängliga på plattformar som SQL Server, men faller tillbaka på en-i-taget-inserts när dessa inte är tillgängliga.

Visma.net Financials har för närvarande inga funktioner för bulkinmatning, och i detta test var Invantive Data Replicator och de olika cache-mekanismerna avstängda. Vid testets start innehöll Visma.net Financials cirka 5 000 kunder och Exact Online fler. Invantives funktioner för parallell bearbetning inom eller mellan administrationer användes inte.

Avstämningsfasen tar cirka 17 sekunder (plus/minus 2 sekunder), medan laddning och validering av kunder tog cirka 500 ms per kund (plus/minus 200 ms).

Den initiala laddningen av 1 000 kunder tar alltså cirka 10 minuter. Med 10 nya kunder per dag och daglig synkronisering skulle kundregistret i Visma.net och Exact Online vara uppdaterat inom 30 sekunder.