アップロード更新(ファイル型項目)

最終更新日: 2021年7月23日

用途

次のような場合にお使いいただけます。

  • 社員マスタについて、社員の顔写真をまとめて登録する。
  • 商品マスタの写真を一括で登録する。

アップロード方法

ここでは社員リスト staff.csv のアップロード更新を例に説明します。

  1. 次のようなデータを用意します。ここで "写真" 項目はファイル型です。
    "アカウント","名前","写真","写真_jfcattachment"
    "s110001","日本 太郎","写真_s110001.png","photo_s110001.png"
    "s110002","東京 二郎","写真_s110002.png","photo_s110002.png"
    "s110003","大阪 花子","写真_s110003.png","photo_s110003.png"
    "s110004","沖縄 四郎","写真_s110004.png","photo_s110004.png"
    
    ※ 項目"写真"が「ファイル名」型項目です。
    ※ "写真_jfcattachment"列に添付する実ファイル名を記述します。
    ※ "写真"列は従来通り画面表示時やダウンロードファイル名に利用されます。この項目は必ずしも実ファイル名と同一である必要はありません。
  2. この staff.csv と、実際の画像ファイルを以下のようにZIPファイルにまとめます。
      data.zip
      ├—staff.csv
      ├—photo_s110001.png
      ├—photo_s110002.png
      ├—photo_s110003.png
      └—photo_s110004.png
               :
    
  3. 任意のZIPファイル名で保存し、アップロード更新を行います。

添付ファイルをサブフォルダで管理する

添付ファイルをサブフォルダ以下にまとめて配置することができます。フォルダ名は「files」(すべて英小文字)となります。

teacherlist.zip
├ーteacherlist.csv
└ーfiles
     ├ーmiyamoto.png
     ├ーsasaki.png
     ├ーREADME.doc
     └ーinitdata.csv

アップロードするCSVファイルの指定は以下のようになります。

"アカウント","ファイル名","ファイル名_jfcattachment"
"teacher1","miyamoto.png","./files/miyamoto.png"
"teacher2","sasaki.png","files/sasaki.png"
"teacher3","README.doc",".\files\README.doc"
"teacher4","initdata.csv","files\initdata.csv"

上記 CSV 例に示したように、次のルールがあります。

  • サブフォルダ名は「files」となる。
  • 相対パス表記は、フォルダの区切り文字に「/」と「\」のいずれも利用できる。
  • 「./files」と「files」は同じ意味である。
  • 画像ファイルだけでなく、さまざまなファイル形式を送信できる。
  • CSV ファイルを送信した場合、これは添付ファイルとして解釈される。

サブフォルダ名についての詳細

サブフォルダ名が files の場合、ここに含まれるファイルは(CSV形式ファイルであっても)すべて添付ファイルとして扱われます。
それ以外のフォルダ名を用いた場合、拡張子が CSV のファイルは「アップロード対象データ」として扱われます。

例を示します。次のようにフォルダ teacherlist の中に複数の CSV ファイルを含めたとします。

teacherlist.zip
└ーteacherlist
  ├ーteacherlist.csv
  └ーfiles
   ├ーmiyamoto.png
   ├ーsasaki.png
   ├ーREADME.doc
   └ーinitdata.csv

この場合、最初の teacherlist フォルダは(files という名称ではないため)その中に含まれる CSV ファイル(teacherlist.csv)を「アップロード対象データ」と解釈します。 さらにその中にある files フォルダ内の initdata.csv は、添付ファイルとして扱います。

ファイルが正常にアップロードされない場合

ファイルが正常にアップロードされない場合、次の点をご確認ください。

  • 「項目名_jfcattachment」列が、対象となるCSVファイルに含まれているか。
  • 指定したファイル名が、実ファイル名と完全に一致しているか。

重要

ダウンロード機能によって取得したファイルには、「項目名_jfcattachment」列は含まれていません。 (この項目はアップロードするファイルという意味ですので、CSVダウンロード時には取得できません。)

そのためダウンロードによって取得したファイルをそのままアップロードしても、ファイルは正常にアップロードされません。

「項目名_jfcattachment」列はご自身で用意してください。