第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 更新日時