CSVインポートは「インポート」ボタンの前から始まる
CSV列のマッピング、変更プレビュー、更新対象の識別を設計します。カタログに保存する前に、利用者が取り込みの結果を把握できるようにします。
記事の言語: 日本語

目次
ファイルに十二行あるからといって、新商品が十二個あるとは限らない。架空のインポートでは、三件を作成し、四件を更新し、二件は変更せず、三件は確認が必要だ。「12商品をインポート」という表示は、利用者が判断する前にこれらの違いを消してしまう。
CSVは表を渡すための形式であり、インポートはデータを変更する操作だ。保存前に、列の意味、レコードの同一性、予想される結果を把握する必要がある。「ファイルは有効」というメッセージだけでは、幅が正しい単位で保存されるか、空欄が以前の説明を消すかは分からない。
架空の作業場設備カタログへのインポートを設計する流れを見ていく。例の数値と状態は判断を説明するためのものであり、実装や事業者のサービスを試した結果ではない。受け取った表から、利用者が結果を理解して変更を受け入れるまでの道筋を考える。
選んだファイルはまず読み解く対象
最初の画面では、どのカタログや表にデータが入り、インポートで何ができるかを示す。「新しい項目を追加」と「既存の項目を更新」では範囲が違う。両方を同時に行える製品なら、最後のボタンを押す前に利用者が区別できなければならない。これは作業の一部であり、管理者向けの高度な設定ではない。
供給者のファイルには「コード」「説明」「幅」「状態」という列があるかもしれない。どれも見慣れているが、「状態」は在庫数かもしれず、物の技術的な状態かもしれない。取り込み先フィールドの分かりやすい名前と値の例が、その違いを見つける助けになる。似た見出しをもとにした自動割り当ては、確認する提案として扱いたい。
マッピング前に、アプリケーションがファイルをどう分割して読んだかを示す。最初の行を見出しとして読んだか。ポーランド語の文字は保持され、説明文内の区切り文字によって値がずれていないか。利用者は、文字の保存方法であるエンコーディングを知らなくても、その結果を把握できるべきだ。行全体が一列に入ったなら、その列を適当なフィールドに手動で割り当てて先へ進ませてはいけない。
見出しは手がかりであって、データが正しい証拠ではない。最初の列の名前が「ID」でも、中身は表の連番かもしれない。カタログには独自の識別子の定義が必要だ。商品データモデル (ポーランド語)ではこうした概念を事前に定める。インポート機能はファイルごとに新しい定義を作るのでなく、それを使うべきだ。
プレビューの範囲も分かるようにする。「5行のサンプル」と「ファイル全体を確認済み」では意味が違う。アプリが先頭だけを表示するなら、表のそばに明記する。一部が画面にうまく収まったというだけで、全体に緑の状態を付けてはいけない。全体の確認には、定めた範囲を実際にすべて扱う仕組みが必要だ。
ファイルを差し替えるときは、新しい資料を明確に識別し、前回の確認結果を無効にする。以前のマッピングが役立つことはあるが、現在の列と照合しなければならない。ファイルAの名前でBのプレビューを見たり、古い確認結果を新しいものとして受け取ったりさせてはならない。画面をバックグラウンド処理につなぐ前に、この状態を図にしておきたい。
マッピングは見出しだけでなく意味をつなぐ
元の各列について、選択された取り込み先フィールド、複数の値、意図的に除外する選択肢を示す。必須フィールドには何が不足しているかの説明が必要だ。ファイルに適切な情報がないなら、修正した資料を用意するために戻ることが正しい終了になる場合もある。フォームを完成させるために適当な列を割り当てるよう強いる必要はない。
Atlassianは新しいJira Cloudインポートの自動・手動列マッピングを説明している(英語)。自動割り当ての確認を勧め、マッピングされていない列は除外されると説明する。ファイルに情報があることと、システムに取り込まれることの違いを示す具体例だ。
例のカタログでは「幅」を商品の幅をセンチメートルで記録するフィールドに入れる。供給されたファイルの値はミリメートルで、入力の120mmは12cmに相当する。フィールドを選んだだけで既定の変換が黙って始まってはいけない。変換機能があるなら、プレビューに変換前後の値を示す。ないなら、単位名だけで一致したふりをせず、資料で必要な修正を伝える。
数値にはコンマ、精度、許容範囲も重要だ。数値入力欄の設計 (ポーランド語)は入力の解釈を決める助けになるが、インポートはその解釈を列全体に適用する必要がある。「12,5」という例では、アプリが十二と二分の一として受け取ったのか、別の表記として読んだのかが分かるようにする。入力の横に結果を示せば推測しなくて済む。
選択肢の値には別の対応付けが必要だ。表の「準備済み」はカタログの「公開準備完了」に対応するかもしれないが、必ずしも「公開済み」ではない。どの値を既存の選択肢に変換し、どの値に判断が必要か示す。新しい選択肢を自動作成することも、チームの作業構造を変える。すべての言葉を受け入れる方が簡単だからという理由だけで行ってはならない。
列を除外することと、その列のセルに値がないことを分ける。説明を更新するとき、空欄は「新しい情報がない」かもしれず、「既存の内容を消す」かもしれない。利用者は作業に合うルールを選ぶ必要がある。以前の説明が空ではない具体的なレコードで結果をプレビューできれば、さらによい。
Shopifyは商品を上書きする際、必須でない列の空欄と列そのものの省略を区別している(英語)。前者は既存値を空にすることがあり、後者は維持することがある。文書はフィールド間の依存関係も説明する。自社のインポートでも、すべての空欄が無害に見えるようにせず、ルールを明らかにする必要がある。
更新には同一性の基準が必要
例のカタログにはコードPR-014の商品が既にある。インポートが同じバリエーションを対象とするなら、幅の変更を提案できる。新商品の名前が似ているだけでは、そのレコードを更新する根拠として足りない。プレビューには一致の根拠と識別できる対象を示し、何が置き換わるか利用者が確認できるようにする。
AirtableのCSV import extensionでは、既存レコードと結合するフィールドを選べる(英語)。説明されたルールは大文字と小文字を区別し、キーが空なら新しいレコードが作られる場合がある。これはその拡張機能の動作であり、すべてのインポートに当てはめてはいけない。ただし、キーの選択や欠落が実際にどう影響するかを示している。
画面には新規レコード、更新、未確定のケースを別々に表示する。「似たものが見つかった」は、まだ「上書きする」という決定ではない。AIによるレコード照合の評価 (ポーランド語)では、この境界に別の根拠が必要だ。ここでは提案を作った方法にかかわらず、人が特定の提案を理解して受け入れる瞬間を設計する。

