研修 · レッスン6

システムをどう話させますか?

二つのシステムの間に接続を置いても、それだけで二つが同じ記録を同じ意味で持つようにはなりません。このレッスンでは連携地図を埋めます。どの項目がどちらの向きに移るのか、書式がどう変わるのか、同じ記録がどうすれば二つに割れないのか、接続が切れたとき仕事は誰のところで待つのか。

このレッスンで学ぶこと

第五レッスンで最初の流れを組み、連携は設置カードの一行でした。このレッスンはその一行を開きます。二つのシステムが互いを理解することは、間に接続を置くことと同じではありません。どの項目がどちらの向きに移るのか、書式がどう変わるのか、接続が切れたとき誰が待つのかが書かれてはじめて、取り決めが立ちます。

レッスンは特定の道具のコネクタ画面をたどりません。扱うのは連携地図です。接続を組む前に埋め、組んだあとも手元に残る記録です。地図が手元にあれば、どの道具で接続を組んでも同じ問いが答えの付いた形で出てきます。

レッスンの目標

  • 連携地図を六つの列で埋める
  • 項目の組ごとに向きと出どころを記す
  • 書式変換を当て推量に委ねずに書く
  • 重複判定キーを選び、衝突の規則を決める
  • 初回移行と継続同期を別々に決める
  • 接続が切れたとき誰が待つのか、手作業の代わりは何かを書く
  • 空、通常、例外の三つの通しで接続を試す

前提:第三レッスンの項目辞書と第五レッスンで組んだ流れです。項目辞書がなければ対応表は書けません。突き合わせる項目の定義がまだないからです。

連携とは何で、何ではないか

連携とは、二つのシステムが同じ記録を同じ意味で持っていることです。接続が置かれているだけではそれは得られません。両側が同じ項目を同じ意味で読むとき、記録は本当に共有されます。

実務ではこの区別は一つの問いで測られます。ある記録を二つのシステムで並べて開いたとき、二つは同じことを言っていますか。答えがいいえなら、接続は動いていても連携は立っていません。この状態は誤りも出しません。どちらのシステムも自分の中では筋が通って見えるからです。

連携であるもの

項目を互いに定義し、向きを選び、書式を変え、同じ記録を二つに割らないこと。いずれも書き出せる決めごとです。

連携でないもの

二つのシステムの間に接続を置いて、データが流れるのを眺めること。流れるデータが正しく読まれているかは別の問いで、ひとりでには答えが出ません。

境目のしるし

項目を突き合わせている途中で手が止まり、相手側ではこれを何として数えているのだろうと考えるたび、そこに地図の一行が欠けています。欠けた行は最初の例外的な記録で表に出ます。

連携地図:六つの列

地図は一ページに収まり、各行が項目の一組を説明します。六つの列は接続を組むときに問われる六つの問いに対応します。ある列が空のままなら、その項目の振る舞いは道具に委ねられたことになります。

接続を組む前に地図を埋めるのと、組んだあとに埋めるのは別の仕事です。先に埋めれば欠けは紙の上に出てきますが、あとから埋めると道具が生んだ振る舞いが記録され、誤った振る舞いも正しい顔で地図に入ります。

地図の六つの列

  • 出どころのシステムと項目:記録はどこで生まれるか
  • 行き先のシステムと項目:記録はどこに書かれるか
  • 向き:片方向か、双方向か
  • 書式変換:同じ値を両側はどう書くか
  • 空で届いたら:項目が空の間、行き先に何が入るか
  • 食い違ったら:両側の値が違うときどちらが残るか

最後の二つの列はたいてい最後に埋められますが、本当は最初に問うべき列です。空の値と食い違いは、連携が静かな誤りを生む二つの場所です。

向き:出どころのシステムと写しのシステム

項目の組ごとに、一方は記録が生まれる場所で、もう一方はその写しです。出どころを選ぶのは好みではなく確認です。項目が最初にできる場所が出どころです。写しは記録を運ぶのであって、変えるのではありません。

