列名と文字コードが合っていても、既存の値を何で置き換えるかが曖昧なままでは取り込みを判断できません。入力データと既存台帳を読み取り、新規候補・更新候補・未確定を先に見える形にします。
この記事の差分票は利用者側で作る運用例です。AtlasにCRMの自動同期や取り込みプレビュー機能があるという説明ではありません。以下の入力、社名、キー、CRM記録IDはすべて架空で、CRMへの接続・書き込みは行っていません。
1. 法人キーと、書き込み先の記録IDを分ける
最初に法人・部署・担当者のどの記録を扱うかを固定します。CRMへ渡す列設計で決めた関係と対応表を使い、今回の入力列、比較対象のCRM列、更新を認める範囲を記録します。
法人を照合するキーと、CRM内の記録IDは別です。実運用で法人番号を使う場合は文字列で保持し、対象法人との対応も確認します。番号の未確認や同じキーに複数の記録IDがある状態を、名称の似た一件へ自動的に寄せません。
比較する入力と既存台帳に版・作成日時を付け、原ファイルは保存します。台帳に一致がない行も、確認した範囲での新規候補です。別の台帳や部署に存在しないことまで証明したわけではありません。
2. 空欄・未提供・消去依頼を区別する
空欄をどう取り込むかはCRMや設定、取り込み方法により確認が必要です。次は本稿の比較票にだけ適用する社内ルール例で、CRMが実際に行う動作ではありません。
| 入力の状態 | 今回の比較票の扱い | 次に確認すること |
|---|---|---|
| 値が空欄として渡された | 意味が未確認なら保留 | 値を消す、無視する等の実際の仕様と更新方針 |
| 項目そのものが未提供 | 更新候補へ含めず元値を保持 | 入力に列や項目がないことを確認し、空欄へ変換しない |
| 別の列で明示的な消去依頼がある | 消去方法と承認が未確認なら保留 | 対象列、消去の影響、戻し方、取り込み先での指定方法 |
CSV上では見分けがつかない場合もあります。空欄の意味を出力元や変換前の記録から確認できなければ、推測して分類しません。消去依頼の専用列も利用者側の管理用で、AtlasやCRMのAPI引数を示すものではありません。
3. 架空五行から、書き込み前の候補を作る
説明用の法人キーDEMO-Aなどは実在する法人番号ではありません。CRM-A01などは架空のCRM記録IDです。既存台帳五記録と入力五行をローカルで照合し、次の候補表を作りました。
| 入力と法人キー | 照合と差分 | 主な出口 |
|---|---|---|
| IN01・DEMO-A | CRM-A01に一致。所在地欄は東京都→神奈川県。メモは未提供 | 更新候補 |
| IN02・DEMO-B | 今回の台帳に一致なし。新規用の社名・所在地欄を確認 | 新規候補 |
| IN03・DEMO-C | CRM-C01のメモ「要再確認」に対し、入力は空欄 | 未確定 |
| IN04・DEMO-D | CRM-D01のメモに消去依頼あり。消去方法と承認は未確認 | 未確定 |
| IN05・DEMO-E | 同じ法人キーにCRM-E01とCRM-E02の二記録が対応 | 未確定 |
入力五行=新規候補一行+更新候補一行+未確定三行です。各入力行に主な出口を一つ付け、補助理由は別に持たせます。台帳五記録という数と入力五行は別の数であり、候補を数えて登録済み件数とは呼びません。
IN01のメモは入力に項目がないため、今回の更新案へ含めず「前回の確認を保持」を残しました。所在地の差分も変更案にとどまります。実検算では元入力と既存台帳のハッシュが前後で一致し、CRMへの実書き込みはゼロでした。
4. 列ごとの変更案を承認し、実施結果を別に残す
候補表には元行ID、法人キー、CRM記録ID、対象列、元値、候補の新値、入力の状態、根拠の場所・確認日を並べます。元値を新値で消さず、未確定の理由と追加確認の担当も残します。
- 新規候補は、対象範囲での重複確認や必須条件を確認してから、登録するかを判断する。
- 更新候補は、変更してよい列と根拠を責任者が確認し、承認・差戻し・保留を記録する。
- 承認後も実施済みとはせず、実行者・実行日時・結果・取り込み先のIDを別に記録する。
- 実施前に既存値と承認した元値を再照合し、値や対応先が変わっていれば再比較・再承認する。
未確定三行は空欄へ統一せず、それぞれ必要な確認を終えるまで書き込み対象から外します。今回の検証は読み取り専用の候補作成までで、実際の取り込み成功や取り消し操作を試した結果ではありません。
5. 変更案を作る依頼と、相談前の整理
取得済み入力と既存台帳から、書き込み前の差分票を作ってください。元データは変更しません。
法人キーとCRM記録IDを区別し、複数候補を自動選択しないでください。
新規候補、更新候補、未確定に分け、対象列、元値、新値候補、根拠、承認状態を残します。
空欄・項目未提供・明示的な消去依頼を同じにせず、意味が未確認なら保留します。
入力行数と出口別の合計を検算し、追加取得、外部送信、CRM書き込みは行いません。必要な列が今回の出力に含まれるかは収録範囲と実行時の入出力仕様を確認します。表示の問題や列の不足を、新規取得すれば必ず解消できるとは限りません。取得枠・再取得の扱いも確認してください。
公式仕様と関連記事・リンクの確認日:2026-11-05(日本時間)。特定CRMの動作は本稿で確定していません。必要な出力項目や連携範囲は、個人情報を含まない列見本、更新キー、保留理由を用意してAtlasへ相談するからお知らせください。



