Exact OnlineをVisma.net Financialsと同期する

英語版を見る

概要

1つのステートメントで、Exact Onlineの管理データのすべての取引先をVisma.net Financialsの管理データと同期させます。SQLステートメント1つによる同期(単方向・双方向いずれも)に関するこの2本目の記事では、実践的な同期タスクを取り上げます。

Exact Onlineの取引先からVisma.net Financialsの顧客への同期

Invantive SQLにおけるグローバルなイノベーションにより、アプリケーション間での(単方向・双方向いずれの)データ同期を1つのステートメントで実現できます。このコンセプトと文法については、Synchroniseer uw gegevens met één SQL-statement over meerdere cloudplatformen heen で紹介されています。

この記事では、Exact Onlineの管理データ内のすべての取引先が、Visma.net Financialsの管理データに顧客として存在するようにするための実践例を示します。

Exact OnlineからVisma.net Financialsへの単方向同期の実装には、Invantive SQLステートメント1つだけが必要です。システム間で明確な用語と一貫したマッピングを用いることが重要です。特に、Exact OnlineとVisma.net Financialsの英語版では用語の意味が異なるため、なおさらです。

  • Exact Onlineでは、「account」(取引先)という用語は、実行主体である企業との(将来的な可能性も含む)法的な取り決めにおける相手方を指します。一方、Visma.netにおける英語の「account」という用語は、総勘定元帳の勘定科目を指します。
  • Visma.net Financialsでは、「顧客(klant)」は、製品の譲渡に関する法的な取り決めにおいて顧客として機能する特定の取引先リストを指します。「顧客」とは別に、独立した仕入先リストが存在しますが、Exact Onlineではすべての顧客、仕入先、見込み客などのその他の取引先が、ほぼ1つのテーブルで一括管理されています。

機能的なマッピング

このケースでは、マッピングは非常にシンプルです。

Exact Onlineでは、ソースは取引先です:

Visma.net Financialsでは、結果は次のようになる必要があります:

基本的に、マッピングは以下のとおりです:

  • Exact Onlineの取引先は、Visma.netの「Reference(参照)」フィールドの値によって、ちょうど1つのVisma.net仕入先として識別されます。
  • 取引先の参照は、元のシステムを示すために「EOL-」で始まります。
  • 取引先名は、Exact Onlineからそのまま引き継がれます。

両システムともUnicode文字セットのかなり広い範囲をサポートしているようであるため、文字を変換する必要はありません。また、送信元システムであるExact Onlineでは取引先名が50文字に制限されている一方、Visma.netでは最大60文字まで許可されているため、文字の切り詰めも不要です。

Exact Onlineの取引先リストを顧客、仕入先(重複の可能性あり)、その他に分割する処理については、本記事では扱いません。そのようなマッピングの基準はドキュメントに記載されています。

また、更新処理(ステートメントに「or update」を追加するだけです)や、顧客の削除(Visma.netはAPI経由での顧客削除をサポートしていません)も対象外です。

実装

この同期処理は、両システムに対するフルアウタージョインを用いたselectからVisma.net Financialsへのinsertとして記述することもできます。しかし、synchronizeステートメントを使えば、より簡単になります:

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

いくつか補足します:

  • use文では、1つのExact Online管理データと1つのVisma.net Financials管理データを選択しています。複数のExact OnlineまたはVisma.net Financials管理データを選択するには、項目を追加するか、1つ以上のselectクエリ、または特殊な名前allやdefaultを使用します。

  • インメモリテーブルexactaccountsは、Exact Onlineの概念からVisma.net Financialsの概念へのマッピングを示すための一時テーブルです。例えば、Visma.net Financialsにおける取引先番号は、テーブル内ではテキストとして扱われます。このインメモリテーブル用のクエリは、取引先名の切り詰め、接頭辞の追加、大文字への変換などを行うのに適した場所となります。

  • synchronizeステートメントは、insert文を使用してVisma.net Financialsに顧客をロードします。ignore nulls句が必要なのは、Visma.netの「Reference」フィールドには、手動で入力された顧客についておそらくいくつかnull値が含まれており、したがってreferenceがVisma.netの顧客テーブルにおける完全に網羅的な一意キーではないためです。

  • eolnlとvismanetは、以下のsettings.xmlの内容を持つ分散データベース上で定義された2つのデータコンテナです(もちろん、オンプレミス以外であれば、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>

パフォーマンス

同期処理のパフォーマンスは、以下の要因に左右されます:

  • Exact OnlineおよびVisma.netにおける現在の顧客数: synchronizeステートメントは、両方の顧客リストを突き合わせる必要があります。これは、Invantive Data Replicatorによって駆動されるSQL Serverデータベース上の既存のレプリカから行う場合もあれば、2つのクラウドプラットフォームからリアルタイムでデータをダウンロードして行う場合もあります。もちろん、OracleやPostgreSQLなど、他のInvantive Data Replicator対応プラットフォームも使用できます。
  • 交換する顧客数: 交換するデータ量が増えるほど、処理時間は長くなります。
  • バルクロード機能の有無: synchronizeステートメントは、SQL Serverなどのプラットフォームでバルクインサートが利用可能な場合はそれを優先しますが、利用できない場合は1件ずつのインサートにフォールバックします。

Visma.net Financialsには現在バルクインサート機能がなく、このテストではInvantive Data Replicatorおよび各種キャッシュ機構は無効化されていました。テスト開始時点で、Visma.net Financialsには約5,000件の顧客が、Exact Onlineにはそれ以上の顧客が存在していました。管理データ内または管理データ間でのInvantiveの並列処理機能は使用していません。

突き合わせ(reconciliation)フェーズには約17秒(プラスマイナス2秒)かかり、顧客1件あたりのロードと検証には約500ミリ秒(プラスマイナス200ミリ秒)かかりました。

したがって、初回の1,000件の顧客のロードには約10分かかります。1日あたり10件の新規顧客が発生し、毎日同期を行う場合、Visma.netとExact Onlineの顧客データは30秒以内に最新の状態に保たれることになります。