双方向も組めますが、代償があります。両側が書けるようになると食い違いの見込みが生まれ、衝突の規則が書かれていなければ最後に書いた側が勝ちます。誰が最後に書くかはたいてい時点次第なので、結果は見通しにくくなります。

出どころのシステム

項目が最初に生まれる場所。直しもここで行われます。写しで行った直しは、次の移送で戻されることがあります。

写しのシステム

見せるため、また自分の仕事を進めるために記録を持つ側。写しの項目を読み取り専用と見なすと、チーム内の議論は短くなります。

双方向

両側が書ける項目。衝突の規則が書かれているときにだけ組みます。規則がなければ項目は片方向に寄せられます。

項目の対応:同じもの、違う名前

二つのシステムは同じ情報を違う名前で持っています。対応表はその名前を並べますが、本当の仕事は名前ではなく定義を突き合わせることです。同じ名前の二つの項目が違うことを指している場面は、違う名前の二つの項目が同じことを指している場面より多く出てきます。

第三レッスンの項目辞書がここで効いてきます。項目の意味が書かれているので、対応の話は定義の上で進みます。辞書がなければ、対応づけは二つの画面を並べて似て見える枠をつなぐ作業になります。

対応表が埋まると、二つのシステムの間に語られない項目は残りません。語られない項目とは、移送の中を静かに空で通り過ぎる項目です。

書式変換:日付、電話、金額、氏名

二つのシステムが同じ値を違う書き方で持つことがあります。日付の並び、電話の頭の番号、金額の区切り記号、氏名の大文字小文字は、移送が静かに壊れる古典的な場所です。この壊れは誤りを出しません。行き先のシステムが届いた値を自分の規則で読み解けるからです。

変換を誰が行うかは地図の上で答えられます。出どころ側か、移送の途中か、行き先側か。三つとも使えますが、選びが書かれていないと変換は二か所で行われ、値は二度変わって壊れます。

日付と時刻

並びと時間帯は別々の問いです。同じ日が二つの日にまたがることがあり、月と日が入れ替わっても記録は有効に見えるので気づかれません。

電話と識別子

国番号、空白、区切り記号。重複判定キーが電話なら、書式の違いが同じ人を二つの記録に割ります。

金額と単位

小数の区切り、桁の区切り、通貨。単位を伴わない金額は、行き先で読み解かれるときに既定値へ落ちます。

変換の規則が地図の一行に収まるなら、それは十分に明快です。一行に収まらない規則は、たいてい二つの規則が混じったものです。

重複判定キー:同じ記録が二度

移送がもっとも多く生む結果は、同じ記録が行き先で二つに割れることです。理由はたいていこうです。システムは届いた記録が前に書かれたかどうかを知るためにキーを見ますが、そのキーが選ばれていないか、両側で同じ形になっていません。

キーを選ぶのは第三レッスンの主題でした。ここではキーが二つのシステムで同じ形になっていることを確かめます。キーが出どころでは空白入り、行き先では空白なしで持たれていれば、二つの記録は違って見え、行き先に重なった記録ができます。

キーについての三つの問い

  • キーは二つのシステムで同じ形になっていますか
  • キーは時とともに変わりますか。変わったとき古い記録はどうなりますか
  • キーが空で届いた記録はどうしますか。書きますか、留め置きますか

重なった記録は静かな誤りです。報告は合計を膨らませ、お客さまには二度連絡が行き、しばらくすると二つの記録のどちらが今のものか見分けられなくなります。

速さ:即時、待ち行列、まとめ

記録がいつ移るかは、何が移るかと同じだけ大事です。即時の移送はもっとも目につく選びですが、どの仕事も即時の移しを求めるわけではありません。遅れが受け入れられる場所では、まとめての移送のほうが動く部品が少なく回ります。

速さを選ぶのは速度の好みではなく、待ちの好みです。移送が遅れたとき誰が待ち、その人は遅れに気づきますか。気づかれない遅れは不具合としてではなく「データが違う」として戻ってきます。

