コンテンツにスキップ

レコードのインポート

概要

エクセルで管理していた簡易的な社員名簿を、プリザンターで管理できるようにデータのインポートを行うケースとして説明します。

プリザンター 1.3.11.2 以降では、キー項目を指定したインポートが可能となりました。テーブル機能:インポート時のキー項目指定
プリザンター1.4.16.0 以降では、「作成者」、「作成日時」、「更新者」、「更新日時」の取り込みが可能となる移行モード機能が追加されました。「テーブル機能:移行モードでのレコードのインポート」

操作手順

大まかな流れとしては、下記手順で進めます。
1. 社員名簿のエクセルデータを開き「名前を付けて保存」を選択し、ファイル形式で「CSV(コンマ区切り)(.csv)」または「CSV UTF-8(コンマ区切り)(.csv)」を選択して保存する
1.「社員名簿」記録テーブルの作成する
1.エディタで項目を設定する
1.「社員名簿.csv」をインポートする
1.一覧で一覧画面の表示項目を設定する

【注意事項】
・インポートするCSVデータのタイトル(CSVデータの1行目)と、プリザンターの項目名は一致させること。

(テーブルの管理-一覧ではなくエディタで表示される項目名に合わせてください)

・期限付きテーブルの場合「完了」項目は必須項目となります。
(記録テーブルの場合、必須項目はございません)

年-月-日形式で日付データをインポートする場合、年は4桁(yyyy-mm-dd)としてください。
年を2桁とした場合、仕様により正しくインポートできません。

インポートの手順

下記のエクセルデータの構成を例として説明します。
インポート元となる社員名簿のエクセルデータの例

「管理」 - テーブルの管理 - エディタタブを選択します。
プリザンターの仕様上「ID」、「バージョン」は無効化できませんので、その2つの項目は残して、それ以外を無効化し、以下の通り各項目を有効化してください。

[ プリザンターのエディタ設定画面]
有効化する項目を設定したエディタの設定画面

有効化した項目は以下の通り設定を変更します。有効化した項目を選択状態にして、「詳細設定」ボタンをクリックして各設定を行います。

項目名 データの種類 プリザンター項目 設定項目
社員ID 文字列 説明A スタイル:ノーマル
氏名 文字列 タイトル
出身地 文字列 説明B スタイル:ノーマル
性別 文字列 分類A 選択肢一覧:男 (改行) 女
生年月日 日付 日付A
年齢 数値 数値A

「性別」分類Aの選択肢一覧の記載内容 は以下のように設定します。
分類Aの選択肢一覧に「男」「女」を記述した設定
[項目名設定後のエディタ画面]
項目名を設定した後のエディタ画面

プリザンターにデータをインポートする場合、元データ(CSV)の項目名とプリザンターの項目名を一致させる必要があります。

CSVの項目名とプリザンターの項目名の対応を示した図

プリザンター側の項目名は一覧ではなくエディタで設定してください。

項目名を設定するエディタの画面

プリザンターの項目種別と、項目名を間違わないように注意してください。

項目の設定が完了したら、設定を「更新」をクリックして一覧画面に戻りインポートボタンをクリックします。
ダイアログが表示されたら、インポートするCSVファイルを選択します。
該当するCSVファイルの文字コードを選択し、インポートボタンをクリックします。
【注意事項】
インポートするCSVデータがShift-JISで保存されているか、UTF-8形式か確認し、下記のプリザンターのインポートダイアログに表示される「文字コード」欄にて保存されている形式を選んでください。

CSVファイルと文字コードを選ぶインポートのダイアログ

インポートが無事に完了すると下図のように一覧画面に表示されます。

インポートしたレコードが並ぶ一覧画面

次に、一覧画面を、エクセルで管理していたときと同じ内容が表示されるように設定して行きます。

「管理」 - テーブルの管理 - 一覧タブを選択します。
初期状態では以下の設定になっています。
テーブルの管理の「一覧」タブの初期状態

以下のように、今回インポートした全項目を表示するように設定します。
今回のデータ例では以下の項目を有効化します。(それ以外は無効化します。)
* 社員ID
* 氏名
* 出身地
* 性別
* 生年月日
* 年齢

項目の有効化を終えたら「更新」ボタンをクリックし、その後 「戻る」をクリックして一覧画面を表示します。
インポートした全項目を有効化した「一覧」タブの設定

元のエクセルデータのような一覧表示ができました。
全項目が表示された一覧画面

これでエクセルのデータをプリザンターに移行することができました。

インポートがうまく行かない場合の確認事項

・データがインポートできない、または一部しかインポートされていない ……

→[テーブルの管理]-[一覧]ではなく[エディタ]で設定した項目名とCSVデータのタイトルが一致しているか確認してください。

エディタで設定した項目名とCSVのタイトル行を見比べる図

→インポート時の文字コードが正しく選択されているか確認してください。

インポートのダイアログの「文字コード」欄
英数字は取り込めて、日本語がうまく取り込めないという場合は文字コードが正しくないケースが考えられますので、うまくいかない場合は、もう一方を試してみください。

→期限付きテーブルの場合「完了」項目は値が必須となります。
期限付きテーブルにデータをインポートする場合は「完了」項目には必ず値を入れてください。
※記録テーブルの場合には「完了」項目はありません。

→pleasanter.netでは一度のインポート処理で取り込めるレコード数が10,000行となっています。
10,000行を超える量のデータをインポートする場合は、10,000行ごとに区切ってインポートしてください。

→CSVファイルで値を設定してもインポートしない項目があります。
詳細は以下の表を確認してください。

項目名 レコード追加時 レコード更新時
ID プリザンターで自動採番 更新しない
バージョン プリザンターで自動採番 プリザンターで自動採番
作成者 インポート操作を行ったユーザ ※1 更新しない
作成日時 インポート操作を行った日時 ※1 更新しない
更新者 インポート操作を行ったユーザ ※1 インポート操作を行ったユーザ
更新日時 インポート操作を行った日時 ※1 インポート操作を行った日時
コメント CSVファイルの値 ※2 JSON形式の場合は洗い替え方式で更新
文字列形式の場合は更新しない

※1 移行モードでは、CSVファイルに設定されている値でインポートすることが可能です。詳細は「テーブル機能:移行モードでのレコードのインポート」を参照してください。
※2 JSON形式のデータレイアウトの値でインポートすることが可能です。詳細はJSONデータレイアウト:コメントを参照してください。

対応バージョン

対応バージョン 内容
1.4.18.0 以降 CSVインポートでレコード更新時にコメントを更新する機能を追加

関連情報