お客様の社内のデータや既存の仕組みに、新しい仕組みをどうつなぎますか

先に確かめること

お客様の社内の仕組みは、ほかの部署や外の会社が持っていることもあり、こちらの都合だけでは触れません。つなぐ前に、お客様の担当と次の点を確かめます。

• 持ち主その仕組みをだれが持ち、変えるときにだれの許しが要るか
• 使ってよい範囲 1 日に何回、どの時間帯なら取りに行ってよいか。夜の締めの処理と重ならないか
• 止まり方定期の止めはいつか。止まったとき、相手は何を返すか
• データの扱いどの欄まで受け取ってよいか。個人の情報を含むか

ここを飛ばすと、あとで「勝手に取りに来ている」と止められたり、相手の夜の処理を重くしたりします。

つなぎ方の順番

つなぎ方は、相手への負担と壊したときの怖さが小さい順に選びます。

API が無い古い仕組みでも、毎晩ファイルを書き出す機能を持つことがあります。まずはそのファイルを決まった置き場で受け取る形から始めると、相手の仕組みに手を入れずに済みます。相手のデータベースに直に入って読むのは、相手の持ち主が読み取り用の入り口を用意してくれた場合に限ります。

本番に直に書かない

試作の段階で、お客様の本番の仕組みに直に書き込むのは避けます。書き込みが要るときは、まずこちらの側に結果をためて、お客様の担当が見てから手で取り込む形にします。直に書き込むのは、取り込みの手順と戻し方が決まり、相手の持ち主が認めてからです。

つなぎ目の記録と止まったときの振る舞い

つなぎ目では、いつ、どの相手から、何件を受け取り、何件をはじいたかを記録します。数字が急に減ったり、同じファイルが 2 度届いたりしたときに、どちらの側の問題かをすぐに切り分けられます。

相手が止まったときの振る舞いも先に決めます。たとえば、取りに行けなければ前回のデータのまま動き、画面に「何時のデータか」を出す、何度か試してだめなら担当に知らせる、のようにします。同じデータを 2 度受け取っても結果が変わらない作りにしておくと、やり直しが安全になります。

トレードオフ

書き出しのファイルで始めると、相手の仕組みに触れずに早く進められますが、データは 1 日遅れになり、即時の業務には向きません。API で即時につなぐと新しいデータで動けますが、相手の許しと止まったときの備えが要り、始めるまでに時間がかかります。最初は遅れを受け入れてファイルで始め、業務に即時が要ると分かってから API へ移す、という順番が多くの現場で通ります。