1 即時の移送

記録はできた時点で移ります。相手が答えないときどうなるかが書かれていないと、記録が宙に浮いたまま残ることがあります。

2 待ち行列の移送

記録は列に書かれ、順に移ります。切れた時点では列が待ち、接続が戻れば止まった場所から続きます。

3 まとめての移送

決まった間隔でまとめて移ります。遅れが受け入れられる場所ではもっとも素朴な選びで、移送の時間帯はチームに知らせます。

既存のデータ:移すのか、置いていくのか

接続を組むときにもっともよく飛ばされる問いはこれです。今日までに積み上がった記録はどうなりますか。ここには別々の二つの仕事があり、混ぜると二つとも半端に終わります。初回移行は一度きりの移しで、継続同期はその後を進めます。一方が終わり、もう一方が始まり、規則が同じである必要もありません。

既存のデータを移すことがいつも要るわけではありません。「今日から」始めるのも有効な選びで、試行の多くにはそれで足ります。古い記録は自分のシステムに残り続けます。移すと決めたなら範囲を書きます。どの日付から、どの状態の記録まで、終わった案件を入れるかどうか。

初回移行の行に書くこと

  • 範囲:既存のデータを移すか、移さないなら始める日
  • 日付の幅:どの日付から
  • 状態の絞り:終了、取消、保管の記録を入れるか
  • 重なりの洗い出し:キーの形を二つのシステムで揃えたか
  • 巻き戻し:外れた移行を行き先からどう取り除くか

初回移行は重複判定キーにもっとも強く迫る時です。一件ずつ届く記録では見過ごされる書式の違いが、まとめて移すときには重なりもまとめて生み、その数は人が手で片づけられる線を越えることがあります。

ですから初回移行は試験データではなく実データで行い、巻き戻せることが望まれます。まず狭い日付の幅を移し、結果を二つのシステムで見比べ、重なりが出なければ残りが続きます。移した記録に印をつけておくことが、外れた移行を行き先から取り除けるようにします。

接続が切れたとき誰が待ちますか

どの接続も時おり切れます。レッスンはその見込みをなくすことを勧めるのではなく、切れたとき仕事がどこで止まるかを書くことを勧めます。書かれていない切断は、不具合としてではなく、数日後に気づかれる欠けとして現れます。

地図の切断の行は三つを抱えます。待つ人、手作業の代わり、巻き戻しです。この三つが書かれていれば切断は遅れとして扱えます。書かれていなければ、切断は静かにデータの失われに変わることがあります。

切断の行に書くこと

  • 誰が待つか:仕事が終わらないまま残る人の名前
  • 知らせがどこへ行くか:人へか、共有の受信箱へか
  • 手作業の代わり:接続がない間、同じ仕事がどう進むか
  • 巻き戻し:半分だけ移った記録を行き先からどう戻すか
  • 切断の控え:切断とその長さをどこに書き留めるか

半分だけ移った記録は、まったく移らなかった記録より気づきにくいものです。行き先には記録が現れているので、欠けは誰かが使うときにはじめて表に出ます。

権限とアクセス:どの利用者が何を見るか

接続はある利用者の資格で組まれ、その資格が見えるものすべてが相手側に開くことがあります。組むときにもっとも広い権限の資格を使うと仕事は速くなり、あとで誰も狭めない扉が残ります。

資格が人ではなく仕事に属しているかは別の話です。個人の資格で組まれた接続は、その人が去ると静かに止まり、止まった理由は接続そのものの中に探されます。

アクセスの行に書くこと

  • どの資格で接続が組まれ、その資格は誰のものか
  • その資格はどの記録を読め、どの記録を書けるか
  • 権限をいつ見直すか
  • 接続を閉じるならどのアクセスを戻すか

第三レッスンで書いたアクセスの規則がここで二度目に試されます。辞書で読む人が書かれていた項目が、連携を通して別のシステムに開いているかもしれません。

