CSVインポート

まずClaude / CodexでCSVインポートを確認する

/sanka CSVインポートを進めたいです。対象オブジェクト、CSVの列名、Sankaプロパティへのマッピング候補、作成/更新の判断、重複しそうなレコード、不足項目を整理してください。まだインポートは実行しないでください。

対応オブジェクト一覧

CSVを用意する

会社名,メールアドレス,電話番号,担当者
ミドリサロン株式会社,info@example.jp,03-0000-0000,田中

WebアプリでCSVをインポートする

1. インポートしたいオブジェクトの一覧画面を開きます。
2. 画面右上の「インポート」をクリックします。
3. インポート元でCSVファイルを選択します。
4. CSVをアップロードします。
5. マッピング画面で、CSV列とSankaプロパティを対応づけます。
6. 新規作成または更新を選択します。
7. 更新の場合は、対象レコードを特定するキープロパティを選択します。
8. 内容を確認してインポートします。
9. インポート後、対象オブジェクトの一覧でレコードとステータスを確認します。

親会社/子会社をCSVで設定する

• 更新対象の企業を特定する列（例：企業ID）
• 親会社を指定する列（例：親会社）

企業ID,親会社
0001,
0002,0001

特殊なCSVインポート

• 企業階層: 親会社/子会社のアソシエーションを更新します。
• 商品構成: 商品やBOMを扱う場合は、商品コードや親子関係が一意になるように整理します。
• 在庫・入出庫: ロケーション、商品、数量、日付の整合性を確認します。
• 発注・支払請求: 仕入先、商品、金額、税、支払条件を確認します。
• カスタムオブジェクト: 対象オブジェクトのプロパティとキープロパティを先に確認します。

入出庫をCSVでインポートします

• 関連する商品と在庫レコードがすでに存在していることを確認します。
• ロケーションまたは倉庫の値がワークスペース設定と一致していることを確認します。
• 数量の正負を、チームの取引種別ルールに合わせて使います。
• 既存の入出庫レコードを更新する場合は、入出庫レコードIDまたは一意なキーを含めます。
• 受注番号、棚卸ファイル、調整理由など、後から監査できる作成元参照を残します。
• 大きな調整や移行では、少数のファイルでテストしてから全件をインポートします。

/sanka この入出庫CSVインポートを実行する前に確認してください。商品識別子、在庫レコード、ロケーション、取引種別、数量の正負、取引日、作成元参照、作成/更新モード、照合キー、在庫を想定外に変更しそうな行を確認してください。期待される結果とリスクのある行を要約してください。まだインポートや在庫レコード変更は行わないでください。

カスタムオブジェクトをCSVでインポートします

• 対象のカスタムオブジェクトがすでに存在していることを確認します。
• すべてのCSV列が既存プロパティに対応しているか、インポート前に作成すべきプロパティを決めます。
• 更新の場合は、レコードIDまたは外部IDプロパティなど、安定したキーを選びます。
• アソシエーションでは、関連レコードIDまたは承認済みの照合値を含めます。
• 必須プロパティがすべての行に入っていることを確認します。
• 日付、数値、チェックボックス、単一選択、複数選択、画像、ファイル、アソシエーションなどのプロパティ種別を確認します。

/sanka このカスタムオブジェクトCSVインポートを実行する前に確認してください。対象カスタムオブジェクト、必須プロパティ、プロパティ種別、作成/更新モード、照合キー、アソシエーション列、重複リスク、バリデーションで失敗しそうな行を特定してください。作成または更新される内容と、先に修正すべき内容を要約してください。まだインポートやカスタムオブジェクトレコード変更は行わないでください。

エラーと履歴を確認する

インポート・エクスポートのトラブルシューティング

/sanka このCSVインポートまたはエクスポートの問題を確認してください。対象オブジェクト、選択した作成/更新モード、照合キー、マッピングした列、失敗した行、エラーメッセージを整理し、ファイルの問題、マッピングの問題、権限の問題、フィルターによる想定どおりの動作、または不具合の可能性のどれに近いかを判断してください。まだ再インポートやレコード変更はしないでください。

ファイルをアップロードできません

• CSVファイルになっているかを確認します。Excelファイルや、拡張子だけを変更したファイルは避けます。
• 1行目にヘッダー行を入れます。
• 表計算ソフトから出力する前に、結合セル、数式、非表示行、タイトル行を取り除きます。
• 日本語が文字化けする場合は、UTF-8など標準的なCSVエンコードで保存し直します。

列が正しくマッピングされません

• CSVヘッダーとSankaのプロパティ名を見比べます。
• 対象オブジェクトにそのプロパティが存在するかを確認します。
• カスタムプロパティの場合は、プロパティタイプとCSVの値の形式が合っているかを確認します。
• 関連レコードを指定する列では、関連先レコードがすでに存在するか、不足レコードを作成する運用になっているかを確認します。

更新したつもりが新規作成されました

• 作成モードではなく、更新モードを選んでいるかを確認します。
• すべての行に照合キーが入っているかを確認します。
• レコードID、外部ID、SKU、受注番号、売上請求番号など、チームで一意に管理している安定した値を使います。
• 重複や表記ゆれがあり得る場合は、名前だけで照合しないようにします。

インポート後にレコードが見つかりません

• インポート履歴、成功件数、失敗件数、エラーファイルを確認します。
• 現在のオブジェクトビューで、新規作成または更新されたレコードが絞り込みから外れていないかを確認します。
• レコードがアーカイブされていないか、自分のロールで閲覧できるかを確認します。
• 関連レコードを作成するインポートでは、顧客、商品、ロケーションなどの必須関連レコードが存在するかを確認します。

