Title: CSVでインポートする（一括登録）

この記事では、PMCRM のマスター情報である「取引先」と「名刺」記事を CSV ファイルから一括登録（インポート）する方法を説明します。



必要なソフトウェアの準備



Ruby



インポートするためのスクリプトはプログラミング言語「Ruby」で書かれており、スクリプトを実行するには Ruby が必要です。

Windows 環境に Ruby をインストールするには RubyInstaller が利用できます。

詳しくは、Ruby の公式サイトの Download ページを参照してください。

この記事では、以下、Windows 11 環境に Ruby+Devkit 3.1.3-1 (x64) をインストールした例で説明します。

TractionPublish



TeamPage には、「TractionPublish」という名前の、コマンドから記事を作成（投稿）するツールが用意されています。

ここで使用する Ruby スクリプトは、CSV ファイルからパラメーターを作成し、TractionPublish にパラメーターを渡して実行し、指定された TeamPage に取引先や名刺の記事を作成（投稿）します。

TractionPublish は、TeamPage がインストールされた「server」フォルダにあります。



スクリプトとサンプル CSV ファイル



下のファイルをダウンロードしてください。

PMCRM Importers /db/attachments/docpmcrm/21/share
 4.2 KBcompanies.rb2023/02/1712:26:19 JST
 1.3 KBcompanies.utf8.csv2023/02/1712:26:18 JST
 998 Bconfig.rb2023/02/1712:26:54 JST
 4.8 KBcontacts.rb2023/02/1712:26:19 JST
 1.4 KBcontacts.utf8.csv2023/02/1712:26:19 JST


Ruby スクリプト



companies.rb ... 取引先のインポートに使用します。

contacts.rb ... 名刺のインポートに使用します。

config.rb ... アップロード先の TeamPage の URL や、ユーザー名、パスワードなどを設定します。テキストエディタで開いて編集してください。





サンプル CSV ファイル



これらのサンプル CSV ファイルの文字コードは UTF-8 です。Excel で直接開くと文字化けしますので、Excel の [データ] からインポートしてください。

参照: FAQ2707: エクスポートしたUTF-8のCSVをExcelで開く方法

companies.utf8.csv ... 取引先のサンプルです。

contacts.utf8.csv ... 名刺のサンプルです。

これらのサンプルを元に、インポートする取引先および名刺の CSV データを作成して下さい。

Excel から CSV ファイルを保存する場合、[ファイルの種類] で [CSV UTF-8 (コンマ区切り)] を選択し、文字コードを UTF-8 にしてください。文字コードが Shift-JIS の場合、正常にインポートできません。



スクリプトの実行



Windows で「Windows Power Shell」を起動します。（Windows のメニューの検索欄に「Power Shell」と入力すると見つかります。）



ここでは、Ruby スクリプトや CSV ファイルを C:\temp\pmcrm というフォルダに保存するとします。



Power Shell で cd コマンドを使って当該フォルダへパスを移動します。



取引先をアップロードするには、次のコマンドを実行します。（「CSVFileName」の部分を置き換えてください。） 

ruby companies.rb CSVFileName


名刺をアップロードするには、次のコマンドを実行します。（「CSVFileName」の部分を置き換えてください。） 

ruby contacts.rb CSVFileName


下図は、「companies.utf8.csv」という名前の CSV ファイルで取引先をアップロードする例です。



実行すると、指定した CSV ファイルから 1 行ずつデータが読み込まれ、config.rb で指定された TeamPage のスペースに投稿されます。

投稿に成功すると、投稿された取引先記事の URL が表示されます（下図の赤下線部分）。下図の例は、取引先記事が「Sandbox2120」という記事 ID で投稿されたことを示しています。



TeamPage にアクセスして正しく投稿されていることを確認します。







Attachments:
traction_publish_exe.png
excel_csv_utf8.png
launch_power_shell.png
path1.png
command01.png
config_rb.png
command02.png
command03.png
new_companies.png
new_company.png
Shared Files for DocPMCRM21
関連記事
参照されている (1)
DocPMCRM1: TeamPage PMCRM マニュアル
参照している (1)
FAQ2707: エクスポートしたUTF-8のCSVをExcelで開く方法
Article: DocPMCRM21 (permalink)
Date: 2023/02/17; 11時54分58秒 JST

Author Name: TeamPage サポート
Author ID: jpbo