連携を試す:三つの通し

接続を組んだあとの確かめは、記録を一件移して結果を見るだけでは終わりません。三つの通しを一緒に行うと、地図の行の多くが確かめられます。

確かめは試験データで行い、試験の記録は名前で見分けられるようにします。実データで行う確かめは、行き先のシステムに片づけるべき跡を残します。

1 空の通し

必須でない項目を空にした記録。空の値が行き先で何になるかを示します。空のまま残るのか、既定値が書かれるのか、記録が拒まれるのか。

2 通常の通し

日々の仕事の典型的な記録。項目の対応と書式変換を並べて開き、見比べるために使います。

3 例外の通し

長い氏名、別の書式の電話、同じキーの二件目の記録。重複判定と衝突の規則を試す通しです。

三つの通しの結果は地図の脇に書きます。試していない行は、組まれたとは数えません。

端から端までの例:不動産事務所がつなぎます

前のレッスンで事務所は試行の仕事を選び、流れを書き、項目辞書を作り、道具を選び、最初の流れを組みました。今は物件システムと追客表が互いを見ておらず、同じ問い合わせが二か所へ手で入力されています。

事務所は地図を埋めることから始め、最初の行でもう話が分かれます。電話番号はどのシステムで生まれるのか。物件システムに入る問い合わせにも電話があり、追客表にもありますが、二つは違う形で持たれています。

事務所が埋めた最初の行

出どころは物件システムの問い合わせ記録とし、追客表は写しとして受け入れます。電話の項目は書式変換を移送の途中で行い、一つの形に寄せます。重複判定キーは電話にします。同じ人が別の物件から書いてくることがあるからです。

空の値の行はこう書きます。電話が空なら記録は追客表に書かれず、待ちの一覧に落ち、事務所の担当が一日の終わりにその一覧を見ます。食い違いの行では出どころ側を上に置きます。追客表で手で行った直しは、電話の項目ではなく覚え書きの項目へ入れます。

速さはまとめての移送にします。問い合わせを届いた時点ではなく一日に何度か移すことで仕事には足りるからです。切断の行では待つ人を事務所の担当と書き、手作業の代わりとして以前の入力の仕方を開けたままにします。

追客表にはすでに記録がありましたから、初回移行の決めも合わせて下します。事務所は過去のすべてを移すのではなく、近くて開いている問い合わせを取ります。終わった案件は外に残します。追客表での相手はもう閉じているからです。移行はまず狭い日付の幅で試し、二つのシステムで行の数を見比べます。最初の試しで重なりが出ます。電話の形がまだ揃っていません。変換を直して移行をやり直し、移した記録には目印を付けます。この目印のおかげで、外れた移行を行き先からまとめて取り除けます。

三つの通しの確かめでは、例外の通しが欠けを一つ捕まえます。同じ電話から二件目の問い合わせが来ると、追客表に新しい記録が開きます。キーの規則を直し、二件目は同じ人の下に覚え書きとして入ります。

練習:今週すること

今週は接続を一つだけ地図に写してください。新しい接続を組む必要はありません。すでに動いている移送の地図を描くことも同じ働きをし、たいてい欠けた行をいくつか出してきます。

連携地図をダウンロード(xlsx) · 項目の対応、向き、書式変換、初回移行、切断時の振る舞いを埋めさせる一ページの地図。三つの通しの確かめも入っています。

よくある間違い

下の間違いは接続そのものからではなく、地図が埋まりきらなかったところから出てきます。共通するのはこれです。どれも誤りの知らせを出さずに動きます。

向きを書かずにつなぐ

両側が書けるようになると最後に書いた側が勝ちます。手で行った直しが次の移送で戻されることがあり、理由は道具の中に探されます。

キーを元の形のままにする

同じ電話が二つの形で持たれていると、行き先に記録が二つできます。重なった記録は報告も、お客さまに届くことも損ないます。

空の値を道具に委ねる

