第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形式で表示されます。

※現在、表示している検索結果のみを表示します。他の画面の検索結果は含みません。

1-1-2 書誌と所蔵のTSVの例

manifestation_id	original_title	title_transcription	creator	contributor	publisher	pub_date	statement_of_responsibility	manifestation_price	manifestation_created_at	manifestation_updated_at	manifestation_identifier	access_address	description	note	extent	dimensions	carrier_type	edition	edition_string	volume_number	volume_number_string	issue_number	issue_number_string	serial_number	isbn	issn	jpno	doi	iss_itemno	lccn	subject:unknown	subject:ndlsh	subject:bsh	subject:lcsh	classification:ndc9	classification:ddc	classification:ndc8	classification:ndc10	item_id	item_identifier	call_number	item_note	item_price	acquired_at	accepted_at	bookstore	budget_type	total_checkouts	circulation_status	shelf	library	item_created_at	item_updated_at
3	パーフェクトRuby on Rails	パーフェクト ルビー オン レイルズ	すがわら, まさのり, 1982-//前島, 真一//近藤, 宇智朗		技術評論社	2014-07	すがわらまさのり, 前島真一, 近藤宇智朗, 橋立友宏 著	2880	2018-01-08 21:27:20 +0900	2018-01-08 21:27:57 +0900	http://iss.ndl.go.jp/books/R100000002-I025470389-00				431p	23cm	volume								9784774165165		22426486		R100000002-I025470389-00		""	ウェブアプリケーション	""	""	547.483	""	""	""	3	001003	547|ス	""						0	Available On Shelf	first_shelf	yours	2018-01-08 21:27:57 +0900	2018-01-08 21:27:57 +0900
2	はじめてのRuby on Rails 3 : 「Webアプリケーション」作りに定番の「フレームワーク」を使う!	ハジメテ ノ Ruby on Rails 3 : Web アプリケーション ズクリ ニ テイバン ノ フレームワーク オ ツカウ	清水, 美樹		工学社	2010-11	清水美樹 著	2300	2018-01-08 21:26:09 +0900	2018-01-08 21:27:23 +0900	http://iss.ndl.go.jp/books/R100000002-I000011044291-00				303p	21cm + CD-ROM1枚 12cm	volume								9784777515639		21852544		R100000002-I000011044291-00						547.483	""	""	""	2	001002	547|シ	""						0	Available On Shelf	first_shelf	yours	2018-01-08 21:26:47 +0900	2018-01-08 21:26:47 +0900
1	Ruby on Rails 5超入門	ルビー オン レイルズ ファイヴ チョウニュウモン	掌田, 津耶乃		秀和システム	2016-12	掌田津耶乃 著	2700	2018-01-08 21:24:02 +0900	2018-01-08 21:26:10 +0900	http://iss.ndl.go.jp/books/R100000002-I027769223-00				542p	24cm	volume								9784798048321		22839928		R100000002-I027769223-00						547.483	""	""	""	1	001001	547|シ	""						0	Available On Shelf	first_shelf	yours	2018-01-08 21:25:34 +0900	2018-01-08 21:25:34 +0900

1-1-3 書誌と所蔵のTSVの項目

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

項目ID 項目名 備考 閲覧権限
manifestation_id 書誌ID    
original_title 原題    
title_transcription タイトルのヨミ    
creator 著者    
contributor 協力者・編者    
publisher 出版者    
pub_date 出版日    
statement_of_responsibility 責任表示    
manifestation_price 販売価格    
manifestation_created_at 書誌情報作成日 エクスポートのみの項目  
manifestation_updated_at 書誌情報更新日 エクスポートのみの項目  
manifestation_identifier ローカル識別子    
access_address アクセスアドレス    
description 説明 ※改行は「\n」で表現されています  
note 注記 ※改行は「\n」で表現されています  
extent ページ数    
dimensions 大きさ    
carrier_type 資料種別    
edition 版(数字)    
edition_string    
volume_number 巻(数字)    
volume_number_string    
issue_number 号(数字)    
issue_number_string    
serial_number 通号    
isbn: ISBN      
subject:unknown 件名(unknown) ※入力データによっては出力されないこともあります。  
subject:ndlsh 件名(NDLSH) ※入力データによっては出力されないこともあります。
(入力データによってはほかにも subject: からはじまるものがあります)
 
classification:ndc9 分類(NDC) ※入力データによっては出力されないこともあります。
(入力データによってはほかにも classification: からはじまるものがあります)
 
item_id 所蔵データID(自動付与)    
item_identifier 所蔵情報ID    
call_number 請求記号    
item_note 注記(所蔵) ※改行は「\n」で表現されています  
item_price 購入価格   Administrator権限、Librarian権限のときのみ出力
acquired_at 受入日    
accepted_at 検収日 エクスポートのみの項目  
bookstore 書店   Administrator権限、Librarian権限のときのみ出力
budget_type 予算種別   Administrator権限、Librarian権限のときのみ出力
total_checkouts 貸出回数   Administrator権限、Librarian権限のときのみ出力
circulation_status 貸出状態    
use_restriction 利用制限   Administrator権限、Librarian権限のときのみ出力 注:1.3.0以前ではguestアカウントでも出力されます。1.3.1からは修正されています。)(参照: issue #1366
shelf 本棚    
library 図書館    
item_created_at 所蔵情報作成日 エクスポートのみの項目  
item_updated_at 所蔵情報更新日 エクスポートのみの項目  
manifestation:custom1 カスタム項目 ※設定に応じて “custom1” の部分には項目コードが入ります Administrator権限、Librarian権限のときのみ出力
item:custom1 カスタム項目 ※設定に応じて “custom1” の部分には項目コードが入ります 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 更新日時