レコードのインポート

2020年1月23日2025年9月22日

概要¶

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

プリザンター1.4.16.0以降

「作成者」、「作成日時」、「更新者」、「更新日時」の取り込みが可能となる移行モード機能が追加されました。
→移行モードでのレコードのインポート
プリザンター1.3.11.2以降

キー項目を指定したインポートが可能となりました。
→インポート時のキー項目指定

操作手順¶

下記手順で進めます。

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

確認事項

インポートするCSVデータのタイトル(CSVデータの1行目)と、プリザンターの項目名は一致させること。
(テーブルの管理-一覧ではなくエディタで表示される項目名に合わせてください)
期限付きテーブルの場合「完了」項目は必須項目となります。
(記録テーブルの場合、必須項目はございません)
年-月-日形式で日付データをインポートする場合、年は4桁（yyyy-mm-dd）としてください。
年を2桁とした場合、仕様により正しくインポートできません。

インポートの手順¶

下記のエクセルデータの構成を例として説明します。

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

プリザンターの「エディタ」設定画面

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

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

「性別」分類Aの選択肢一覧の記載内容を、以下のように設定します。

項目名設定後のエディタ画面
プリザンターにデータをインポートするために、元データ(CSV)の項目名とプリザンターの項目名を一致させます。

Warning

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

プリザンターの項目種別と、項目名を間違わないように注意してください。
項目の設定が完了したら、設定を「更新」をクリックして一覧画面に戻りインポートボタンをクリックします。
ダイアログが表示されたら、インポートするCSVファイルを選択します。
該当するCSVファイルの文字コードを選択し、インポートボタンをクリックします。

確認事項

インポートするCSVデータがShift-JISで保存されているか、UTF-8形式か確認し、下記のプリザンターのインポートダイアログに表示される「文字コード」欄にて保存されている形式を選んでください。
インポートが無事に完了すると下図のように一覧画面に表示されます。
次に、一覧画面を、エクセルで管理していたときと同じ内容が表示されるように設定して行きます。
「管理」→「テーブルの管理」→「一覧」タブを選択します。初期状態では以下の設定になっています。

以下のように、今回インポートした全項目を表示するように設定します。今回のデータ例では以下の項目を有効化します。（それ以外は無効化します。）
- 社員ID
- 氏名
- 出身地
- 性別
- 生年月日
- 年齢
項目の有効化を終えたら「更新」ボタンをクリックし、その後「戻る」をクリックして一覧画面を表示します。
元のエクセルデータのような一覧表示ができました。

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

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

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

「テーブルの管理」→「一覧」ではなく「エディタ」で設定した項目名とCSVデータのタイトルが一致しているか確認してください。
インポート時の文字コードが正しく選択されているか確認してください。

英数字は取り込めて、日本語がうまく取り込めないという場合は文字コードが正しくないケースが考えられますので、うまくいかない場合は、もう一方を試してみてください。
期限付きテーブルの場合「完了」項目は値が必須です。

期限付きテーブルにデータをインポートする場合は「完了」項目には必ず値を入れてください。¹
Pleasanter.netでは一度のインポート処理で取り込めるレコード数が10,000行となっています。

10,000行を超える量のデータをインポートする場合は、10,000行ごとに区切ってインポートしてください。

CSVファイルで値を設定してもインポートしない項目があります。

詳細は以下の表を確認してください。

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

対応バージョン¶

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