エクスポートしたCSVにレコードや列がありません

• 対象オブジェクトの閲覧権限とエクスポート権限があるかを確認します。
• エクスポート画面で選択したプロパティとフィルターを確認します。
• 後でCSV更新に使う場合は、レコードIDを出力項目に含めます。
• バックグラウンドで処理されるエクスポートでは、再実行する前にエクスポート履歴とメール通知を確認します。

不具合の可能性として扱うタイミング

次に見るページ

• CSVエクスポート — SankaのレコードをCSVで出力します
• オブジェクト一覧 — Sankaで扱えるオブジェクトを確認します

商品画像を一括アップロードする

画像グループプロパティとは

画像グループプロパティを作成する

1. 画面左下の「ワークスペース」を開き、「オブジェクト管理」をクリックします。
2. 一覧から「商品」を選択し、右上の「新規」をクリックします。
3. プロパティ名を入力します（例：商品画像）。
4. タイプで「画像グループ」を選択し、「作成」をクリックします。
5. 作成したプロパティをレコード作成フォームやビューに表示したい場合は、「ビュー/フォームの管理」で追加してください。

商品画像を一括アップロードする

• 画像を保存するプロパティ（画像または画像グループ）を用意します。
• 照合に使うテキストプロパティを決めます（例：レコードID、SKU、品番など）。
• 照合キーはユニークな値になるプロパティを選び、複数の商品に誤って紐付くのを防ぎます。

1. 商品オブジェクトの一覧画面を開き、右上のアクションメニューから「画像をアップロード」をクリックします。
2. 「画像プロパティ」で、画像を保存したいプロパティを選択します。複数枚をまとめて登録したい場合は画像グループを選びます。
3. 「テキストプロパティ」で、画像を紐付けるための照合キーを選択します。
4. 画像ファイル名を、選んだテキストプロパティの値に合わせて準備します。ファイル名の拡張子（.jpg / .jpeg / .png）を除いた部分が照合に使われます。
5. 画像をドラッグ＆ドロップするか、クリックして選択します。
6. ファイル一覧を確認し、「画像をアップロード」をクリックします。

1つのレコードに複数の画像を登録する

アップロード後に確認する

うまく反映されないとき

• 画像ファイル名がテキストプロパティの値と完全一致しているか確認してください。前後の空白や全角/半角の違いにも注意します。
• 照合に使うテキストプロパティが空のレコードには紐付きません。
• 対応形式は .jpg / .jpeg / .png です。ほかの形式はアップロードできません。
• 同じキーを持つ商品が複数ある場合、該当するすべての商品に同じ画像が登録されます。

掛け率テーブル（価格表）を設定してCSVでインポートする

掛け率テーブルを設定する

1. ワークスペースから「オブジェクト管理」を開き、企業を選択します。

2. 企業オブジェクトのプロパティ設定で「+ 新規」をクリックし、プロパティを作成します。

3. プロパティ作成画面で必要事項を入力します。
   • 名前: 掛け率テーブルのプロパティ名
   • 内部名: 掛け率テーブルのシステム内部名
   • タイプ: 価格表

4. 「保存」をクリックします。

5. 企業オブジェクトのビュー設定からフォーム管理を開き、作成した掛け率テーブルのプロパティをフィールドに追加します。

掛け率テーブルのモードを選ぶ

企業共通モードを手動で更新する

1. 該当の企業レコードを開きます。

2. 掛け率テーブルのプロパティでモードを選択します。企業共通 を選択します。

3. 割引率を設定します。

4. 掛け率テーブルを保存します。

5. 最後にレコード全体を保存します。

企業共通モードをCSVで更新する

1. CSVファイルを準備します。更新インポートの場合は、企業レコードIDが必須です。

2. 企業オブジェクトの「インポート」からインポートを開始します。

3. インポート元で「CSV」を選択し、該当のCSVファイルをアップロードします。

4. CSVヘッダーとSankaのプロパティをマッピングします。
   • 企業のレコードID: 「レコードID」
   • 掛け率: 「掛け率テーブル」

5. レコードのインポート方法を選択します。既存レコードを更新する場合は「レコードを更新」を選択し、参照プロパティに「レコードID」を選択します。

6. インポートする内容を確認し、間違いがなければ「インポート」をクリックします。

商品別モードを手動で更新する

1. 該当の企業レコードを開きます。

2. 掛け率テーブルのプロパティでモードを選択します。商品別 を選択します。

3. 適用価格または割引率を入力します。どちらかを入力すると、もう一方は自動で計算されます。

4. 商品ごとに掛け率テーブルの保存ボタンをクリックします。

5. 最後にレコード全体を保存します。

商品別モードをCSVで更新する

1. CSVファイルを準備します。1企業につき商品ID・掛け金額が複数ある場合は、セミコロン区切りで1行に記載します。 例: 企業レコードID 1 に対して、商品ID 15 の掛け金額が 300 円、商品ID 16 の掛け金額が 300 円の場合は、商品IDと掛け率金額をそれぞれ 15;16 / 300;300 のように1行にまとめて記載します。

2. 企業オブジェクトの「インポート」からインポートを開始します。

3. インポート元で「CSV」を選択し、該当のCSVファイルをアップロードします。

4. CSVヘッダーとSankaのプロパティをマッピングします。
   • 企業のレコードID: 「レコードID」
   • 掛け率商品ID: 「掛け率テーブル - 商品」
   • 掛け率金額: 「掛け率テーブル - 価格」

5. レコードのインポート方法を選択します。既存レコードを更新する場合は「レコードを更新」を選択し、参照プロパティに「レコードID」を選択します。

6. インポートする内容を確認し、間違いがなければ「インポート」をクリックします。