二加屋様 Web B2B システム 商品 CSV データ取込マニュアル 2012 年 10 月 19 日 株式会社アイル 概要 このマニュアルは二加屋様の Web B2B システムに商品 CSV データから商品情報を登録す るための手順を示すものです マニュアル内で利用するツール このマニュアル内で

1 二加屋様 Web B2Bシステム

商品

CSV

データ取込マニュアル

2012年10月19日 株式会社アイル

概要

このマニュアルは二加屋様のWeb B2Bシステムに商品CSVデータから商品情報を登録す るための手順を示すものです。

マニュアル内で利用するツール

このマニュアル内では下記のツールを利用したアップロード方法を説明します。 これらのツールは必須ではなく、同じ用途のツールで代替可能です。 ファイルアップロードツール 「WinSCP」 http://winscp.net/eng/docs/lang:jp SSH を用いた安全な接続方法でサーバーと接続し、ファイルのアップロードやダウンロー ドに利用できるツールです。さくらインターネットなど、SSH 接続に対応したレンタルサ ーバーとのファイルのやりとりに使用します。 WinSCPはWindowsで利用できるメジャーなツールです。

商品画像アップロード手順

下記の手順でアップロードを行ないます。 1. 商品データのCSVファイルを用意 2. 商品の画像や添付資料を用意 3. メーカーの識別コードの設定 4. サーバーにCSVファイル、画像や添付資料をアップロード 5. 管理画面で商品CSVデータ取り込みを実行

2

商品データの

CSV

ファイルを用意

商品データをCSVファイル型式で作成します。 商品データが書かれているエクセルファイルを開きます。 Microsoft Excelが立ち上がり画面が表示されます。 (下の画面はMicrosoft Excel2010のものです。) ダブルクリックして エクセルファイルを開く

3 ＊エクセルファイルをダブルクリックしてMicrosoft Excelが立ち上がらない場合は次の手 順でMicrosoft Excelを立ち上げます。 ① エクセルファイルを選択して右クリック→「プログラムから開く」をクリックします。 ② ファイルを開くプログラムの選択画面が表示されます。表示されたプログラムの中か ら「Microsoft Excel」を探してダブルクリックをします。 ③ 「Microsoft Excel」が立ち上がりエクセルファイルの内容が表示されます。 エクセルファイルを選択して右クリック後、 「プログラムから開く」をクリックする 表示されたプログラムの一覧から 「Microsoft Excel」を探してダブルクリックをする プログラムの選択の前に「この種類のファイルを開くときは、選択したプログラムをいつも使う」に チェックを入れるとダブルクリックをした時にMicrosoft Excelが立ち上がりようになります

4 Microsoft Excelが立ち上がったら、「名前を付けて保存」を行います。メニューから「ファ イル」を選択して表示される「名前を付けて保存」をクリックします。 「名前を付けて保存」の画面が表示されたら商品CSVデータに以下のように設定をします。 ファイル名 ファイル名 ファイル名 ファイル名：(半角英数字で任意の名称).csv ファイルの種類 ファイルの種類 ファイルの種類 ファイルの種類：CSV(カンマ区切り)(*.csv) ファイル名には半角英数字のみを使用してください。漢字や平仮名などの全角文字をファ イル名には使用しないでください。 メニューから「ファイル」を選択後、 「名前を付けて保存」をクリックする メニューから「ファイル」を選択

5 上記の手順でCSVファイルには商品データが出力されます。 注意点としてエクセルファイルに複数のシートが存在する場合、表示中のシートの商品デ ータだけがCSVファイルに出力されます。CSVファイルへの保存忘れにご注意ください。 ＊注意事項 ＊注意事項 ＊注意事項 ＊注意事項 ① ① ① ① CSVCSVCSVCSVファイル名には半角英数字のみを設定してください。ファイル名には半角英数字のみを設定してください。ファイル名には半角英数字のみを設定してください。ファイル名には半角英数字のみを設定してください。 ② ② ② ② 商品データの商品データの商品データの商品データのCSVCSVCSVCSVファイルは商品のメーカーごとファイルは商品のメーカーごとにファイルを分けて作成する必要がファイルは商品のメーカーごとファイルは商品のメーカーごとにファイルを分けて作成する必要がにファイルを分けて作成する必要がにファイルを分けて作成する必要が あります。 あります。 あります。 あります。 ③ ③ ③ ③ CSVCSVCSVCSV ファイルのフォーマットはファイルのフォーマットは「添付資料：商品ファイルのフォーマットはファイルのフォーマットは「添付資料：商品「添付資料：商品「添付資料：商品 CSVCSVCSVCSV データのフォーマットについデータのフォーマットについデータのフォーマットについデータのフォーマットについ て」の通りになっている必要があります。 て」の通りになっている必要があります。 て」の通りになっている必要があります。 て」の通りになっている必要があります。添付資料を添付資料を添付資料を添付資料をご確認ください。ご確認ください。ご確認ください。ご確認ください。 ④ ④ ④

