CALISOAI-DP记录数查询接口规范.docVIP

CALIS OAI-DP记录数查询接口规范 CALIS管理中心 2006年10月 1.概述 为了便于图书馆（学位论文/特色库）本地系统管理员和CALIS子项目中心的系统管理员能够随时掌握本地系统OAI-DP的发布情况，特制定本规范。 本规范包括两个方面内容：OAI ListCount查询命令规范和OAI-DP记录数查询功能规范。 2. OAI ListCount命令规范 （1）ListCount命令请求格式 ListCount命令是对OAI的扩展，其请求响应方式与OAI-PMH的ListRecords请求响应模式一致。CALIS要求本地系统的OAI-DP需要支持ListCount命令。 ListCount命令的格式如下： 保持OAI Base URL不变，扩展verb的值，使其可以支持verb ListCount，其参数包括： （a）from：被统计的record的时间戳起始值，可选参数； （b）until：被统计的record的时间戳终止值，可选参数； （c）metadataPrefix：被统计的元数据格式，必备参数； 注：from、until的取值方式与OAI-PMH的ListRecords命令相同，为20位零时区时间，并采用闭区间取值方式，即[from, until]的方式。 例如：OAI-DP的ListCount的请求命令样例如下： OAI Base URL + “?” + “verb ListCount” + “” + “from 2006-01-16T14:12:59Z” + “” + “until 2006-01-16T14:13:00Z” + “” + “metadataPrefix CALIS_rarebook” （2）ListCount响应格式 对于本地系统OAI-DP，无论是采用CALIS Record发布模式1还是模式2（参见《CALIS OAI Record格式和发布规范》），都必须对ListCount命令予以响应。 （A）成功响应 当OAI-HP发送的ListCount请求符合上述规定的参数要求时，OAI-DP需要按照以下schema（/metadata_ns/oai/listCount.xsd）的格式要求进行响应。 以下为schema listCount.xsd的内容： ?xml version 1.0 encoding UTF-8 xs:schema targetNamespace /metadata_ns/oai/ xmlns:calis /metadata_ns/oai/ xmlns:xs /2001/XMLSchema elementFormDefault qualified xs:element name OAI-ListCount xs:complexType xs:sequence xs:element name responseDate type xs:string/ xs:element name requestURL type xs:string/ xs:element name recordCount type xs:string/ xs:element name metsCount type xs:string minOccurs 0/ xs:element name noMetsCount type xs:string minOccurs 0/ /xs:sequence xs:attribute name from type xs:string use optional/ xs:attribute name until type xs:string use optional/ xs:attribute name metadataPrefix type xs:string use required/ /xs:complexType /xs:element /xs:schema 其中，OAI-ListCount的属性from、until、metadataPrefix分别对应OAI-HP发送的三个参数值，而OAI-ListCount的子元素中： （a）responseDate表示当前响应的响应时间，必备，且必须为20位的零时区时间； （b）requestURL当前响应对应请求的Base URL，即OAI-DP的Base URL，该值必备； （c）recordCount根据统计参数（from、until、metadataPrefix）统计出来的总记录数； （d）metsCount根据统计参数统计出来的METS包个数； （e）noMetsCount根据统计参数统计出来的不含METS包的元数据条数。 以下为成功响应时的样例： ?xml version