CSVアップロード
顧客、商品、在庫、請求、予定などをCSVから一括登録・更新します。
CSVアップロードは、Excelや他システムで管理していたデータを、FBPの管理画面へまとめて取り込むための機能です。Roundtableでは「どのテーブルへ入れるか」「新規登録と更新をどう判定するか」「エラーをどう返すか」を先にそろえると、発注者、実装者、AIに指示する人の認識を合わせやすくなります。
この機能でできること
顧客名簿、商品マスタ、在庫数、請求明細、予定表、会員一覧などをCSVファイルからまとめて登録・更新できます。取り込む前に列名や必須項目を確認し、行ごとのエラーを返すことで、手入力の手間を減らしながらデータの抜けや形式不備を見つけやすくします。
大量データを画面入力ではなく、確認できる一括取込として扱います。
既存データ更新を含む場合は、照合キー、上書き範囲、エラー時の保存可否を決めておくと運用後のトラブルを減らせます。
よくある利用場面
初期データをまとめて登録する
既存のExcel名簿、商品表、在庫表、予定表を整形し、システム開始時に一括で登録します。
外部システムのデータを取り込む
会計、配送、予約、EC、POSなどから出したCSVを、FBP側の顧客や請求データへ反映します。
定期的に更新データを反映する
在庫数、価格、ステータス、担当者、スケジュールなど、日々変わる情報をまとめて更新します。
プロンプト例
取込対象、CSV列、照合キー、新規登録と更新の扱い、エラー表示、取込履歴、権限をまとめて伝えると、実装範囲を決めやすくなります。
プロンプト
商品管理にCSVアップロードを追加してください。CSV列は商品コード、商品名、カテゴリ、単価、在庫数、公開状態にします。商品コードが既存の商品と一致する場合は単価、在庫数、公開状態を更新し、一致しない場合は新規登録してください。必須不足や数値形式エラーは行番号付きで一覧表示し、エラーがある場合は保存しないでください。管理者だけが実行でき、取込日時、実行者、成功件数、エラー件数を履歴に残してください。
この機能を使うときのポイント
照合キー商品コード、会員番号、メールアドレスなど、既存データを更新するための基準を決めます。
列と必須項目CSVの列名、順番、必須項目、空欄時の扱いを事前にそろえます。
エラー時の扱い1行でもエラーがあれば全件止めるのか、正常行だけ登録するのかを決めます。
取込履歴誰がいつ何件取り込んだか、失敗した行が何かを後から確認できるようにします。
この機能を実装するときのコツ
CSVアップロードは、ファイルを受け取る処理と、DBへ反映する処理を分けて考えます。まずヘッダ行、文字コード、必須列、行数上限を検証し、次に各行を登録・更新用の内部データへ変換します。選択肢、日付、金額、改行を含むメモは変換ルールを明確にし、保存前に行番号付きのエラー一覧を作ると確認しやすくなります。FBPでは管理側の取込ボタンやダイアログからファイルを受け、標準のDB操作とバリデーションに寄せて実装すると保守しやすくなります。