④ 複数のシートが存在するエクセルファイルを複数のシートが存在するエクセルファイルを複数のシートが存在するエクセルファイルを複数のシートが存在するエクセルファイルをMicrosoft ExcelMicrosoft ExcelMicrosoft ExcelMicrosoft ExcelででででCSVCSVCSVCSVファイルに出力ファイルに出力ファイルに出力ファイルに出力 する場合、表示中のシートの内容だけが

する場合、表示中のシートの内容だけが する場合、表示中のシートの内容だけが

6

商品の画像や添付資料を用意

商品の画像や添付資料として使用するファイルを用意します。 用意した画像や資料のファイルはメーカーごとにフォルダにわけて用意します。 画像ファイルおよび資料ファイルのファイル名は次のようにしてください。 フォルダ名 フォルダ名 フォルダ名 フォルダ名：(メーカー名)/images ファイル名 ファイル名 ファイル名 ファイル名：(半角英数字で任意の名称).(ファイル拡張子) ファイル名には半角英数字のみを使用してください。漢字や平仮名などの全角文字をファ イル名には使用しないでください。

メーカーの識別コードの設定

商品CSVデータ取り込みを行う際に Web システムにメーカー情報の識別コードが必要と なります。 Webシステムの管理画面にログインし、「商品管理」メニューを開きます。 商品一覧画面が表示されたら、サブメニューの「メーカー管理」ボタンをクリックします。 画面上の一覧表から商品CSVデータ取り込みを行うメーカーを探して「編集」ボタンをク

7 リックします。メーカー情報の編集画面が表示されます。 メーカーの更新画面が表示されたら、「識別コード」が設定されているか確認します。 設定がない場合は識別コードを半角英数字で入力してから「更新」ボタンをクリックして ください。 設定されている場合は、「識別コード」に設定されている文字を記録してください。 識別コードは「メーカーフォルダの作成」で使用します。 識別コードを設定する 半角英数字のみで入力

8

サーバーに

CSV

ファイル、画像や添付資料をアップロード

次に、作成した商品データのCSVファイルと商品の画像や添付資料をアップロードします。 ファイルアップロードツールを起動します。 初回起動時は、接続先が登録されていない状態ですので、リストには何も表示されません。 最初に本サーバーに接続するための情報を登録します。

9 「新規」ボタンをクリックすると接続先登録画面が表示されます。 ここで本サーバーに接続する情報を登録します。 ホスト名には「nikaya.sakura.ne.jp」と入力します。 ユーザー名にはさくらインターネットのユーザー名「nikaya」を入力します。 パスワードにはさくらインターネットのパスワードを入力します。 ファイルプロトコルには「SCP」を選択します。 入力後、「保存」ボタンをクリックします。 接続情報（セッション）に名前をつけるよう促されますが、特に変更の必要はありません。 「パスワードを保存(推奨されません)」にチェックをつけることで、パスワードが保存され、 接続の度に入力する必要がなくなります。 「OK」ボタンをクリックし、最初の接続先選択画面に戻ります。

10

接続先選択画面で、先ほど作成した「[email protected]」をクリックし、「ログ イン」ボタンをクリックします。

11

左側が自分のパソコンのフォルダ、右側が本サーバーのフォルダを表します。

ファイルやフォルダの移動を行なう際は、左側でアップロードしたいフォルダがあるパソ コン上の場所まで移動し、右側でフォルダをアップロードしたい本サーバー上の場所まで 移動します。

