Main page > SRU

SRU

The argument with which 2 is supported

The following query is being supported with a main system. (About the query by which abbreviation is possible, [,], the price of the default is indicated on inside.).

operation
Indispensable. " searchRetrieve" it's being drunk and supported.
version
The version of SRU is designated. 1.1 or 1.2 is being supported. There is difference in how to give it the sorting condition of the search result by version 1.1 and 1.2. [1.2]
query
Indispensable. A search query by the CQL form is described. It's mentioned later for details.
startRecord
The starting order of the search result can be designated at the reach of 1-1000. [1]
maximumRecords
The number of the returned search result record can be designated at the reach of 1-200. [200]
recordPacking
When you'd like to receive "xml" as the character string which cut <,>,& etc. when I'd like to receive each record included in a search result in XML of a plastic surgery way, please designate "string". [string]
recordSchema
The metadata schema in which a returned search result record is written can be chosen. Designate "dc" as output by the Simple DC form and please designate "ndlkn" as output by the NDL great earthquake archive original form respectively. [dc]
sortKeys
The sorting condition of the search result can be designated. Only when designating 1.1 in version, it becomes practicable.
path
The attribute of the material used for sorting can be designated. " score" (the degree of adaptation to the search query)," title" (the title of the material)," creator" (author and photographer)" please designate one from one of publisher" (publication person and opening to the public person) and "date" (photo date and opening to the public day). [score]
ascending
It can be chosen whether it's output by an ascending order whether a sorting result is output by descending order. " When designating descending order and "1" when designating 0", it's output by an ascending order. But, when designating "score" in path, it's possible to designate only 0. [0]

The CQL item as which 3 can be designated

title
The title.
creator
An author and a photographer.
publisher
A publication person and an opening to the public person.
subject
Subject and classification
place
Place.
from
The starting date when doing a narrow search by a date, (YYYY - MM - DD).
until
With an end date when doing a narrow search by a date, (YYYY - MM - DD).
anywhere
It's equal to a simple search.
identifier
Identifier.
mediatype
Material designation.
dpid
Search target data base. Please designate it by the repository ID.
language
Language. Please designate it by ISO639-2 form.
openAccess
" When designating it, "it's possible" to do web reading of 1", only data is returned.
sortBy
The attribute of the material used for sorting can be designated. " score" (the degree of adaptation to the search query)," title" (the title of the material)," creator" (author and photographer)" please designate one from one of publisher" (publication person and opening to the public person) and "date" (photo date and opening to the public day). Please write/sort.ascending and/sort.descending in ascending order descending order behind the attribute name respectively.

The condition that it can be designated as each 3.1 CQL item

Referring a name The parallel condition (^,exact) The logic condition (all,any,=) More than one value specification
title
creator
publisher
place
subject
from X = chisel
from X = chisel
anywhere x (Partial agreement)
identifier x (Perfect matching) = chisel X
mediatype x (Perfect matching) = chisel
dpid x (Perfect matching) = chisel
language x (Perfect matching) = chisel
openAccess x (Perfect matching) = chisel
sortBy - - -
  

 

4 data return form

version
The version of SRU. " The price designated at the time of among the 1.1" or the "1.2" and a request is returned.
numberOfRecords
The search result general number.
records
Search result record list
record
Search result record.
recordSchema
XML schema of a record.
recordPacking
" The price designated at the time of among the xml" or the "string" and a request is returned.
recordData
Bibliographic information of a record.
recordPosition
The order in the search result of the record.
nextRecordPosition
The starting order of the next record. When making it example : startRecord=1, maximumRecords=200, when there are more than 201 search results, it's returned as nextRecordPosition=201.
deagnostics
Error message list
extraResponseData
The additional information which are fa sets

5 request example and the return

I'll make the title output 2 new marks including "library" and "Sendai" by an ascending order of the title as an example of a request to SRU.

CQL which expresses "output by an ascending order of the title of the record which includes "library" and "Sendai" in the title"?

title= library and title= Sendai sortBy title/sort.ascending

It'll be. Following Uniform Resource Locator which did Uniform Resource Locator encoding of CQL above-mentioned and designated "2" as the price of maximumRecords

http://kn.ndl.go.jp/api/sru?operation=searchRetrieve&version=1.2&startRecord=1&maximumRecords=2&recordPacking=xml&recordSchema=ndlkn&query=title%3D%E5%9B%B3%E6%9B%B8%E9%A4%A8+and+title%3D%E4%BB%99%E5%8F%B0+sortBy+title%2Fsort.ascending

When I do NI access, it's possible to get a record of a goal.

 

About NDL the Great East Japan Earthquake Archive

Latest News



Copyright © 2013- National Diet Library. All Rights Reserved.