インポート一覧：インポートデータの用意

インポート処理を正常に行う為に、
楽楽販売が取り込めるファイルの形式をご確認ください。

項目タイプごとの特徴

「キー項目」

インポートファイルの中でキー項目が重複しているものがあった場合、
エラーにはなりませんが、1行目のみ登録・更新が実施され、
2行目以降は登録・更新がされません。

「テキスト1行」項目

「テキスト1行」項目は、1行のテキストしか入力できません。
この項目に改行があるデータをインポートすると、フィルター機能によって自動的に改行が取り除かれます。

「数値」項目

「数値」項目へのインポートは、インポート全体設定の「数値項目の入力チェック」の設定によって大きく動作が異なります。

本来、「数値」項目には半角数字しか入力できません。
よって、例えば「10円（全角文字）」というデータはフィルター機能がオフの場合はインポートできません。

フィルター機能がオンの場合は、自動的に「10（半角文字）」という値に変換してインポートを実行します。
フィルターは次のルールで変換します。

※フィルターには複数のルールが同時に適用されます。
ただし下記のようなデータは変換できないのでご注意ください。

※変換エラーとなったデータはインポートエラーになります。
　上記はフィルター機能がオンの場合のインポート例です。

「数値項目の入力チェック」にチェックを入れると、フィルター機能がオフになります。
この設定で取込めるのは下記の文字のみです。

数値と小数点　　　　　    … 半角数字、半角ピリオド
マイナスを意味する記号 　… 半角マイナス、半角カッコ、全角△
無視される記号 　　　　　… 半角カンマ、半角スペース

「日時、時間」項目

「日時」項目へインポートを行う場合は、「西暦」のデータをご用意いただく必要があります。
「和暦」のインポートはできません。

「時間」項目へインポートを行う場合は「時」「分」「秒」まで表示した
CSVデータをご用意いただく必要があります。
「時」「分」までのデータだとインポートできません。

DBリンク項目と従属項目

「DBリンク項目」にインポートするデータは、
リンク先のDBに前もって登録されている必要があります。

インポート全体設定の「従属項目の取得」にチェックを入れてある場合は、
DBリンク項目にインポートするだけで、そのリンク項目に紐づく従属項目（※）を
自動取得します。

従属項目にインポートデータを反映したい場合は、「従属項目の取得」のチェックを外してください。

「選択肢（1件選択）」項目

「選択肢（1件選択）」項目もしくは「ユーザ選択肢（1件選択）」項目へインポートを行う際は、
該当の項目で設定されている選択肢と完全一致している必要があります。
※半角や全角、大文字や小文字も一致させる必要があります。

【例】

「選択肢（複数件選択）」項目

「選択肢（複数件選択）」項目もしくは、「ユーザ選択肢（複数件）」項目へインポートする場合には、
CSVファイルの1つの「セル」中にインポートしたい選択肢を入力してください。
この時、選択肢と選択肢の間はTAB文字で区切ってください。
※他、選択肢（1件選択）と同様の制限があります。

【例】　　

※CSVをExcelで加工する場合にはキーボード上からTAB文字の入力は行えません。
　そのため、「CHAR（9）」という関数を使用し、TAB文字を入力してください。

　この関数の出力結果は表示されません（B列）が、
　実際にはTAB文字が入っています。（C列）

明細インポート用のデータ

明細項目にインポートする場合、データは下記の仕様で扱われます。

• • キー項目がない場合でも、インポート項目のすべてのヘッダ項目のデータが一致しているデータは同一のレコードの明細として判定される。

• • インポートファイルの中に同じキー値が何度も登場する場合、
    最初の固まり（連続）だけをインポートする。

明細がある新規登録の場合から、例をあげてご説明します。

明細のある新規登録の場合

「登録方法」ごとの明細用のインポートデータの注意点を以下にご説明いたします。

■登録方法：登録のみ（キー項目は自動発行）

キー項目がない場合でも、下記の条件を満たしている場合、
同一のヘッダに紐づく明細行と判定されます。

• • インポートデータのすべてのヘッダ項目の内容が一致している
  • インポートデータ内で同一ヘッダごとにソートされている
    