12 「パソコン上での現在の場所」、「サーバー上での現在の場所」がそれぞれ下記の場所にな るように移動します。 [パソコン上での現在の場所] 商品データのCSVファイルや画像資料の入ったフォルダ [サーバー上での現在の場所] /home/nikaya/b2b_data/csv/shohins/waiting ※ ※ ※ ※ サーバーサーバーサーバーサーバー 上での現在の場所には特にご注意ください。上での現在の場所には特にご注意ください。上での現在の場所には特にご注意ください。上での現在の場所には特にご注意ください。別の場所にアップロードするとホ別の場所にアップロードするとホ別の場所にアップロードするとホ別の場所にアップロードするとホ ームページや ームページや ームページや

ームページやWebWebWebWebシステムの動作に悪影響を与える場合があります。システムの動作に悪影響を与える場合があります。システムの動作に悪影響を与える場合があります。システムの動作に悪影響を与える場合があります。 パソコン上での現在の場所 サーバー上での現在の場所 1つ上のフォルダに移動する (自分のパソコン) 1つ上のフォルダに移動する (サーバー) フォルダをダブルクリックで1つ 下のフォルダに移動する

13 メーカーフォルダの作成 両方の場所が正しいことを確認したら、サーバー上の 「/home/nikaya/b2b_data/csv/shohins/waiting」フォルダににメーカー毎のフォルダの作 成を行います。右側のサーバーの画面上で右クリックをし「新規」→「ディレクトリ」を クリックします。 右クリックをして 「新規」→「ディレクトリ」をクリック

14 「ディレクトリ」をクリックすると「フォルダの作成」画面が表示されます。 フォルダの作成画面が表示されたら、フォルダの設定を行います。 新規フォルダ名 新規フォルダ名 新規フォルダ名 新規フォルダ名：メーカーの識別コード パーミッションの設定 パーミッションの設定 パーミッションの設定 パーミッションの設定：「パーミッションの設定」にチェックを入れて、R、W、Xのチェ ックをすべて入れた状態にする。 8 8 8 8進数進数：進数進数 R、W、Xのチェックをすべて入れた状態にすると「0777」が表示される。 新規フォルダ名に設定する名前はWebシステムの管理者側、メーカー管理で設定した識別 コードと同じ名前を付けます。(当マニュアルの「メーカーの識別コードの設定」を参照) R、W、Xの全てにチェックを入れる 「パーミッション」の設定にチェックを入れる R、W、Xの全てにチェックを入れた状態で 0777になっていることを確認する メーカーの識別コードと同じ名前を設定する

15 設定が完了しましたら、「OK」ボタンをクリックします。 メーカーのディレクトリ(フォルダ)が作成されます。 サーバーの/home/nikaya/b2b_data/csv/shohins/waiting に上記の手順でメーカー毎のフォ ルダを作成します。 ファイルアップロードツール：画面右(サーバー)側 /home/nikaya/b2b_data/csv/shohins/waitingに 商品CSVデータ取り込みを行いたいメーカーの識別コー ドと同じ名称でフォルダを作成する。

16 CSVファイルのアップロード サーバーの「/home/nikaya/b2b_data/csv/shohins/waiting」にメーカーのフォルダの作成 が出来たら、作成したメーカーのフォルダにダブルクリックをして移動します。 メーカーのフォルダに移動できたことを確認したら、左側のアップロードしたい商品CSV データを右側にマウスでドラッグアンドドロップします。 そうすると、アップロードするかどうかの確認画面が表示されます。 メーカーフォルダをダブルクリックして フォルダ内に移動

