農林水産関係試験研究機関総合目録 OpenSearch対応とXML出力インターフェース

　このページについて
このページでは、農林水産関係試験研究機関総合目録（ALIS WebOPAC。以下単に「OPAC」とします。）の、XML出力用インターフェースについて解説しています。
  • 2014年8月より、OAI-PMHによる 国立国会図書館サーチ との連携を開始しました。
  • 2013年3月にシステムを更新し、以下が変更となりました。
    • 図書及び雑誌を同時に検索できるようになりました。
    • 書誌IDのプレフィクスが2文字になりました。図書はQQ、雑誌はZZです。
    • MODSでの出力を休止しました。
    • OpenSearch Description FileなどのファイルのURLが変更になりました。
    • RSSについて、機関毎の出力について休止しています。再開時期は未定です。
    • OAI-PMHでの書誌情報出力に対応しました。大量の出力の場合にタイムアウトすることがあり、調整を行っております。
    • XMLでの出力について、 DC_NDL（RDF） 、RDF（CiNii Books準拠スキーマ）、 JuNii2 （Ver1.0）での出力に対応しました。
    • JSONでの出力について対応しました。出力内容については調整中です。
  • 2011年12月より、図書、雑誌の新着情報の出力のURL変更、出力フォーマットの追加を行いました。
  • 2010年8月より、国立国会図書館サーチ(開発版)からも検索できるようになりました 。OpenSearchを使用しています。
  • 2009年3月にシステムを更新し、URLが一部変更(opac1.cc.affrc.go.jp から opac.cc.affrc.go.jp)になりました。また、MODSのバージョンを3.3に変更しました。
  • 2008年8月より、新着受入情報のRSSフィードについて、RESTを意識して http://www3.affrc.go.jp/rss/148.xml のようなURLで取得できるようになりました。
  • 2008年4月より、OpenSearch Descriptionファイルを公開しました。また、MARCXMLでの出力に対応しました。
なお、本機能の使用等によって生じたあらゆる結果について、またいかなる不具合、不利益が生じても農林水産省、農林水産研究情報総合センターではその責を負いません。
自己責任でご利用下さい。

 

　OpenSearch Description File
農林水産関係試験研究機関総合目録はOpenSearchでの検索に対応しています。
Description Fileは以下にありますので、ご利用下さい。

クエリパラメータの詳細はALIS WebOPAC OpenSearch クエリパラメータとレスポンス仕様をご参照下さい。

以下はXML返戻用の設定となっています。

 

　ISSN,ISBN等のコードによる検索 利用方法
検索対象項目
以下の項目について検索を行います。ISSN、ISBNともにハイフンは削除してください。
  • ISBN
  • ISSN
  • ALIS書誌ID
  • NACSIS書誌ID
  • 著者名典拠ID（ローカルIDのみ。NACSIS著者名典拠IDには未対応です）

出力フォーマット
以下のフォーマットでの出力に対応しています。RDF、MARCXML、JSONの各出力では、所蔵館も併せて出力されます。

ISSN、ISBN、書誌ID検索と記述方法
  • 基本的な記述は以下の通りです。
  • ISSN、ISBNはBASEURLの後に続けて記述します。出力フォーマットを指定しない場合は、ALIS WebOPACで検索が行われます。
  • 出力フォーマットは、/ （スラッシュ）の後に続けるか、.rdf のように拡張子として指定できます。
    https://library.affrc.go.jp/api/{ISSN|ISBN|書誌ID|NCID|典拠ID}/{marc|json|rss|atom|rmarc|rdf|dcndl|junii2}
    https://library.affrc.go.jp/api/{ISSN|ISBN|書誌ID|NCID|典拠ID}.{marc|json|rss|atom|rmarc|rdf|dcndl|junii2}

記述例
  1. 書誌IDで検索する場合[ 実際に表示する ]
    https://library.affrc.go.jp/api/QQ20352964
  2. NACSIS書誌IDで検索する場合[ 実際に表示する ]
    https://library.affrc.go.jp/api/BA91833159
  3. ISBNで検索、RSS1.0で出力する場合 [ 実際に表示する ]
    https://library.affrc.go.jp/api/9784585002789/rss
    https://library.affrc.go.jp/api/9784585002789.rss
  4. ISBNで検索、MARCXMLで出力する場合 [ 実際に表示する ]
    https://library.affrc.go.jp/api/9784585002789/marc
    https://library.affrc.go.jp/api/9784585002789.marc
  5. ISSNで検索、DC-NDLで出力を行う場合 [ 実際に表示する ]
    https://library.affrc.go.jp/api/03854000/dcndl
    https://library.affrc.go.jp/api/03854000.dcndl
  6. ISSNで検索、CiNii Books RDF準拠の出力を行う場合 [ 実際に表示する ]
    https://library.affrc.go.jp/api/03854000/rdf
    https://library.affrc.go.jp/api/03854000.rdf
  7. 書誌IDで検索、JSONで出力する場合 [ 実際に表示する ]
    https://library.affrc.go.jp/api/QQ20352964/json
    https://library.affrc.go.jp/api/QQ20352964.json

 

　キーワード検索 利用方法
検索対象項目
以下の項目について検索を行います。
  • キーワード
  • タイトル
  • 著者

