臺中學資料庫 OAI-PMH 服務

更新日期:2017/10/12

OAI-PMH 服務讓您可以用 Open Archives Initiative Protocol for Metadata Harvesting (OAI-PMH v2.0) 的方式蒐集後設資料。 以下是 OAI-PMH 的簡要說明,臺中學資料庫使用的後設資料架構,以 Dublin Core 為基礎 產出的後設資料集合。以下詳述 OAI-PMH 的資料存取欄位對應和規則。

一、存取說明

臺中學資料庫的 OAI-PMH 存取點為 http://data.digitalculture.tw/taichung/oai ,目前為 Beta 測試版本,僅支援 oai_dc 的 Metadata Prefix。直接點入存取點僅會得到一個 xml 文件,並得到以下錯誤訊息。

 <error code="badVerb">The request method GET is unknown.</error>

因為 OAI-PMH 需要有一定的參數才可以存取內容,上述錯誤即表示缺少了必要的參數 Verb,以下則簡介語法說明。

二、OAI-PMH 語法簡介

任何 OAI-PMH 的必要參數為 verb、metadataPrefix。本站的 metadataPrefix 固定設定為 oai_dc,verb 則依照 OAI-PMH 2.0 規格 ,支援了以下幾種方式。

  1. ListMetadataFormats (列出支援的 Metadata)
  2. ListIdentifiers (列出ID)
  3. ListSets (列出本站支援的子集合,目前僅支援單一集合)
  4. ListRecords (列出紀錄)
  5. GetRecord (取得單一紀錄)

另一部份,OAI-PMH 亦支援一些額外的參數以篩選藏品結果。

存取下一頁的結果

  1. 每頁僅會顯示最近更新的 50 筆資料,只要篩選的清單大於50筆,即會出現 resumptionToken 的參數,以供取得下一頁的結果,造訪任何清單頁面,例如 ?verb=ListRecords&metadataPrefix=oai_dc ,第一頁即可看到 resumptionToken,其中可看
    到總共的數量(99筆),超過 50 筆,其中的值出現一個 token 供取用,且屬性標示了起始比數為第1筆(cursor=0)。
    <resumptionToken completeListSize="99" cursor="0" expirationDate="2017-10-13T01:24:44Z">e0e785b72dd28a7c3c9d32e3e0bea9b0</resumptionToken>
    
  2. 要取得下一頁面,必須改變參數為僅剩下 verb + resumptionToken,以上面的紀錄為例,應該要存取以下網址
    ?verb=ListRecords&&resumptionToken=e0e785b72dd28a7c3c9d32e3e0bea9b0
    
  3. 因為總共只有99筆,並未超過100筆,因此第二頁的 resumptionToken 便沒有值,且起始標記會變成第51筆(cursor=50)。
    <resumptionToken completeListSize="99" cursor="50"/>
    

三、Dublin Core 與臺中學資料庫的欄位對應

有關臺中學資料庫詳細的欄位架構,可參考進一步說明。以下僅列出 oai_dc 格式支援的資料庫欄位對應。

DC格式 欄位名稱
dc:title 藏品名稱 Name
dc:creator 藏品作者 Creator
dc:subject 藏品主題 Subject
dc:description 藏品描述 Description
dc:description 藏品物件(固定為最後一個 dc:description)
dc:publisher 出版者 Publisher
dc:contributor 貢獻者 Contributor
dc:date 日期 Date
dc:type 類型 Type
dc:format 格式 Format
dc:identifier 藏品ID Identifier
dc:language 語言 Language
dc:coverage 地點 Place
dc:relation 相關資源 Relation
dc:rights 授權 Rights

以下是實際上用 verb=getRecord 取得的一個範例資料

<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>2017-08-30T06:09:17Z</responseDate>
  <request verb="GetRecord">http://data.digitalculture.tw/taichung/oai</request>
  <GetRecord>
    <record>
      <header>
        <identifier>oai:taichung.digitalculture.tw:85</identifier>
        <datestamp>2017-08-01T05:05:56Z</datestamp>
      </header>
      <metadata>
        <oai_dc:dc xmlns:oai_dc="http://www.openarchives.org/OAI/2.0/oai_dc/" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/oai_dc/ http://www.openarchives.org/OAI/2.0/oai_dc.xsd">
          <dc:title xmlns:dc="http://purl.org/dc/elements/1.1/">OOOO修復工程紀錄片</dc:title>
          <dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">王小明</dc:creator>
          <dc:subject xmlns:dc="http://purl.org/dc/elements/1.1/">大肚王國與外來政權</dc:subject>
          <dc:subject xmlns:dc="http://purl.org/dc/elements/1.1/">大肚王國與外來政權的藝術</dc:subject>
          <dc:description xmlns:dc="http://purl.org/dc/elements/1.1/">
詳細說明文字,詳細說明文字,詳細說明文字,詳細說明文字,詳細說明文字,詳細說明文字,詳細說明文字,詳細說明文字,詳細說明文字,詳細說明文字,詳細說明文字,詳細說明文字。
          </dc:description>
          <dc:description xmlns:dc="http://purl.org/dc/elements/1.1/">http://data.digitalculture.tw/taichung/sites/default/files/object/photo/111.jpg</dc:description>
          <dc:publisher xmlns:dc="http://purl.org/dc/elements/1.1/">臺中市政府文化局</dc:publisher>
          <dc:contributor xmlns:dc="http://purl.org/dc/elements/1.1/">臺中市文化資產處</dc:contributor>
          <dc:date xmlns:dc="http://purl.org/dc/elements/1.1/">2014-01-08T00:00:00</dc:date>
          <dc:type xmlns:dc="http://purl.org/dc/elements/1.1/">Image</dc:type>
          <dc:format xmlns:dc="http://purl.org/dc/elements/1.1/">image/jpg</dc:format>
          <dc:identifier xmlns:dc="http://purl.org/dc/elements/1.1/">http://data.digitalculture.tw/taichung/aggregation/85</dc:identifier>
          <dc:language xmlns:dc="http://purl.org/dc/elements/1.1/">中文</dc:language>
          <dc:relation xmlns:dc="http://purl.org/dc/elements/1.1/">OOO關聯資源</dc:relation>
          <dc:coverage xmlns:dc="http://purl.org/dc/elements/1.1/">洪爐地</dc:coverage>
          <dc:rights xmlns:dc="http://purl.org/dc/elements/1.1/">臺中自由文化授權條款1.0版</dc:rights>
        </oai_dc:dc>
      </metadata>
    </record>
  </GetRecord>
</OAI-PMH>