17 「コピー：ファイル ‘(ファイル名)’をリモードディレクトリへ」と表示され、入力欄に下記 のテキストが表示されていれば問題ありません。 「/home/nikaya/b2b_data/csv/shohins/waiting/(フォルダ名)/*.*」 「コピー」ボタンをクリックしてアップロードを開始します。 アップロードが完了するとサーバー側にアップロードしたCSVファイルが表示されます。 ローカルPCからアップロードしたCSVファ イルがサーバー側に表示される

18 商品画像データと資料ファイルのアップロード サーバーの「/home/nikaya/b2b_data/csv/shohins/waiting/(メーカーの識別コード)/」フォ ルダ に「商品の画像や添付資料の用意」の時に作成した「images」フォルダをドラッグ＆ ドロップをして移動します。 imagesフォルダの移動を行うと下記の画面が表示されます。 「コピー：ファイル ‘images’をリモードディレクトリへ」と表示され、入力欄に下記のテ キストが表示されていれば問題ありません。 「/home/nikaya/b2b_data/csv/shohins/waiting/(メーカーフォルダ名) /*.*」 「コピー」ボタンをクリックしてアップロードを開始します。 imagesフォルダをドラッグ＆ドロップして サーバーのメーカーフォルダに移動

19 アップロードが完了するとサーバー側にアップロードした画像ファイルや資料ファイルが 入った「images」フォルダが表示されます。 以上の「メーカーフォルダの作成」から「商品画像データと資料ファイルのアップロード」 の手順をアップロードしたいメーカーの数の分行います。 メーカーごとにCSVファイルと画像ファイルや資料ファイルの準備が出来ましたら これで商品CSVデータが取り込み可能な状態となりました。 imagesフォルダが移動されたことを確認する

20

管理画面で商品

CSV

データの取り込み

最後に、Webシステムの商品CSVデータと画像や資料の取り込みを行います。 Webシステムの管理画面にログインし、「商品管理」メニューを開きます。 商品一覧画面が表示されたら、一覧表の上の「商品CSVデータ取り込み」ボタンをクリッ クします。商品CSVデータの取り込み処理が実行されます。 「商品CSVデータ取り込み」ボタンをクリック

21 ※ ※ ※ ※商品商品商品商品CSVCSVCSVCSVデータの取り込み処理はデータの取り込みデータの取り込みデータの取り込み処理は処理は商品データの情報量や画像・資料ファイルの数によっ処理は商品データの情報量や画像・資料ファイルの数によっ商品データの情報量や画像・資料ファイルの数によっ商品データの情報量や画像・資料ファイルの数によっ ては ては ては ては完了するまで時間がかかります。完了するまで時間がかかります。完了するまで時間がかかります。完了するまで時間がかかります。 商品CSVデータ取り込みの実行によってCSVファイルが「waiting」フォルダから移動し ます。移動先は次のようになります。 ① 取り込み処理中の商品CSVデータファイルは「waiting」フォルダから「importing」 フォルダへと移動されます。画像ファイルや資料ファイル、画像資料ファイルを入れ た「images」フォルダは「importing」フォルダへは移動されません。 ② 取り込み処理が正常に完了した商品CSVデータファイルは「importing」フォルダか ら「imported」フォルダへと移動されます。画像ファイルや資料ファイル、画像資料 ファイルを入れた「images」フォルダは「imported」フォルダへは移動されません。 ③ 取り込み中にエラーが発生した商品CSVデータは「importing」フォルダから「error」 フォルダへ移動されます。画像ファイルや資料ファイル、画像資料ファイルを入れた 「images」フォルダは「error」フォルダへは移動されません。 ファイルアップロードツール：画面右(サーバー)側 importing：取り込み処理中の商品CSVデータが入る Waiting：取り込み処理前の商品CSVデータを入れる imported：取り込み処理完了の商品CSVデータが入る error：取り込み処理中にエラーが発生したの商品CSVデータが入る

22 「imported」フォルダまたは「error」フォルダに移動する際に商品CSVデータのファイ ル名は変更されます。 変更前 変更前 変更前 変更前：(任意のファイル名).csv 変更後 変更後 変更後 変更後：(メーカーの識別コード)_ (任意のファイル名).csv 赤字の部分が元のファイル名からの変更箇所になります。 また、エラーが発生した場合、エラーログファイルの内容を確認することが出来ます。 ファイル名 ファイル名 ファイル名 ファイル名：(日付8桁)_shell.log フォルダ フォルダ フォルダ フォルダ：/home/nikaya/niyaya_b2b/app_bse/tmp/logs ファイルアップロードツール：画面右(サーバー)側 商品CSVデータの取り込み処理でエラー発生の場合に作成されるログファイル (20120611_shell.logは2012年6月11日の商品CSVデータ取り込み処理で発生した エラー内容が書かれている)

23

まとめ

以上が商品CSVデータ取り込みの流れとなります。 インポートが完了したら管理画面、顧客画面の商品情報が登録・更新されます。 商品情報を入れ替える場合は商品CSVデータを再度アップロードし、インポートしなおす ことで商品情報を上書き登録することができます。

24

添付資料：商品

CSV

データのフォーマットについて

商品データのCSVファイルは半角カンマ区切りで下記の表の項目を設定します。 (※※※※ 入力必須入力必須入力必須入力必須)と記載してある項目は必ず設定を行なってください。 画像ファイル、追加画像ファイル、資料ファイルに設定を行った場合は、 CSVファイルと同じフォルダ内に「images」フォルダを作成して画像ファイルや資料ファイルを 「images」フォルダに必ずいれるようにしてください。 項目名 項目名 項目名 項目名 説明説明 説明説明 制約・備考など制約・備考など制約・備考など制約・備考など 大分類 商品大分類の分類コードを入力します。 入力した分類コードがデータベー ス上に存在しなければエラー 中分類 商品中分類の分類コードを入力します。 入力した分類コードがデータベー ス上に存在しなければエラー 小分類 商品小分類の分類コードを入力します。 入力した分類コードがデータベー ス上に存在しなければエラー 二加屋分類 商品の二加屋分類コードを入力します。 100文字以内 二加屋品番 商品の注文コードを入力します。 255文字以内 メーカー品番 商品のメーカー商品コードを入力します。 255文字以内 メーカーとメーカー品番が一致す れば上書き 商品グループ 商品グループ名を入力します。 255文字以内 品名 (※※※※ 入力必須入力必須入力必須入力必須) 商品の品名を入力します。 255文字以内 商品説明 商品の説明を入力します。 なし 材質 商品の材質を入力します。 255文字以内 色・仕上げ 商品の色や仕上げを入力します。 255文字以内 単位 商品の単位を入力します。（例：個、台） 10文字以内 定価 (※※※※ 入力必須入力必須入力必須入力必須) 商品の税別標準価格を入力します。 11文字以内 半角数字のみ許可する サイズ名1～16 商品のサイズ情報を入力します。 商品のサイズの名称を入力します。 255文字以内 サイズ値1～16 商品のサイズ情報を入力します。 商品のサイズの値を入力します。 255 文字以内 サイズ単位1～16 商品のサイズ情報を入力します。 商品のサイズの単位を入力します。 255文字以内 入数 商品の入数を入力します。 11文字以内

25 半角数字のみ許可する 追加項目名1～10 追加項目の表示名を入力します。 255文字以内 追加項目1～10 追加項目の内容を入力します。 255文字以内 備考 商品の備考／注意事項を入力します。 改行文字を使用する場合は、 半角ダブルクオーテーション(“)で 備考の入力内容を囲うこと 商品画像ファイル名 商品の画像を設定します。 画像ファイル名を入力します。 半角英数+拡張子 画像ファイルが「images」フォル ダに存在しなければ商品情報の 登録に失敗する 資料ファイル説明 1(※※※※) 商品の説明用の画像を設定します。 資料ファイル名1に対する説明を入力し ます。 255文字以内 ※ ※ ※ ※ 資料資料資料資料 ファイル名ファイル名ファイル名ファイル名1を指定した場を指定した場を指定した場を指定した場 合のみ 合のみ 合のみ 合のみ 入力入力入力入力 必須必須必須必須 資料ファイル名1～ 10 資料ファイル名を入力します。 資料ファイルには画像の他、各種ドキュメ ントを設定することが可能です。 255文字以内 資料ファイルが「images」フォル ダに存在しなければ商品情報の 登録に失敗する 追加画像ファイル説 明1～5(※※※※) 商品の説明用の画像を設定します。 追加画像ファイル名1に対する説明を入 力します。 255文字以内 ※ ※ ※ ※ 追加画像追加画像追加画像追加画像 ファイル名ファイル名ファイル名ファイル名1を指定しを指定しを指定しを指定し た場合のみ た場合のみ た場合のみ た場合のみ入力入力入力入力 必須必須必須必須 追加画像 ファイル名1～5 追加画像ファイル1に設定する画像ファイ ル名を入力します。 255文字以内 画像ファイルが「images」フォル ダに存在しなければ商品情報の 登録に失敗する