出力フォーマット
以下のフォーマットでの出力に対応しています。RDF、MARCXML、JSONの各出力では、所蔵館も併せて出力されます。

検索語(キーワード、タイトル、著者名)による検索と記述方法
  • 基本的な記述は以下の通りです。
    >https://library.affrc.go.jp/api/検索対象データベース/OPENSEARCHの利用/検索対象項目/検索語/出力件数/出力フォーマット
  • 各項目は以下のように記述します。
      項目名   記述例   説明
      BASEURL   http://library.affrc.go.jp/api/  
      検索対象データベース   T   > T （図書）または Z （雑誌）を指定します。省略した場合は、両方を検索します。
      OPENSEARCHの利用   OPENSEARCH   OpenSearch準拠のフォーマットで出力する際に記述し、省略が可能です。出力フォーマットを指定しない場合はRSS1.0でで書誌情報を出力します。要素として、表示開始位置、表示件数などが埋め込まれています。
    省略した場合は、WebOPACで検索を行いHTMLで結果を出力します。
      検索対象項目   keyword   この項目を省略するとkeyword（タイトル、著者名、出版者、件名）から検索します。
    keyword: キーワードで検索します。
    TL: タイトルから検索します。
    AU: 著者名から検索します。
      検索語   rice   検索語を記述します。この項目は必須です。マルチバイト文字はUTF-8でURLエンコードしてください。
      出力件数   10   出力する件数を記述します。10, 20, 50, 100が指定できます。
      出力フォーマット   RSS  
    RSS :RSS1.0で出力します
    ATOM :ATOMで出力します
    MARC :詳細な書誌事項と所蔵館をMARCXMLで出力します
    RDF :詳細な書誌事項と所蔵館をCiNii Books準拠のスキーマで出力します
    RMARC :詳細な書誌事項をMARCXMLで記述しRSS1.0で出力します
    DCNDL :詳細な書誌事項をDCNDLで出力します
    JuNii2 :詳細な書誌事項をJuNii2バージョン1で出力します
    JSON :詳細な書誌事項と所蔵館をCiNii Books準拠のスキーマかつJSONで出力します

記述例
検索対象データベース、OPENSEARCHの有無、検索対象項目を省略する場合は、/ のみ省略せずに記述して下さい。
  1. 図書データベースから「rice」をキーワードで検索、RSS1.0で出力 [ 実際に表示する ]
    https://library.affrc.go.jp/api/T///rice/10/RSS
  2. 図書データベースから著者名「農林水産技術会議事務局」で検索、10件の結果をMARCで出力する [ 実際に表示する ]
    https://library.affrc.go.jp/api/T//AU/農林水産技術会議事務局/10/MARC
  3. 雑誌データベースからOpenSearch準拠でタイトル「environment」で検索、50件の結果をDCNDLで出力する [ 実際に表示する ]
    https://library.affrc.go.jp/api/Z/OPENSEARCH/TL/environment/50/DCNDL

 

　図書、雑誌の新着情報の出力 利用方法
  • 図書、雑誌の新着情報の出力については、現在は全機関を対象としたHTMLまたはRSS1.0での出力のみ対応しています。
  • 農林水産関係試験研究機関総合目録の「 新着案内 」から利用できます。

 

　OAI-PMHでの書誌情報のハーベスト
出力フォーマット
以下のフォーマットでの出力に対応しています。metadataPrefixで指定して下さい。
  • oai_dc
  • junii2
  • marc21
  • dcndl
  • rdf

BASEURLなど
  • BASEURLは以下の通りです。OAI-PMH2.0に準拠したリクエストに応答します。
  • この出力機能は調整中です。出力中にタイムアウトするなどの不具合を確認しています。
    https://app.cc.affrc.go.jp/oai/oai-pmh.do
  • https://app.cc.affrc.go.jp/oai/oai-pmh.do?verb=Identifyの結果を以下に示します。 
    <OAI-PMH xmlns="http://www.openarchives.org/OAI/2.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/ http://www.openarchives.org/OAI/2.0/OAI-PMH.xsd">
<responseDate>2013-08-28T04:42:10Z</responseDate>
<request>https://app.cc.affrc.go.jp/oai/oai-pmh.do</request>
<Identify>
<repositoryName>
Union Catalog of the Agriculture, Forestry and Fisheries Research Insititutes.(ALIS WebOPAC:Books)
</repositoryName>
<baseURL>https://app.cc.affrc.go.jp/oai/oai-pmh.do</baseURL>
<protocolVersion>2.0</protocolVersion>
<adminEmail>ric@ml.affrc.go.jp</adminEmail>
<earliestDatestamp>1969-04-01</earliestDatestamp>
<deletedRecord>transient</deletedRecord>
<granularity>YYYY-MM-DD</granularity>
<compression>gzip</compression>
<description>
<oai-identifier xmlns="http://www.openarchives.org/OAI/2.0/oai-identifier"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/oai-identifier 
 http://www.openarchives.org/OAI/2.0/oai-identifier.xsd">
<scheme>oai</scheme>
<repositoryIdentifier>affrc.go.jp</repositoryIdentifier>
<delimiter>:</delimiter>
<sampleIdentifier>oai:affrc.go.jp:ALIS-QQ00000000</sampleIdentifier>
</oai-identifier>
</description>
</Identify>
</OAI-PMH>