第3章 利用者情報を管理する - Next-L Enju 運用マニュアル

TSVファイルとは、項目をタブで区切ったテキストファイルです。サンプルファイルは、[https://github.com/next-l/enju_leaf/blob/1.1/examples/user_import_file_sample.tsv](https://github.com/next-l/enju_leaf/blob/1.1/examples/user_import_file_sample.tsv)を参照してください。Enjuで利用するTSVファイルでは、1行目にそれぞれの項目に関わるフィールド名を指定します。フィールド名および値は原則として " " で囲みます。 フィールド名とその意味については次の通りです。

■利用者情報の項目

<table class="table table-bordered table-condensed table-striped"> <caption>利用者情報の項目</caption> <thead> <tr> <th>フィールド名</th> <th>データ形式</th> <th>内容</th> <th>未入力の場合（作成時）</th> </tr> </thead> <tbody> <tr> <td>username</td><td>ascii</td><td>ユーザ名（入力必須）</td><td>（インポートが「失敗」になる）</td> </tr> <tr> <td>password</td><td>ascii</td><td>パスワード（入力推奨）：登録しなければ、登録 直後は利用不能／後日adminが指定するしかない</td> <td>未設定</td> </tr> <tr> <td>full_name</td><td>utf8</td><td>フルネーム</td><td>未設定</td> </tr> <tr> <td>full_name_transcription</td><td>utf8</td><td>フルネーム（ヨミ）</td><td>未設定</td> </tr> <tr> <td>user_number</td><td>ascii</td><td>利用者番号（数字以外にアルファベットも使用可能）</td> <td>未設定</td> </tr> <tr> <td>email</td><td>ascii</td><td>メールアドレス：2つ以上入力したい場合は注記（note）に書くしかない</td><td>未設定</td> </tr> <tr> <td>library</td><td>code</td><td>既定の図書館</td> <td>インポート時に「既定の図書館」として指定した図書館</td> </tr> <tr> <td>user_group</td><td>code</td><td>利用者グループ※1</td><td>インポート時に「既定の利用者グループ」として指定した利用者グループ</td> </tr> <tr> <td>locale</td><td>code</td><td>（使用）言語(日本語の場合：ja,　英語の場合：en) ※2</td><td>ja</td> </tr> <tr> <td>role</td><td>code</td><td>権限（Guest, User, Librarian, Administrator ）</td> <td>User</td> </tr> <tr> <td>expired_at</td><td>ISO8601</td><td>有効期限（2011-01-30　のような形式）</td> <td>未設定</td> </tr> <tr> <td>checkout_icalendar_token</td><td>ascii</td><td>貸出期限のicalendar urlに使うトークン</td> <td>未設定</td> </tr> <tr> <td>save_checkout_history</td><td>ascii</td><td>貸出の履歴を保存するかどうか。t または　TRUE または trueなら真（保存する）。</td> <td>FALSE</td> </tr> <tr> <td>locked</td><td>ascii</td><td>利用不可のアカウントにするかどうか。t または　TRUE または trueなら真（利用不可にする）。</td> <td>FALSE</td> </tr> <tr> <td>required_role</td><td>code</td><td>参照に必要な権限（Guest, User, Librarian, Administrator ）</td> <td>Librarian</td> </tr> <tr> <td>keyword_list</td><td>utf8</td><td>キーワードリスト。//で区切る。</td> <td>未設定</td> </tr> <tr> <td>save_search_history</td><td>ascii</td><td>資料の検索履歴をデータベースに保存するかどうか。t または　TRUE または trueなら真（保存にする）。 ※3</td> <td>FALSE</td> </tr> <tr> <td>share_bookmarks</td><td>ascii</td><td>ブックマークが他のユーザから参照できるかどうか。t または　TRUE または trueなら真（参照可にする）。※4</td> <td>FALSE</td> </tr> <tr> <td>note</td><td>utf8</td><td>注記</td> <td>未設定</td> </tr> <tr> <td>dummy</td><td>utf8</td><td>ダミー行の指定（なにかを書いているとその行は無視する行と判定される）</td> <td>（読み込まれる行と判定される）</td> </tr> </tbody> </table>

※1 利用者のグループの[名前]については[初期設定マニュアル「3-4 利用者グループを設定する」](enju_setup_3.html#section3-4)を参照ください。

※2 環境によっては異なることがあります。 使用できるものに何があるかは，[初期設定マニュアル「7-1 システムの基本的な情報の表示」](enju_setup_7.html#section7-1)機能でわかります。

※3 注意：モジュール enju_search_log をインストールした場合（[インストールマニュアル 5-6節](enju_install_vm_5.html#section5-6)参照）にのみ使用できます。インストールしていない場合は、無視されます。

※4 注意：モジュール enju_bookmark をインストールした場合（[インストールマニュアル 5-5節](enju_install_vm_5.html#section5-5)参照）にのみ使用できます。インストールしていない場合は、無視されます。

<div class="alert alert-info memo">【Memo】［編集］モードで［更新］を選択すると、TSVファイルで利用者情報をまとめて更新できます。TSVファイルに必要なのは、更新したい利用者のユーザ名（<code>username</code>）と、更新したいフィールドの内容になります。また、［削除］を選択すると、TSVファイルで利用者情報をまとめて削除できます。この場合は、TSVファイルに必要なのは、削除したい利用者のユーザ名（<code>username</code>）のみです。 </div>

<div class="alert alert-info memo">【Memo】[文字コード]は基本的には自動判別でよいですが、うまくいかない場合は、文字コードを指定するようにしてください。 </div>

<div class="alert alert-info memo">【Memo】[既定の利用者グループ]や[既定の図書館]は、TSVファイルに[利用者グループ]（user_group列）や[図書館]（library列）の値がない場合やTSVファイルで当該値に無効な値を指定していた場合に登録される値となります。TSVファイルに有効な値が指定されていた場合はTSVファイルを優先します。プルダウンメニューのデフォルト値は、現在ログイン中のユーザの利用者グループと図書館です。 </div>

<div class="alert alert-info memo">【Memo】この画面は[図書館の管理]メニュー→[インポート]→[利用者アカウント]とすればいつでも閲覧できます。 </div>

TSVファイルになんらかのエラーがありインポートの状態が[失敗]となることがあります。状態が[失敗]となった場合は、[表示]をクリックしてエラーメッセージを確認してください。「エラーメッセージ」にエラーのあった行とその理由が記述されています。エラーのあった行のレコードは登録されていませんので、エラーのあった行のみを抜き出してエラーを修正して再度登録する必要があります。

登録した利用者情報は、不要になった際に削除できます。

<div class="alert alert-info" markdown="1">

【Memo】削除したい利用者情報が書かれたTSVファイルを用いて、複数の利用者情報をまとめて削除することもできます。TSVを用いた利用者情報の削除のやり方の詳細については、[「3-2 既存のデータから利用者情報をインポートする 」](#section3-2)を参照してください。

</div>

利用者の一覧を、画面上で表示し、利用者情報を表示することができます。

<div class="alert alert-info memo" markdown="1"> 【Memo】

Enjuに登録されている利用者は、検索語（キーワード）で検索することができます。

Enjuで扱えない利用者情報を別のシステムで管理して、別システムで検索した利用者情報から、Enjuの利用者詳細画面につなげる方法を説明します。 Enjuのカスタマイズをすることなく、必要な利用者情報を管理できるようになります。

ここでは簡便なやり方として、MS Excelを使ったやり方を説明しますが、Accessや他のアプリケーションでも同様にできます。（注意：Excelファイルにパスワードを掛けるなど、漏えい対策に気を付けてください）

例えば、Excelでこのようなファイルを作ります。

このファイルで、生年月日や住所などEnjuに入力していない情報で利用者の情報を検索して、本人確認のための利用者情報を調べることができますし、URLのリンクをたどれば、その利用者のページにたどりつけます。

サンプルファイルは、 [Next-L公式サイト（https://www.next-l.jp/?page=etc%5Ffiles&file=userinfo%5Flocalfile%5Fsample%2Exlsx&action=ATTACH）](https://www.next-l.jp/?page=etc%5Ffiles&file=userinfo%5Flocalfile%5Fsample%2Exlsx&action=ATTACH) にありますので、参考にしてください。ここで用いている情報は架空のものです。

例えば、「ユーザ名」が 「u550001」 であれば、以下のようなURLを書けば そのユーザ名の詳細画面に行くリンクになります。「localhost:8080」のところは適宜、書き換えてください。 （例えば、デモサーバーであれば、 「enju.next-l.jp」になります。）

作成した、Excelファイルを使って、利用者の生年月日等で本人確認を行い、 ユーザ名を知ることができます。

「リンク」列の当該「ユーザ名」のリンクをたどります。

右メニューの[貸出の新規作成]をクリックして 当該利用者の利用者番号の入った貸出画面に行くこともできます （詳細：[「3-5 利用者情報を表示する」の 3.](#user_info_page)）。

Enjuのサーバーの設定が必要です。1回だけ必要です。

として、Gemfile の最後に以下の行を追加

ファイルを保存

として、Enjuを再起動。

Administrator権限のユーザーでログインしている場合は、 登録されている全ての利用者情報をTSVとしてエクスポートすることができます。

※ Administrator 権限でログインしておく必要があります。

※　Administrator 権限ログインしていない場合は[利用者情報のエクスポート]リンクが表示されません。

<div class="alert alert-info memo">【Memo】この画面は[図書館の管理]メニュー→[エクスポート]→[利用者情報のエクスポート]とすればいつでも閲覧できます。</div>

<div class="alert alert-success memo" markdown="1"> <h4 class="alert-heading">【Column】TSVファイル</h4>

次の項目が入っています(Enju Leaf 1.1.0)。

</div>