ファイルの二行が同じ商品を指すこともある。拒否するのか、一つにまとめた変更とするのか、別の合意した処理を行うのか、利用者がルールを知る必要がある。最後の行が単純に優先されると決めつけない。元データの値が矛盾するなら、重複ラベルは判断につながるべきで、警告でプレビューを飾るだけであってはならない。
同様に、一つの入力に複数の取り込み先レコードが一致する場合もある。二つのバリエーションで商品名が繰り返されるのは、珍しい障害ではなく普通のケースだ。適切な識別子がなければ、インポート機能が都合のよい順序でレコードを選んではいけない。保存前に曖昧さと保留される範囲を示す。人は何がまだ確認待ちなのか分かる必要がある。
Aeneia Designでインポートを設計する際、こうした例はマッピング画面、変更プレビュー、結果報告をつなぐ助けになる。空のテンプレートから始める代わりに、実際の列名をいくつかと、難しいケースを示す仮の値を持参できる。設計は合意されたデータ保存ルールに対応しなければならない。
サンプルのプレビューはファイル全体の確認ではない
供給者は最初の数行を丁寧に用意した。末尾近くになって初めてコードの欠落と認識できない単位が現れる。パネルが先頭しか表示しなければ、利用者はその問題を推測できない。状態は表示内容のプレビューと全体検査の結果を区別すべきだ。それぞれ異なる判断に役立ち、作成時点も違うことがある。
新しいJira Cloudインポートの文書は、マッピング中に最初の30行を確認すると説明している(英語)。後続行の誤りによって失敗または部分的なインポートが起こりうるとも警告する。画面で先に進めるからといって、サンプルの限界がなくなるわけではない。
架空の十二件のファイルでは、概要に新規三件、更新四件、変更なし二件、確認が必要なもの三件を示す。この例では合計が入力十二行になる。一般に一行が必ず一商品に対応するとは限らない。バリエーションや関係のファイルでは構造が異なる場合があり、設計上その構造を明示すべきだ。
更新を承認する前に、値の差を確認できるようにしたい。「幅が変更された」だけでは、120が12に置き換わったのか、表記形式だけが変わったのか分からない。変更画面には現在値と提案値を単位とともに示す。差を強調しない行全体のプレビューは、比較を担当者の記憶に委ねてしまう。
マッピングを変更したら結果を再計算する必要がある。「状態」を別のフィールドへ割り当てた場合、古い更新件数が現在の結果に見えてはいけない。待機状態か、以前の概要を更新する必要があるという表示が必要だ。そうしなければ、利用者は最後の修正より前に示された範囲を承認してしまう。
承認は選んだバージョンと定めた結果に対するもの
最後のボタンには受け入れる範囲を明記する。例のファイルで、例外を操作対象から外して七件を受け入れられるなら、「3件追加し4件更新」と表示できる。エラー一つでファイル全体が止まるなら、別の完了方法が必要だ。アプリが実行しない部分保存を画面が約束してはいけない。
プレビューと保存の間に、別の人が既存商品を変更することがある。再比較、競合の保留、別のバージョン確認など、実装担当者と動作ルールを合意する必要がある。確認ウィンドウだけではデータは固定されない。画面には実際の確認結果と次に取れる行動を示し、同意の質問を繰り返すだけにしない。
開始後は実行中の状態と、どの範囲までキャンセルできるかを示す。ウィンドウを閉じても表示が隠れるだけで、保存は止まらないかもしれない。ある段階から「キャンセル」が使えなくなるなら、その結果を明確に伝える。パネルの隅に閉じる印があるだけで、すべての変更を元に戻せると示唆してはいけない。
特に時間のかかる操作では、戻ってきた後に結果を見つける方法が必要だ。ファイル名、インポート先、タスクの識別情報は、似た二つの実行を区別する助けになる。新しく実行すると別タスクが作られるのか、既に受け付けたタスクへ戻るのかが分かるようにする。ダブルクリックが、意図せず商品のコピーを二つ追加する方法になってはいけない。
例外を修正できる結果を受け取る
実行後の概要には、実際に保存したもの、変更しなかったもの、拒否したものを示す。事前の予測と異なることはあるが、重要な違いはそれぞれ説明する必要がある。件数とレコードへの参照がない「インポート完了」だけでは、カタログを使い続けられるか判断できない。全体の状態は部分的な結果も示すべきだ。
Airtableは、フィールド値を受け付けられなくてもレコードの作成や更新が止まらない場合があると説明している(英語)。説明されたインポートではセルが空のままになることがあり、概要には省略された値が列挙されない。したがってレコードの成功は、そのすべての値が受け入れられたことを自動的に保証しない。
そのため例の報告では、保存されたレコードと修正が必要なフィールドを分ける。問題があれば、元の行、フィールド、利用者が修正できる原因を示す。セル内に改行がある場合やファイルに見出しがある場合は特に、行番号の定義を明確にする必要がある。利用者がアプリと異なる方法で行を数えるのでなく、正しい項目にたどり着けるようにする。識別できる商品コードも、正しいケースを直しているか確認する助けになる。
例外ファイルは必要な列と拒否理由を保てば、後続作業に役立つことがある。その形式にも設計が必要だ。別のプログラムへのデータ書き出し (ポーランド語)は、行数だけでなく値の意味を保つべきだ。正しく読めない報告は、同じ経路に次の問題を作る。
利用者がファイル全体を再送したというだけで、修正項目の再インポートが既に追加した商品のコピーを作ってはいけない。レコード識別ルールと範囲の選択方法でこれを決める。設計では、何を再試行し、何が以前の結果のまま残るかを示す。そうしないと三つの欠落を直すために十二件すべての作業が再び始まりかねない。
資料がAIのプロセスで使うスプレッドシート (ポーランド語)で用意された場合は、編集後にファイルへ実際に保存された値も確認する。表示されていた商品番号の型が変わったり、コードからゼロが落ちたりしているかもしれない。入力データの確認ではレコードの照合前にその変化を見つけたい。表のプレビューを信頼することは、渡されたファイルを読む代わりにはならない。
適切に受け取ったインポートには、どの列を採用し、何を基準に商品を照合し、各グループでどんな結果を得たかという理解できる判断が残る。そのとき例の十二行は、十二個の新商品を装わなくなる。利用者は、何がカタログに反映され、供給者が次の「今度こそ最終」スプレッドシートを送る前に何を確認すべきか分かる。