空の項目が行き先で既定値に落ちることがあります。既定値は埋まった値のように見えるので、あとから見分けられません。

切断を書かない

移送が止まったとき待つ人が決まっていなければ、欠けは数日後にお客さまの問いとともに表に出ることがあります。

実データで試す

試験の記録を実データから選ぶと、行き先に片づけるべき跡が残り、片づけはたいてい半分で終わります。

地図をあとから埋める

組んだあとに書かれた地図は、道具が生んだ振る舞いを書き留めます。誤った振る舞いも同じ道筋で正しいものとして残されます。

確認の一覧

本番に入れる前に、この一覧のどの項目にも答えられるなら、地図は埋まったと数えます。

本番に入れる前に

  • どの行にも出どころ、行き先、向きが書かれている
  • 書式変換が要る項目に印があり、変換の場所が選ばれている
  • 重複判定キーが二つのシステムで同じ形である
  • 初回移行の範囲、日付の幅、巻き戻しの道が書かれている
  • 空の値のときの振る舞いが項目ごとに書かれている
  • 衝突の規則が書かれ、チームも知っている
  • 接続を組んだ資格が人ではなく仕事に属している
  • 待つ人、手作業の代わり、巻き戻しの道が書かれている
  • 三つの通しを試験データで行い、結果を書き留めた
  • 試験の記録を行き先のシステムから片づけた

用語

連携の話に出てくる言葉です。接続を組む人と同じ言葉を使うと、地図を埋める時間は短くなります。

次に来るもの

このレッスンで二つのシステムを話させました。項目を突き合わせ、向きを選び、書式を変え、既存のデータを移すかを決め、切れたときの振る舞いを書きました。次のレッスンはこの秩序を続けることを扱います。例外を扱い、チームを流れに入れ、結果を測ることです。

すでに出ているレッスンから続けたい場合は、移送が思ったとおりに動かないときどこを見るかを伝えるモジュールが次に来ます。

レッスン7: 自動化が動かないと言うとき

静かな不具合、不具合カード、半分に分ける方法、長もちする直し。

レッスン5: 最初の自動化を組み立てる

設置カードと五つの部品。このレッスンが開いた連携の行はそこにあります。

すべてのレッスン

研修の部分の全体と、その後に加わったモジュール。

二つのシステムをつなぐ前に地図を一緒に埋めたい場合は、ご連絡ください。

WhatsAppでお見積もり

よくあるご質問

連携のためにコードを書く必要がありますか
選んだ道具によります。このレッスンの地図はコードを書かずにも埋められます。扱っているのはコネクタの使い方ではなく、二つのシステムの間に何が書かれているべきかです。地図が手元にあれば、どの道で接続を組んでも同じ問いに答えが出た形になります。
出来合いのコネクタがあるとき、地図は要りますか
出来合いのコネクタは自分の前提で項目を突き合わせ、その前提は画面に現れません。地図はその前提がお仕事に合うかどうかを見せます。合わない場所はたいてい空の値の行と食い違いの行に出てきます。
二つのシステムは互いに書き合えますか
衝突の規則が書かれていれば書き合えます。規則がないと、同じ項目を両側が更新したとき最後に書いた側が残り、手で行った直しが次の移送で戻されることがあります。規則が書けないなら、項目を片方向に寄せるほうが驚きは少なくなります。
同じ記録が行き先でなぜ二つに割れますか
たいていは重複判定キーが選ばれていないか、二つのシステムで違う形になっています。片側では空白入り、もう片側では空白なしで持たれる電話番号は、同じ人を二つの別々の記録として見せます。キーの形を揃えることで、重なった記録の多くはなくなり得ます。
接続が切れるとデータは失われますか
移送の速さによります。待ち行列の移送では記録が列で待つので、接続が戻れば止まった場所から続きます。即時の移送では、相手が答えないときどうなるかが書かれていなければ記録が宙に浮いたまま残ることがあります。地図の切断の行はまさにそのために埋めます。