インポートデータにすべてのヘッダ項目が同じデータの固まりが2つあった場合、
インポート後の一覧画面では下記のようになります。

【インポートしたデータ】
1行目、２行目、5行目はヘッダ項目の内容がすべて一致しているが、5行目のみヘッダ項目でソートされていない。

【インポートした結果】
下記のようにヘッダ項目の内容がすべて一致していても、インポートデータ内でソートされていないため、インポートファイルの5行目が別のレコードとして登録されています。

■登録方法：登録のみ（キー項目はインポートデータを使用。既に存在する場合は登録を行わない）　

下記のルールにそってインポートデータを作成してください。

• ヘッダのキー項目を用意する。
  
• 必ずヘッダのキー項目の値でソートし、同じ値をまとめる。
  
• 明細行はデータの固まりごとにソートをする。

上の図は、正しいCSVデータの例です。
ソート時は、最も優先する列を「キー項目」、第二優先を「明細項目1」としています。

【キー項目があるデータの正しくない例】

上の図は、正しくないCSVデータの例です。
キー項目の値がソートされておらず、3～5行目の他に8行目以降にも、
同じキー項目の値（00000001）を持つデータの固まりがあります。

さらにキー項目の値がないデータもあります。

【参考：正しくないデータのインポート例】
正しくないデータをインポートした場合に、
どのような形でデータがインポートされるか次の表で説明します。

【インポートルール適用】　

こちらが先ほどの正しくないCSVデータにインポートルールを適用した結果です。
キー項目が「00000001」は3行目の他に、8行目にも存在しますが、
最初の固まりである3～5行目までのみがインポートされ8行目はエラーとなります。

上記のデータをインポートすると一覧画面では下記のようになります。










ヘッダ項目の値には、先頭行のデータが使われており、
明細項目ではCSVデータに記載された順番でインポートされています。

明細項目をインポートで更新

明細の一括更新インポートには下記のルールがあります。

• ヘッダのキー項目と明細の更新キーがCSVに含まれている必要がある
  
• （ヘッダ・明細共に）CSVファイルの上の行からインポートが実行される
  
• 同じ値の更新キーが複数登場した場合、上から順に更新をする
  （一番下にある行の内容がDBに残る）
  
• CSVにある明細の更新キーがレコードにない場合は、明細の末尾に追加される
  

更新キーには下記のいずれかを使用します。

明細用のインポートデータは下記のルールに沿って作成してください。

• • 必ずヘッダのキー項目の値でソートし同じ値をまとめる。
  • 明細の更新キーを用意する。
    
  • 明細行は更新キーでソートをする。

【正しいデータ】　

【正しくないデータ】　

更新キーの取得

ここでは更新キーとして明細キーを使用しています。

明細キーは、一覧画面・閲覧画面設定にて明細キーを画面上に表示することで確認できます。
詳細は下記記事をご覧ください。
・レコード一覧画面設定：項目設定（特殊な項目の表示）

次は実際に明細の一括更新の手順を説明します。
今回は顧客が購入した商品情報を明細項目として管理する「注文DB」を例に説明します。

手順の中で必要になるもの（※）は、あらかじめ設定してあるものとします。

■注文DB：項目一覧画面


















■注文DB：データ例









今回はこの注文ID「00000003」のレコードの明細を更新します。

1.  一覧画面設定で明細キーを表示させます。
   
   
   
    
   
   
   
   
   
   
   
   
   
   
2. 画面右上のボタン（サブメニュー）から「CSV出力」を選択します。
   
   
    
   
   
   
   
   
   
   
3. 取得したCSVファイルから、インポートデータを作成します。
   
   
   
   
   
   
   
   明細の更新に必要なので、「明細キー」の値は編集しないようにしてください。
   なお、明細キーの仕様は下記よりご確認ください。
   明細キーの仕様
   
   【更新インポートに使用したCSVデータ】
   
   
   
   
   
   
   更新したい箇所を編集しました。
   このデータをインポートします。
   
   【注文一覧画面：インポート後】
   
   
   
   
   
   
   
   一覧画面を確認し、指定した注文ID「00000003」のレコードの明細が、
   用意したデータで更新されていれば、インポートによる一括更新は成功です。