このページでは、農林水産関係試験研究機関 総合目録(ALIS WebOPAC。以下単に「OPAC」とします。)の、XML出力用インターフェースについて解説しています。
2008年4月より、OpenSearch Descriptionファイルを公開しました。また、MARCXMLでの出力に対応しました。
2008年8月より、新着受入情報のRSSフィードについて、RESTを意識して http://www3.affrc.go.jp/rss/148.xml のようなURLで取得できるようになりました。
2009年3月にシステムを更新し、URLが一部変更(opac1.cc.affrc.go.jp から opac.cc.affrc.go.jp)になりました。また、MODSのバージョンを3.3に変更しました。
APIについては、OpenSearchのほかSRU/SRWでの検索、OAI-PMHでのハーベストにも試験的に対応しています。出力はDC, MARCXML, MODSです。
試験中のため仕様が変わることがありますので、詳細なはお問い合わせ下さい。
なお、本機能の使用等によって生じたあらゆる結果について、またいかなる不具合、不利益が生じても著者並びに農林水産省、農林水産研究情報総合センターではその責を負いません。自己責任でご利用下さい。
農林水産関係試験研究機関総合目録はOpenSearchでの検索に対応しています。
Description Fileは以下にありますので、ご利用下さい。
以下はXML返戻用の設定となっています。Firefox2.0、IE7用検索プラグインは別途ご用意しております。
以下の項目について検索を行います。ISSN、ISBNともにハイフンは削除してください。
以下のフォーマットでの出力に対応しています。
MODS(Metadata Object Description Schema)やMARCXMLの詳細については、The Library of Congressによる解説をご参照下さい。
RSS1.0で出力:BASEURL/{ISSN|ISBN|書誌ID}
MODSまたはMARCXMLで出力:BASEURL/{ISSN|ISBN|書誌ID}/{MODS|MARC}
RSS2.0+MODSまたはMARCXMLで出力:BASEURL/{ISSN|ISBN|書誌ID}/{R2MODS|R2MARC}
http://library.affrc.go.jp/api/Q20352964
http://library.affrc.go.jp/api/9784585002789
http://library.affrc.go.jp/api/9784585002789/MARC
http://library.affrc.go.jp/api/18802648/MODS
http://library.affrc.go.jp/api/18802648/MARC
http://library.affrc.go.jp/api/4541016540/R2MODS
以下の項目について検索を行います。
以下のフォーマットでの出力に対応しています。
MODS(Metadata Object Description Schema)の詳細については、The Library of Congressによる解説をご参照下さい。
また、OpenSearch Descriptionについては a9.com の解説をご参照下さい。
BASEURL/検索対象データベース/OPENSEARCHの利用/検索対象項目/検索語/出力件数/出力フォーマット
各項目は以下のように記述します。
| 項目名 | 記述例 | 説明 |
| BASEURL | http://library.affrc.go.jp/api/ | |
| 検索対象データベース | T | 省略はできません。 図書:T 雑誌:Z |
| OPENSEARCHの利用 | OPENSEARCH | OpenSearch準拠のフォーマットで出力する際に記述し、省略が可能です。出力フォーマットを指定しない場合はRSS2.0で書誌情報を出力します。要素として、表示開始位置、表示件数などが埋め込まれています。 |
| 検索対象項目 | keyword | この項目を省略するとkeywordでの検索になります。 keyword: キーワードで検索します。 TL: タイトルから検索します。 AU: 著者名から検索します。 |
| 検索語 | rice | 検索語を記述します。マルチバイト文字はUTF-8でURLエンコードしてください。 |
| 出力件数 | 10 | 出力する件数を記述します。省略された場合は20件になります。 |
| 出力フォーマット | RSS10 | この項目を省略するとRSS1.0での出力になります。 RSS10 :RSS1.0で出力します RSS20 :RSS2.0で出力します MODS :詳細な書誌事項をMODS3.1で出力します MARC :詳細な書誌事項をMARCXMLで出力します R2MODS :詳細な書誌事項をMODSで記述しRSS2.0で出力します R2MARC :詳細な書誌事項をMARCXMLで記述しRSS2.0で出力します |
http://library.affrc.go.jp/api/T/rice
http://library.affrc.go.jp/api/T/AU/18802648%e8%be%b2%e6%9e%97%e6%b0%b4%e7%94%a3%e7%9c%81/10/MODS
http://library.affrc.go.jp/api/Z/OPENSEARCH/TL/environment/100/MARC
現在のところ、結果は全てXMLのまま返されます。XSLT等を用い画面上では整形して表示できるよう準備中です。
以下のフォーマットでの出力に対応しています。
BASEURL?出力対象RSSの一連番号.xml
各項目は以下のように記述します。
| 項目名 | 記述例 | 説明 |
| BASEURL | http://www.affrc.go.jp/ja/rss/cache/ | |
| 出力対象RSSの一連番号 | 147.xml | 出力対象とするRSSのidに拡張子 .xml を入力します。詳細はRSS出力 出力対象リストをご覧下さい。 |
BASEURL?出力対象RSSの一連番号&{表示日数|出力件数}&出力フォーマット
各項目は以下のように記述します。
| 項目名 | 記述例 | 説明 |
| BASEURL | http://www3.affrc.go.jp/rss/RSS.rsssrv.cls | |
| 出力対象RSSの一連番号 | id=147 | 出力対象とするRSSのidを入力します。詳細はRSS出力 出力対象リストをご覧下さい。 |
| 表示日数 | days=7 | 過去1~7日以内に受入した資料を表示します。itemsとは同時に使用できません。 |
| 出力件数 | item=10 | 指定しない場合は10件です。最大で過去7日間に受入した資料を表示します。daysとは同時に使用できません。 |
| 出力フォーマット | context=html | xml: xmlで出力します。指定しない場合はxmlでの出力となります。 html: htmlに変換して出力します。 |
林賢紀, 宮坂和孝 / RSS(RDF Site Summary)を活用した新たな図書館サービスの展開 -OPAC2.0へ向けて-, 情報管理 Vol. 49 (2006) , No. 1 p.11-23並びに「CSV > RSS 変換サンプル Perl スクリプト」 でお約束した、「RSSにMODSによる詳細な書誌情報を載せて配信」について、RSS2.0による実装にて公開できました。
また、国立国会図書館デジタルアーカイブポータル(PORTA)とOpenSearchを使って連携し、PORTAからの検索要求に対し RSS2.0+MODS3.1 で結果を返戻しています。これをPORTA側ではDCNDL_PORTAに変換して表示しています。詳細は、同館が提供する「共通仕様及び連携に関するガイドライン」などの資料をご参照下さい。
このようなインターフェースがRESTと呼べるかどうか自信がなかったの、あえてRESTとは文中に書いていません。
RESTについては、yohei-y:weblogのREST 入門等が詳しいです。
2008年4月3日より、MARCXMLでの出力に対応しました。また、LCの実装を参考に、Permalinkを用いたISSNからの書誌データ呼び出しなどについても方法を見直してみました。
既存の検索インターフェースにこだわらずに書誌情報を提供する試みはまだまだ続きます。
このページをご覧になった皆様のご意見やご希望、またアイディアがありましたらお気軽に農林水産研究情報総合センターまでお寄せ下さい。
農林水産省 農林水産研究情報総合センター
〒305-8601 茨城県つくば市観音台2-1-9
TEL: 029-838-7283 FAX: 029-838-7364 email: ric@affrc.go.jp