第1章 検索結果一覧を取得する - Next-L Enju Web APIマニュアル
第1章 検索結果一覧を取得する
Enju は検索結果一覧を好みのフォーマットで取得する機能があります。
- .txt
- .json
- .rdf
- .xml
- .mods
- .sru
- .html
などを取得できます。
1-1 TSVを取得する
1-1-1 TSV取得方法
1. 検索結果を表示します。
2. 検索結果のアドレス欄のURLのmanifestationsの後ろに.txtを追加します。
例 (変更前):http://localhost:8080/manifestations?utf8=%E2%9C%93&query=&commit=%E6%A4%9C%E7%B4%A2 (変更後):http://localhost:8080/manifestations.txt?utf8=%E2%9C%93&query=&commit=%E6%A4%9C%E7%B4%A2
にします
※ 検索結果画面の右メニューの[TSV]リンクをクリックした先のURLと同様です(詳細:利用者マニュアルの「1-8-3 TSV 形式で書き出し」)。
3. この検索結果画面がTSV形式で表示されます。
※現在、表示している検索結果のみを表示します。他の画面の検索結果は含みません。 ※Enju Leaf1.3.3以前は、改行は \n に変換されていましたが、Enju Leaf1.3.4以降では改行はそのままとなりますので、改行がはいったデータがある場合、Excelへのインポートでは次の列になってしまうことに注意(Googleスプレッドシートなどでは問題なくできます)。
1-1-2 書誌と所蔵のTSVの例
manifestation_id original_title title_alternative title_transcription statement_of_responsibility serial manifestation_identifier creator contributor publisher pub_date year_of_publication publication_place manifestation_created_at manifestation_updated_at carrier_type content_type frequency language isbn issn volume_number volume_number_string edition edition_string issue_number issue_number_string serial_number extent start_page end_page dimensions height width depth price access_address manifestation_required_role abstract description note identifier:isbn identifier:issn identifier:jpno identifier:doi identifier:iss_itemno identifier:lccn identifier:ncid identifier:loc_identifier identifier:issn_l identifier:epi series_statement_id series_statement_original_title series_statement_title_subseries series_statement_title_subseries_transcription series_statement_title_transcription series_statement_creator series_statement_volume_number series_statement_series_master series_statement_root_manifestation_id series_statement_manifestation_id series_statement_position series_statement_note series_statement_created_at series_statement_updated_at manifestation_memo manifestation:custom subject:unknown subject:ndlsh subject:bsh subject:lcsh classification:ndc9 classification:ddc classification:ndc8 classification:ndc10 jpno ncid item_id item_identifier binding_item_identifier call_number shelf item_note accepted_at acquired_at item_created_at item_updated_at bookstore budget_type item_required_role item_price item_memo item:custom use_restriction circulation_status checkout_type total_checkouts 94 メッセンジャー : 緑の森の使者 MESSENGER メッセンジャー : ミドリ ノ モリ ノ シシャ ロイス・ローリー [著]; 島津やよい 訳 http://iss.ndl.go.jp/books/R100000002-I025741509-00 Lowry, Lois, 1937-//島津, やよい 新評論 2014-01-01 00:00:00 +0900 2014 東京 2022-03-21 21:59:30 +0900 2022-03-21 22:05:47 +0900 volume text unknown Japanese 9784794809773 228p 1 228 20cm 20 1500 Guest 人類の行く末を戦慄をもって描く近未来小説「ギヴァー」に始まる4部作の3冊目。相互扶助の平和な村に暮らす少年マティに訪れた運命の急旋回とは…。 (日本図書館協会) 9784794809773 22464008 R100000002-I025741509-00 933.7 22464008 75 2011 933.7|ロ|1 tachibana_default 2022-03-21 22:00:58 +0900 2022-03-21 22:05:47 +0900 Guest Limited Circulation, Normal Loan Period Available On Shelf book 0
- 注:Enju Leaf 1.3.6のTSVです。
1-1-3 書誌と所蔵のTSVの項目
次の項目が入っています(Enju Leaf 1.3.6)。
| 項目ID | 項目名 | 備考 | 閲覧権限 |
|---|---|---|---|
| manifestation_id | 書誌ID | ||
| original_title | 原題 | ||
| title_alternative | 代替タイトル | ||
| title_transcription | タイトルのヨミ | ||
| statement_of_responsibility | 責任表示 | ||
| serial | 逐次刊行物 | 情報知識学会誌などの雑誌の場合「逐次刊行物」にチェックが入る、そういう場合は値がtrueとなる(普通は空だが、falseが入ることがある) | |
| manifestation_identifier | ローカル識別子 | ||
| creator | 著者 | 著者の役割があった場合は、役割付きで出力される(詳細:「TSVファイルの作り方のcreator」を参照) | |
| contributor | 協力者・編者 | ||
| publisher | 出版者 | ||
| pub_date | 出版日 | ||
| year_of_publication | 出版年 | ||
| publication_place | 出版地 | ||
| manifestation_created_at | 書誌情報作成日 | エクスポートのみの項目 | |
| manifestation_updated_at | 書誌情報更新日 | エクスポートのみの項目 | |
| carrier_type | 資料種別 | ||
| content_type | 資料の内容の種類 | ||
| frequency | 発行頻度 | ||
| language | 言語 | ||
| isbn | ISBN | ||
| issn | ISSN | ||
| volume_number | 巻(数字) | ||
| volume_number_string | 巻 | ||
| edition | 版(数字) | ||
| edition_string | 版 | ||
| issue_number | 号(数字) | ||
| issue_number_string | 号 | ||
| serial_number | 通号 | ||
| extent | ページ数 | ||
| start_page | 最初のページ | ||
| end_page | 最後のページ | ||
| dimensions | 大きさ | ||
| height | 高さ(cm) | ||
| width | 幅(cm) | ||
| depth | 奥行き(cm) | ||
| manifestation_price | 販売価格 | 少なくともEnju Leaf 1.3.4~1.3.6は「price」(修正予定あり) | |
| access_address | アクセスアドレス | ||
| manifestation_required_role | 書誌情報の参照に必要な権限 | ||
| abstract | 内容細目 | Enju Leaf 1.3.6より出力 | |
| description | 説明 | ||
| note | 注記 | ||
| identifier:isbn | ISBN | (入力データによってはほかにも identifier: からはじまるものがあります) | |
| identifier:issn | ISSN | ||
| identifier:jpno | 全国書誌番号 | ||
| identifier:doi | DOI | ※入力データによっては出力されないこともあります。 (入力データによってはほかにも identifier: からはじまるものがあります) |
|
| identifier:iss_itemno | NDLサーチID | ||
| identifier:lccn | LCCN | ※入力データによっては出力されないこともあります。 (入力データによってはほかにも identifier: からはじまるものがあります) |
|
| identifier:ncid | NCID | ※入力データによっては出力されないこともあります。 (入力データによってはほかにも identifier: からはじまるものがあります) |
|
| identifier:loc_identifier | 米国議会図書館OPACのID | ※入力データによっては出力されないこともあります。 (入力データによってはほかにも identifier: からはじまるものがあります) |
|
| identifier:issn_l | ISSN_L | ※入力データによっては出力されないこともあります。 (入力データによってはほかにも identifier: からはじまるものがあります) |
|
| series_statement_id | シリーズID | ||
| series_statement_original_title | シリーズ名 | ||
| series_statement_title_subseries | 副シリーズ名 | ||
| series_statement_title_subseries_transcription | 副シリーズ名のヨミ | ||
| series_statement_title_transcription | シリーズ名のヨミ | ||
| series_statement_creator | シリーズ著者 | ||
| series_statement_volume_number | シリーズ巻号 | ||
| series_statement_series_master | シリーズマスタ | シリーズのマスタかどうか | |
| series_statement_root_manifestation_id | 親書誌のID(シリーズ) | 親書誌のID(シリーズ) | |
| series_statement_manifestation_id | 同じシリーズの資料 | 同じシリーズの資料(複数あり, // で区切る)、シリーズにひもづいているmanifestation IDが記述される | |
| series_statement_position | シリーズ中の表示順序 | シリーズ中の表示順序。シリーズの中に複数資料があるときの表示順 | |
| series_statement_note | シリーズの注記 | ||
| series_statement_created_at | シリーズ情報の作成日 | ||
| series_statement_updated_at | シリーズ情報の更新日 | ||
| manifestation_memo | 業務メモ(書誌) | ※書誌。Enju Leaf 1.3.6より出力 | Administrator権限、Librarian権限のときのみ出力 |
| manifestation:custom1 | カスタム項目(書誌) | ※設定に応じて “custom1” の部分には項目コードが入ります | Administrator権限、Librarian権限のときのみ出力 |
| subject:unknown | 件名(unknown) | ※入力データによっては出力されないこともあります。 (入力データによってはほかにも subject: からはじまるものがあります) |
|
| subject:ndlsh | 件名(NDLSH) | ※入力データによっては出力されないこともあります。 (入力データによってはほかにも subject: からはじまるものがあります) |
|
| subject:bsh | 件名(BSH) | ※入力データによっては出力されないこともあります。 | |
| subject:lcsh | 件名(LSH) | ※入力データによっては出力されないこともあります。 | |
| classification:ndc9 | 分類(NDC9版) | ※入力データによっては出力されないこともあります。 | |
| classification:ddc | 分類(DDC) | ※入力データによっては出力されないこともあります。 | |
| classification:ndc8 | 分類(NDC8版) | ※入力データによっては出力されないこともあります。 | |
| classification:ndc10 | 分類(NDC10版) | ||
| jpno | JPNO | ||
| ncid | NCID | ※入力データによっては出力されないこともあります。 | |
| item_id | 所蔵データID(自動付与) | ||
| item_identifier | 所蔵情報ID | ||
| binding_item_identifier | 製本後の所蔵情報ID | ||
| call_number | 請求記号 | ||
| library | 図書館 | 少なくともEnju Leaf 1.3.4~1.3.6は出力しない(修正予定あり) | |
| shelf | 本棚 | ||
| item_note | 注記(所蔵) | ||
| accepted_at | 検収日 | エクスポートのみの項目 | |
| acquired_at | 受入日 | ||
| item_created_at | 所蔵情報作成日 | エクスポートのみの項目 | |
| item_updated_at | 所蔵情報更新日 | エクスポートのみの項目 | |
| bookstore | 書店 | Administrator権限、Librarian権限のときのみ出力 | |
| budget_type | 予算種別 | Administrator権限、Librarian権限のときのみ出力 | |
| item_required_role | 所蔵情報の閲覧に必要な権限 | ||
| item_price | 購入価格 | Administrator権限、Librarian権限のときのみ出力 | |
| item_memo | 業務メモ(所蔵) | ※所蔵。Enju Leaf 1.3.6より出力 | Administrator権限、Librarian権限のときのみ出力 |
| item:custom1 | カスタム項目(所蔵) | ※設定に応じて “custom1” の部分には項目コードが入ります | Administrator権限、Librarian権限のときのみ出力 |
| use_restriction | 利用制限 | Administrator権限、Librarian権限のときのみ出力 注:1.3.0以前ではguestアカウントでも出力されます。1.3.1からは修正されています。)(参照: issue #1366) | |
| circulation_status | 貸出状態 | ||
| checkout_type | 貸出区分 | ||
| total_checkouts | 貸出回数 | エクスポートのみの項目 | Administrator権限、Librarian権限のときのみ出力 |
※1 その他、書誌に登録されている識別子(例:jpno,ncid)は全て出力されます。
※2 識別子や分類や件名で複数あるものは//で区切られて出力されます。
1-2 RDF/XML形式のデータを取得する
1-2-1 RDF/XML形式のデータ取得方法
1. 検索結果を表示します。
2. 検索結果のアドレス欄のURLのmanifestationsの後ろに.rdfを追加します。
例 (変更前):http://localhost:8080/manifestations?utf8=%E2%9C%93&query=&commit=%E6%A4%9C%E7%B4%A2 (変更後):http://localhost:8080/manifestations.rdf?utf8=%E2%9C%93&query=&commit=%E6%A4%9C%E7%B4%A2
にします
※ 検索結果画面の右メニューの[RDF/XML]リンクをクリックした先のURLと同様です(詳細:利用者マニュアル「1-8-1 RDF/XML 形式で書き出し」)。
3. この検索結果画面がRDF/XML形式で表示されます。
※現在、表示している検索結果のみを表示します。他の画面の検索結果は含みません。
1-2-2 書誌と所蔵のRDF/XML形式のデータの例
<?xml version="1.0" encoding="UTF-8"?>
<rdf:RDF xmlns="http://purl.org/rss/1.0/" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:dcterms="http://purl.org/dc/terms/" xmlns:dcndl="http://ndl.go.jp/dcndl/terms/" xmlns:foaf="http://xmlns.com/foaf/0.1/" xmlns:prism="http://prismstandard.org/namespaces/basic/2.0/" xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#">
<channel rdf:about="http://localhost:8080/manifestations?format=rdf&only_path=true&query=">
<title>検索語 による えんじゅ図書館 の資料の検索結果</title>
<link>http://localhost:8080/manifestations?query=</link>
<description>Next-L Enju, an open source integrated library system developed by Project Next-L</description>
<language>ja</language>
<ttl>60</ttl>
<items>
<rdf:Seq>
<rdf:li rdf:resource="http://localhost:8080/manifestations/2"/>
<rdf:li rdf:resource="http://localhost:8080/manifestations/1"/>
</rdf:Seq>
</items>
</channel>
<item rdf:about="http://localhost:8080/manifestations/2">
<title>パーフェクトRuby on Rails</title>
<link>http://localhost:8080/manifestations/2</link>
<description>技術評論社; 2014-07</description>
</item>
<item rdf:about="http://localhost:8080/manifestations/1">
<title>Ruby on Rails入門 : 優しいRailsの育て方</title>
<link>http://localhost:8080/manifestations/1</link>
<description>秀和システム; 2006-08</description>
</item>
</rdf:RDF>
1-3 JSON形式のデータを取得する
1-3-1 JSON形式のデータ取得方法
1. 検索結果を表示します。
2. 検索結果のアドレス欄のURLのmanifestationsの後ろに.jsonを追加します。
例 (変更前):http://localhost:8080/manifestations?utf8=%E2%9C%93&query=&commit=%E6%A4%9C%E7%B4%A2 (変更後):http://localhost:8080/manifestations.json?utf8=%E2%9C%93&query=&commit=%E6%A4%9C%E7%B4%A2
にします
3. この検索結果画面に表示されている書誌情報がJSON形式で表示されます。
※現在、表示している検索結果のみを表示します。他の画面の検索結果は含みません。
1-3-3 書誌と所蔵のJSON形式のデータの例
{
total_count: 51,
results: [ {
id: 12825,
original_title: "Ruby on Rails 5超入門",
title_alternative: null,
title_transcription: "ルビー オン レイルズ ファイヴ チョウニュウモン",
title_alternative_transcription: null,
pub_date: "2016",
statement_of_responsibility: "掌田津耶乃 著",
creators: [ { full_name: "掌田, 津耶乃" } ],
contributors: [ ],
publishers: [ { full_name: "秀和システム" } ],
publication_place: "東京",
extent: "542p",
dimensions: "24cm",
identifiers: [
{ identifier_type: "isbn", body: "9784798048321" },
{ identifier_type: "iss_itemno", body: "R100000002-I027769223-00" },
{ identifier_type: "jpno", body: "22839928" }
],
subjects: [ { subject_heading_type: "ndlsh", term: "ウェブアプリケーション" } ],
classfifications: [ { classification_type: "ndc9", term: "547.483" } ],
access_address: null,
items: [ { item_identifier: "098567", shelf: "一般書架" } ],
created_at: "2019-07-28T14:38:16.570+09:00",
updated_at: "2019-07-28T14:39:16.317+09:00"
}, {
id: 12661,
original_title: "はじめてのRuby on Rails 3 : 「Webアプリケーション」作りに定番の「フレームワーク」を使う!",
title_alternative: "",
title_transcription: "ハジメテ ノ Ruby on Rails 3 : Web アプリケーション ズクリ ニ テイバン ノ フレームワーク オ ツカウ",
title_alternative_transcription: null,
pub_date: "2010-11",
statement_of_responsibility: "清水美樹 著",
creators: [ { full_name: "清水, 美樹" } ],
contributors: [ ],
publishers: [ { full_name: "工学社" } ],
publication_place: "東京",
extent: "303p",
dimensions: "21cm + CD-ROM1枚 12cm",
identifiers: [
{ identifier_type: "isbn", body: "9784777515639" },
{ identifier_type: "iss_itemno", body: "R100000002-I000011044291-00" },
{ identifier_type: "jpno", body: "21852544" }
],
subjects: [ ],
classfifications: [ { classification_type: "ndc9", term: "547.483" } ],
access_address: "",
items: [ ],
created_at: "2019-01-26T12:01:53.107+09:00",
updated_at: "2019-07-28T14:38:18.179+09:00"
} ]
}
1-3-3 書誌と所蔵のJSON形式の項目
JSON形式は以下のキーと値のペアから構成されます。
| 項目ID | 項目名 | 備考 |
|---|---|---|
| total_count | ヒット件数 | |
| results | 検索結果レコード | 配列として各書誌情報が出力される |
各レコードの書誌情報は以下のキーと値のペアから構成されます。
| 項目ID | 項目名 | 備考 |
|---|---|---|
| id | 書誌ID | |
| original_title | タイトル | |
| title_alternative | 別タイトル | |
| title_transcription | タイトル(読み) | |
| title_alternative_transcription | 別タイトル(読み) | |
| pub_date | 出版日 | |
| statement_of_responsibility | 責任表示 | |
| creators | 著者 | 配列として表現 |
| contributors | 貢献者 | 配列として表現 |
| publishers | 出版者 | 配列として表現 |
| publication_place | 出版地 | |
| extent | ページ数 | |
| dimentions | 大きさ | |
| identifiers | 識別子 | |
| subjects | 件名 | |
| classifications | 分類 | |
| access_address | URL | |
| items | 所蔵レコード | 配列として表現 |
| created_at | 作成日時 | |
| updated_at | 更新日時 |
Documentation for Next-L Enju 1.3