項目選択肢一括登録・削除(CSV仕様)
こちらは 「商品管理(upgrade版)」 ご利用店舗様用の新仕様(upgrade版)のCSVマニュアルになります。(「商品管理(upgrade版)」とは?)
商品メニューを利用する「商品管理(upgrade版)」で利用可能なCSVは、「標準CSV(従来項目版)」と「標準CSV」の2種類があります。
詳しくは、 商品CSVデータの仕様刷新と制限をご覧ください。
本マニュアルは、「商品管理(upgrade版)」ご利用時に標準となる 「標準CSV」 に関して解説しています。
「標準CSV(従来項目版)」を利用中(「標準CSV」切替え前)の場合は、各セクションの「標準CSV(従来項目版)」用のモーダルを開いてご確認ください。
<目次>
ご利用前の重要ご留意事項
商品の「項目選択肢」を一括で登録・削除できるファイルです。
既存データの更新はできません。
- 事前に商品登録が必須です。CSVの場合は、商品一括登録を利用してください。
一括登録・削除手順
CSVのご利用は、以下の手順にておすすめください。
CSVの形式エラーをなくすために、まずはじめにCSVデータの編集時に注意することはありますか?をご覧ください。
- まず、登録したい項目をセットしたCSVテンプレートを、商品>一括出力>一括出力(テンプレート)にて設定します。(登録済みの場合は不要)
- 商品>一括出力の「項目選択肢」セクション内「項目選択肢」行のプルダウンから、利用したいテンプレートを選択し[ファイル出力]を押下します。
- ダウンロードされたCSVファイルのヘッダー(1行目)の項目を元に、基本仕様・CSV入力仕様に従って必要な情報を入力し、アップロード用のCSVファイルを作成します。ファイル名は、末尾の「yyyyMMddHHmmss(年日時)」部分以外は変更しないでください。
- 商品>一括追加・変更の「項目選択肢」セクション内「項目選択肢」行の[ファイルを選択する]を押下します。
- 表示されたモーダル上で、CSVファイルをアップロードし、[アップロード]ボタンを押下します。
- アップロードのエラー・成功のステータス確認は、商品>一括追加・変更履歴>一括追加・変更履歴(CSV)をご覧ください。
基本仕様について
基本的なCSV仕様・制限事項など
| 項目 | 仕様・制限事項など | 備考 |
|---|---|---|
| 文字コード | UTF-8(BOMあり) | |
| 区切り文字 | カンマ | |
| 改行コード | CRLF | |
| ヘッダ行 | 有 | |
| ファイル制限(容量) | 30MB | 超過する場合は、複数回に分けて登録してください。 |
| レコード数制限 | 50,000レコード(※ヘッダー除く) | 超過する場合は、複数回に分けて登録してください。 |
| 商品制限 | 1,000商品 | 超過する場合は、複数回に分けて登録してください。 |
| ファイル命名規則 | productSelection-{テンプレートコード}_yyyyMMddHHmmss.csv | <テンプレートコードとは> 商品>一括出力にてテンプレートを作成する際に、指定したコードです。 本コードをもって、登録項目を識別しますので、変更しないでください。 ※初期テンプレートには、本コードはありません。 ファイル名は500文字以内にしてください。 |
「標準CSV(従来項目版)」を利用中(「標準CSV」切替え前)の店舗様の場合
文字コードやファイル命名規則が異なります。こちら(モーダルが開きます)をご覧ください。
- ファイル名の命名規則は、必ず順守してください。
- 機種依存文字はご利用いただけません。
- お使いのPCがMacの場合、改行コードのエラーがでる場合があります。作成後のCSVファイルをテキストエディタなどで再度開き、改行コードを 「CR」から「CR+LF」に変更してください。
- 設定>メール>メール設定一覧>商品データ一括登録完了メール設定で設定されたメールアドレスへ登録状況をお知らせするメールを送付できます。
CSV入力仕様
基本的な入力仕様について
各行の1列目「コントロールカラム」に入力する値に従って更新・削除が行われます。
CSV仕様表とあわせてご確認ください。
新規登録(追加)する場合
コントロールカラムの入力
「n」 を入力します。
必須 項目の入力
「商品URLコード」と「選択肢タイプ」を指定して、項目選択肢を設定します。
「任意」項目の入力
- 値を入力すると、指定値で登録されます。
- 許容値欄をご参照ください。
- 「空欄」指定すると、一部の項目では「初期値」が登録されます。
- コントロールカラム「n」-「空欄」設定時欄をご覧ください。
- 一部の項目では、「空欄」指定不可です。
削除する場合
「商品URLコード」と「セレクト/ラジオボタン用項目名」を指定して、該当の項目選択肢を削除します。
指定した商品の、すべての項目選択肢を削除するのではありません。
コントロールカラムの入力
「d」 を入力します。一度削除されたデータは、復元できません。
必須 項目の入力
既定値を入力します。
「任意」項目の入力
- 基本的に入力不要ですが、一部の項目では、入力が必要です。
- コントロールカラム「d」欄をご覧ください。
CSV仕様表
<基本的なエラー>
- 同一「商品URLコード」のコントロールカラムで、「n」と「d」が混在している場合、エラー
- CSVファイル内に、同じ組み合わせの「商品URLコード」「セレクト/ラジオボタン用項目名」「セレクト/ラジオボタン用選択肢」が複数存在している場合、エラー
- 「d」指定時は、「商品URLコード」と「セレクト/ラジオボタン用項目名」を指定することで、その項目名に属するすべての選択肢を削除します。
- 指定した商品の、すべての項目選択肢を削除するのではありません。
「標準CSV(従来項目版)」を利用中(「標準CSV」切替え前)の店舗様の場合
CSV項目についてはこちら(モーダルが開きます)をご覧ください。
| 項目名 | 形式 | 文字数 | 許容値と 区分説明 |
コントロールカラム入力値別 制御仕様 | 補足・注意事項 | ||
|---|---|---|---|---|---|---|---|
| n(新規登録) | d(削除) | ||||||
| 必須 | 「空欄」 設定時 |
必須 | |||||
| コントロールカラム | 半角英字 | 1 | n:新規登録 d:削除 |
〇 | n必須 | 〇 | ※基本的なエラー参照 |
| 商品URLコード | 32 | 〇 | 「空欄」指定不可 既定値入力 |
〇 | ※基本的なエラー参照 | ||
| 選択肢タイプ | 半角文字列 | 2 | s:セレクトボックス c:ラジオボタン t :テキスト tr:テキスト(必須) |
〇 | 「空欄」指定不可 既定値入力 |
- CSVファイル内の、同じ組み合わせの「商品URLコード」「セレクト/ラジオボタン用項目名」の「選択肢タイプ」に以下が混在している場合、エラー ・「s:セレクトボックス」 ・「c:ラジオボタン」 ・「t :テキスト」 ・「tr:テキスト(必須)」 ※新規登録時の注意事項 |
|
| セレクト/ラジオボタン用項目名 | 文字列 | 100 | 〇 | 「空欄」指定不可 既定値入力 |
〇 | ※基本的なエラー参照 - 以下のフォーム関連のHTMLタグを含んでいる場合、エラー FORMタグ INPUTタグ TEXTAREAタグ SELECTタグ OPTIONタグ BUTTONタグ SCRIPTタグ - 「チルダ(~)」を含んでいる場合、エラー - 半角スラッシュを含んでいる場合、エラー - 新規登録の場合 指定した商品の「セレクト/ラジオボタン用項目名」が21項目以上になる場合、エラー |
|
| セレクト/ラジオボタン用選択肢 | 文字列 | 100 | ※補足・注意事項参照 | 「空」で登録 | ※補足・注意事項参照 | ※基本的なエラー参照 -「選択肢タイプ」にて 「s:セレクトボックス」「c:ラジオボタン」を指定している場合 値が設定されていない場合、エラー - 以下のフォーム関連のHTMLタグを含んでいる場合、エラー FORMタグ INPUTタグ TEXTAREAタグ SELECTタグ OPTIONタグ BUTTONタグ SCRIPTタグ - 半角スラッシュを含んでいる場合、エラー - チルダ(~)を含んでいる場合、エラー -新規登録時の注意事項 |
|
| 項目選択肢表示 | 半角数字 | 1 | 0:表示する 1:表示しない |
「0:表示する」で登録 | - CSVファイル内の、同じ組み合わせの「商品URLコード」「セレクト/ラジオボタン用項目名」の「項目選択肢表示」に「空欄」「0」「1」に混在している場合、エラー | ||
| 最終更新日時 | ー | ー | ー | ー | ー | ー | アップロード時には利用しない項目 |
【新規登録時の注意事項】特定項目の補足
※表内の「補足・注意事項」欄に入りきらない補足を記載しています(特定項目のみ)。必ず表とあわせてご確認ください。
コントロールカラム【n】を入力時に注意を要する項目です。
| 項目名 | 説明 |
|---|---|
| 選択肢タイプ | 「t :テキスト」「tr:テキスト(必須)」指定時、該当の「商品URLコード」の「セレクト/ラジオボタン用項目名」の項目選択肢情報となる「セレクト/ラジオボタン用選択肢」が2項目以上になる場合、エラー |
| セレクト/ラジオボタン用選択肢 | - 「選択肢タイプ」にて「s:セレクトボックス」「c:ラジオボタン」を指定している場合 指定した商品の「セレクト/ラジオボタン用項目名」の「セレクト/ラジオボタン用選択肢」が301項目以上になる場合、エラー - 指定した商品の「セレクト/ラジオボタン用項目名」の「セレクト/ラジオボタン用選択肢」を、すべて「チルダ(~)」で結合した際、16001文字以上になる場合、エラー |
