DB34 T 2837-2017 公共图书馆 总分馆 数据接口规范.pdf

《DB34 T 2837-2017 公共图书馆 总分馆 数据接口规范.pdf》由会员分享，可在线阅读，更多相关《DB34 T 2837-2017 公共图书馆 总分馆 数据接口规范.pdf（40页珍藏版）》请在麦多课文档分享上搜索。

1、ICS 35.100 L 79 DB34 安徽省地方标准 DB 34/T 28372017 公共图书馆 总分馆 数据接口规范 The public library - central branch libraries Data interface specification 2017 - 03 - 30 发布 2017 - 04 - 30 实施 安徽省质量技术监督局 发布 DB34/T 28372017 I 目 次 前言 . . II 1 范围 . . 1 2 规范性引 用文件 . . 1 3 术语和定义 . . 1 4 数据元素 的描述格式 . . 3 5 数据与接口 . . 3 5.1 认

2、证 . . 4 5.2 成员馆 注册与注销 . . 4 5.3 总分馆 资源数据 . . 6 5.4 总分馆 馆藏数据 . . 14 5.5 总分馆 流通统计 . . 15 5.6 总分馆 流通操作 . . 19 5.7 总分馆 用户操作 . . 22 附录 A（规范性附录） 数据字典 . 28 参考文献 . . 36 DB34/T 28372017 II 前 言 本标准按照 GB/T 1.1-2009 给出的规则起草。 本标准由安徽省图书馆提出。 本标准由安徽省信息技术标准化技术委员会归口。 本标准起草单位：安徽省图书馆、安徽省智慧公共文化服务工程技术研究中心、安徽省质量和标准 化研究院、安

3、徽华博胜讯信息科技股份有限公司、合肥市图书馆、合肥工业大学、安徽大学。 本标准主要起草人：胡敏、王学杰、许俊松、步翠兰、刘树峰、王建涛、李永钢、智淑英、吴锦、 郑利平、林泽明、汪佂。 DB34/T 28372017 1 公共图书馆 总分馆 数据接口规范 1 范围 本标准规定了图书馆业务信息化系统之间的数据接口规范。 本标准适用于公共图书馆、高校图书馆和数字资源提供商，也可适用于图书馆行业信息资源交换体 系的设计与建设。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文

4、件。 GB/T 2260 中华人民共和国行政区划代码 GB/T 2659 世界各国和地区名称代码 GB/T 3304 中国各民族名称的罗马字母拼写法和代码 GB/T 4658 学历代码 GB/T 7408 数据元和交换格式 信息交换 日期和时间表示法 GB/T 10114 县级以下行政区划代码编制规则 GB 11643 公民身份号码 GA/T 2000.156 公安信息代码 第156部分:常用证件代码 中国图书馆分类法第五版 3 术语和定义 下列术语和定义适用于本文件。 3.1 公共图书馆联盟 public libra ry consortium 县、区及其以上级公共图书馆形成的联盟。 3.2

5、 成员馆 member library 注册成为图书馆联盟正式成员的图书馆。 3.3 总分馆 central-br anch library 在一个总馆下设立若干分馆,实行一元化垂直管理体系和网状结构模式。 DB34/T 28372017 2 3.4 机器可读目录 machine readable catalog，MARC 以代码形式和特定结构记录在计算机存储载体上的、可供计算机识别与阅读的目录。 3.5 本体数据 ontolo gy data 由 MARC 描述的目标数据。 3.6 发现级别 expose level 阅读资源在文献编目级别的对外暴露程度。 3.7 可用级别 availa b

6、le level 最终读者或软件获得本体数据的能力程度。 3.8 收割 harvest 根据发现级别，联盟或成员馆以下载的形式获得其他成员馆文献编目的过程。 3.9 揭示 reveal 将 MARC 数据以可视化的形式向用户呈现、表示的过程。 3.10 馆藏 reserves 图书馆收集的各种类型文献资料的总和。 3.11 流通 circulation 图书或其他资源进出图书馆的过程。 3.12 数据元素 data e lement 用一组属性描述定义、标识、表示和允许值的数据单元，它是图书馆业务自动化系统间数据接口所 输入和输出数据的不可分割的基本单位。 DB34/T 28372017 3

7、3.13 活动 activity 活动是对图书馆举办的线上和线下聚会的泛称。 4 数据元素的描述格式 数据元素的描述格式如下： a) 标识符：数据元素的内部唯一标识，由字母与数字组合形成； b) 名称：数据元素的中文名称； c) 说明：数据元素内容的描述与解释； d) 表示格式：数据元素值的类型及长度的表示形式，具体形式见表 1； e) 备注：与该数据元素相关的其他说明，包括数据元素的取值范围、遵循的标准规范要求等。 表1 数据元素的表示格式 字符 含义 说明 C 表示数据类型为字符型 用 C 后直接加自然数的方式表示定长， 如 C4 表示 4 个字符定 长（一个汉字相当于两个 Byte）。

8、N 表示数据类型为数值型 N 后直接加自然数的方式表示定长，N3 表示 3 位数字定长。 D 表示数据类型为日期型和日期时间型 用 D 后加 4、 6、 8 等， 分别表示不同数据格式的日期型数据元。 D4 表示 YYYY 即只表示到年份； D6 表示 YYYY-MM 即表示到月份； D8 表示 YYYY-MM-DD 即表示到日。 遵循 GB/T 7408 数据和交换格式信息交换日期和时间表示法。 T 表示数据类型为时间型 用 T 后加 2、4、6 分别表示不同数据格式的时间型数据元。 T2 表示 hh 即只表示小时； T4 表示 hh:mm 即表示到分钟； T6 表示 hh:mm:ss 即表

9、示到秒。 注意，本部分为 24 小时制。 DnTm 表示日期时间型 n 代表 4、6、8，m 代表 2、4、6。 例如 D8T6,表示 YYYY-MM-DD hh:mm:ss BL 表示数据类型为布尔型 BN 表示数据类型为二进制型 在数据格式中应标识出二进制的具体格式，如“JPEG”。 N.M N 表示字段的最小长度，M 表示字段 最大长度（N 可以省去，表示可以是 空串，M 不可省去） 如 C.6 表示最多 6 个字符； N2.7 表示最少 2 位数字最多 7 位数字 N.p,q (p、q 均代表一个 自然数) 表示数据类型为数值型，最长 p 位， 小数点后 q 位 （小数点前为 p-q

10、位） 如 N.8,2 表示最多 8 位数字，小数点后 2 位 注： 在系统建设中遇到数据格式为“.”时建议按最大值使用 5 数据与接口 DB34/T 28372017 4 5.1 认证 定义：String authe nticate(String jsonStr); 描述：成员馆登录认证。 参数说明：遵循 JSON 格式串要求，数据元素描述见表2。 表2 认证接口参数表 标识符 名称 说明 表示格式 备注 loginname 用户名 用户凭证 C.30 在成员馆中此凭证需要满足唯一 性要求 password 口令 SHA 处理过的口令 串。 C.60 通讯端保证用户口令经过 SHA 512 处

11、理。 参数 jsonStr 示例： loginname: uname, password: pwd 返回值说明：遵循 JSON 格式串要求，数据元素描述见表3。 表3 认证接口返回值表 标识符 名称 说明 表示格式 备注 state 执行状态 指示功能的执行状态 N1 取值范围见附录A.5 statedesc 状态描述 执行结果的详细描述 C.100 返回值示例： state:0, statedesc:执行成功 5.2 成员馆注册与注销 5.2.1 注册 定义：String enroll( String jsonStr); 描述：成员馆注册。 参数说明：遵循 JSON 格式串要求，数据元素描述

12、见表4。 表4 成员馆基本信息表 标识符 名称 说明 表示格式 备注 librarycode 成员馆编码 成员馆唯一标识符 C.20 参见附录A.19 libraryname 成员馆名称 成员馆中文名称 C.100 图书馆对外公示的名称 loginname 用户名 用户凭证 C.30 在成员馆中此凭证满足唯一性要求 DB34/T 28372017 5 表4（续） 标识符 名称 说明 表示格式 备注 password 口令 SHA 处理过的口令串 C.60 用户口令经过 SHA512 处理 libraryaddr 成员馆地址 通讯地址 C.100 librarycity 所在城市 城市全称 C.

13、50 libraryprovince 所在省份 省份全称 C.100 enrolldate 注册日期 注册发生日 D8 非生效日 unenrolldate 注销日期 注销发生日 D8 注销当日即为生效日 参数 jsonStr 示例： librarycode: 成员馆编码, libraryname: 成员馆名称, loginname: 登录名, password: 口令, libraryaddr”: 成员馆地址, librarycity: 所在城市, libraryprovince: 所在省份, enrolldate: 注册日期, unenrolldate: 注销日期 返回值说明：参见 5.1

14、认证接口的返回值说明。 返回值示例：参见 5.1 认证接口的返回值示例。 5.2.2 注销 定义：String une nroll(String jsonStr); 描述：成员馆注销，注销后即表示退出联盟，不再享有联盟所提供的各项功能及服务。 参数说明：遵循 JSON 格式串要求，数据元素描述见表5。 表5 注销接口参数表 标识符 名称 说明 表示格式 备注 loginname 用户名 用户凭证 C.30 在成员馆中此凭证需要满足 唯一性要求 password 口令 SHA 处理过的口令串。 C.60 通讯端保证用户口令经过 SHA 512 处理。 librarycode 成员馆编码 要注销的

15、成员馆编码 C.20 参见附录A.19 参数 jsonStr 示例： loginname: uname, password: pwd, librarycode: 成员馆编码 DB34/T 28372017 6 返回值说明：参见 5.1 认证接口的返回值说明。 返回值示例：参见 5.1 认证接口的返回值示例。 5.3 总分馆资源数据 5.3.1 资源接口数据 资源接口数据包括 CNMARC 描述的资源和数字资源厂商系统描述的元数据资源，具体描述见表6。 表6 资源接口数据描述表 标识符 名称 说明 表示格式 备注 rdid 资源描述 ID 记录外部资源的标识符，与成 员馆、收割来源一起组成组合

16、唯一索引 C.30 分馆各自系统的控制号 librarycode 成员馆编码 成员馆唯一标识符 C.20 参见附录A.19 catalogcode 文献编目代码 自动化系统为书目条目生成 的唯一标识符 C.50 seriesname 丛书名 丛书名 C.100 可选 title 题名 书名、杂志名等 C.100 若是 MARC 书目，则取 F200a 字段的值 isocode isbn 或 issn 号 图书国际统一编码 C.100 若是 MARC 书目，则取 F010a 字段的值 publisher 出版社 C.150 若是 MARC 书目，则取 F210c 字段的值 publishdate

17、 出版日期 D4 若是 MARC 书目，则取 F210d 字段的值 author 著者 作者，书的或者文章的作者 C.300 若是 MARC 书目，则取 F200f 字段的值 authormodifier 著者类型 书的作者，杂志的编者等 C.20 取值范围见附录A.12 abstract 摘要 内容提要 C.200 对于杂志来说，提供杂志目 录； 对于书籍则提供内容提要 topic 主题词 主题词,关键字，可以是句子； 均以逗号隔开 C.200 coverpicture 封面图片 一个引用地址，不保存封面数 据本身 C.100 可选，接口实现者若提供本值 须为有效 URL 地址。 publi

18、shingperiod 出版周期 期刊，杂志的出版周期 N.4 可选，对于报刊、杂志须提供 本值,单位是天； 对于非期刊，该值设置为 0 reservescopier 藏量 成员馆中总藏量 N.2 对于纸本，按照实际馆藏数量 赋值，多卷数或纸本资源，此 值为 0，具体值写入表 13， 对于数字资源，取值为 1 DB34/T 28372017 7 表6（续） 标识符 名称 说明 表示格式 备注 harvestsource 收割来源 标识本条资源收割自哪个数 字资源厂商或成员馆 C.100 可以是厂商网址信息； 也可以是成员馆标识符或厂 商的标识，如 superstar（超 星），bookan（博

19、看）等，可 由收割接口实现提供者自行 定义 sourceurl 源URL 资源链接 C.512 如果发现级别为 2，本链可用 于获得源文献目录所描述的 明细信息； 如果使用级别为 2，本链将可 用于直接下载本体数据。 origindate 收割来源的书目数 据创建（变更）日 期 自动化系统中，编目阶段对图 书进行书目编目时所创建（变 更）的书目数据的当天日期。 D8 harvestdate 收割日期 收割到检索库或索引库的日 期 D8 exposelevel 发现级别 N1 取值范围见附录A.1 availablelevel 使用级别 N1 取值范围： 1 代表内部完全可用， 2 代表对外完全

20、可用 searchtype 数据检索类型 N1 取值范围见附录A.3 mediatype 媒体类型 N1 取值范围见附录A.6 fileformat 资源格式 pdf,html,txt, avi,mp4,wmv 等等；标示资源类型 C.50 arttype 艺术类型 书籍、 期刊、 学位论文 （学位） 、 电影、电视剧、综艺、动漫、 直播、新闻、娱乐、体育、游 戏、短视频 C.50 例如：动漫、新闻、电影等等 location 地域 大陆、香港、美国等 C.50 remark 备注 若资源本体不可以获得，则在 此提供 咨询信息等等 C.500 altfield0 备用 Api 实现者，可根据情

21、况使用 本字段传递额外信息 C.4000 数据形式，采用 json 数组形 式。 altfield1 备用 Api 实现者，可根据情况使用 本字段传递额外信息 C.4000 数据形式，采用 json 对象形 式。 5.3.2 活动接口数据 活动资源数据描述见表7。 DB34/T 28372017 8 表7 活动资源数据描述表 标识符 名称 说明 表示格式 备注 id 活动标识 内部标识 N16 code 活动编码 各馆系统内的活动标识 C.30 title 活动名称 C.100 abstracts 活动简介 摘要 C.300 types 活动类型 例如培训、讲座、电影播放、创客活 动等 C.4

22、0 keywords 活动关键字 采纳馆方系统中对等的数据，是指活 动所涉及主题的分类词，例如饮食、 茶道、解读、人物、教育、少儿等等， 允许有多个关键字，以逗号隔开。 C.40 馆方可自行定义 url 宣传地址 宣传图片或视频的地址 C.80 address 活动举办地 邮政的地址 C.100 startdate 活动举办日 D8 continuenum 活动持续日 天为单位，可以是小数，如 0.5 代 表半天 N2 enddate 活动结束日 D8 periodnum 活动周期性 0 代表 1 次，其余数字代表周期， 例如 7 代表每隔 7 天进行一次 N2 status 活动状态 如期举

23、行；提前取消 N1 如期举行为 1， 提前取消为 2 librarycode 活动所属单位 指各级图书馆，包括乡镇文化站等 C.20 参见附录A.19 portable 活动流动性 固定场所，巡演如下乡活动等等 C.40 1 为固定场所， 2 为巡演。 contactman 活动联系人 接口人 C.40 contactphone 活动联系人电话 C.20 sponsor 活动主办方 C.40 sponsorphone 主办方联系电话 C.20 organizer 活动承办方 C.40 organizerphone 承办方联系电话 C.20 partingnum 参加人数 N6 partednu

24、m 实际参加人数 N6 commentsnum 评论量 N10 altfield0 备用 Api 实现者，可根据情况使用本字段 传递额外信息 C.4000 数据形式，采用 json 数组形式。 altfield1 备用 Api 实现者，可根据情况使用本字段 传递额外信息 C.4000 数据形式，采用 json 对象形式。 5.3.3 收割活动接口 定义：String harve stActivityMetaDesc(String jsonStr)； DB34/T 28372017 9 描述：获取成员馆待活动元数据信息，提供本接口功能的系统需要自行查重处理。 参数说明：遵循 JSON 格式串要求

25、，数据元素描述见表8。 表8 收割活动接口参数表 标识符 名称 说明 表示格式 备注 fromdate 开始日期 收割开始日期 D8 pagenum 页号 N.9 默认值为 1 pagesize 页尺寸 N.9 默认值为 20 参数 jsonStr 示例： fromdate:2011-02-17, pagenum:1, pagesize:20 返回值说明：遵循 JSON 格式串要求，数据元素描述参见表7。 返回值示例： state:0, statedesc:执行成功, list: id:活动标识, code:活动编码, title:活动标题, abstracts:活动简介, types:活动类

26、型, keywords:活动关键字, url:宣传地址, address:活动举办地, startdate:活动举办日, continuenum:活动持续日, enddate:活动结束日, periodnum:7, status:1, librarycode:活动所属单位, portable:活动流动性, contactman:活动联系人, contactphone:活动联系人电话, sponsor:活动主办方, sponsorphone:主办方联系电话, organizer:活动承办方, organizerphone:承办方联系电话, DB34/T 28372017 10 partingnu

27、m:1268, partednum:986, commentsnum:1984 5.3.4 收割资源总数接口 定义：String harvest MetaDescTotal(String jsonStr); 描述：获取成员馆待收割资源的文献编目总数。 参数说明：遵循 JSON 格式串要求，数据元素描述见表9。 表9 收割资源总数接口参数表 标识符 名称 说明 表示格式 备注 fromdate 开始日期 收割开始日期 D8 librarycode 成员馆编码 成员馆唯一标识符 C.20 参见附录A.19 harvestsource 收割来源 数字资源提供商的编码 取值范围见附录A.20 参数 j

28、sonStr 示例： librarycode:3725022005156000, harvestsource:chaoxing, fromdate: 2015-12-25 返回值说明：遵循 JSON 格式串要求，数据元素描述见表10。 表10 收割资源总数接口返回值表 标识符 名称 说明 表示格式 备注 state 执行状态 指示功能的执行状态 N1 取值范围见附录A.5 statedesc 状态描述 执行结果的详细描述 C.100 fromdate 开始日期 收割开始日期 D8 librarycode 成员馆编码 成员馆唯一标识符 C.20 参见附录A.19 harvestsource 收割

29、来源 数字资源提供商的编码 C.20 取值范围见附录A.20 total 总条数 指定时间范围内文献编目总数 N.9 Fromdate 参数缺省时， 返回所有文献编目数量 返回值示例： state:0, statedesc:执行成功, librarycode:3725022005156000, harvestsource: chaoxing, fromdate:2011-02-17, DB34/T 28372017 11 total:289 5.3.5 收割文献编目接口 定义：String harve stMetaDesc(String jsonStr); 描述：获取成员馆待收割资源的文献编目

30、信息，一般包括数字资源的部分元数据及纸质书目的部分 MARC 数据；若成员馆某条文献目录发生了变更，需要本地予以标记，以供下次收割。 参数说明：遵循 JSON 格式串要求，数据元素描述见表11。 表11 收割文献编目接口参数表 标识符 名称 说明 表示格式 备注 librarycode 成员馆编码 成员馆唯一标识符 C.20 参见附录A.19 harvestsource 收割来源 数字资源提供商的编码 C.20 取值范围见附录A.20 fromdate 开始日期 收割开始日期 D8 pagenum 页号 N.9 默认值为 1 pagesize 页尺寸 N.9 默认值为 20 参数 jsonSt

31、r 示例： librarycode:3725022005156000, harvestsource: chaoxing, fromdate:2011-02-17, pagenum:1, pagesize:20 返回值说明：遵循 JSON 格式串要求，数据元素描述参见表6。 返回值示例： state:0, statedesc:执行成功, list: librarycode:3725022005156000, harvestsource: chaoxing, catalogcode:432423334, seriesname:, bookname:稻茬冬小麦不同播种方式和播种量试验研究, isoc

32、ode:, publisher:北京地矿出版社, publishdate:2009-01, author:王红磊, authormodifier:作者, abstract:稻茬冬小麦不同播种方式和播种量试验研究, DB34/T 28372017 12 publishingperiod:15, coverpicture:, topic:冬小麦, harvestsource:zhiwang, sourceurl:http:/61.190.99.10:9995/kns55/detail/detail.aspx?recid= 描述：在收割的资源库检索需要的文献编目,在检索参数中，必须至少按照附录A.3

33、 中所列要求提 供分类检索，能够按照中国图书馆分类法提供分类检索，返回数据符合数据规格要求，参见 5.3.5 收割文献编目的相关规定。 参数说明：遵循 JSON 格式串要求，数据元素描述见表12。 表12 资源检索接口参数表 标识符 名称 说明 表示格式 备注 searchtype 检索类型 N.2 取值范围见附录A.3，默认值为 0 searchrange 检索范围 N.2 取值范围见附录A.4，默认值为 1 classes 中国图书馆分类法 C.20 缺省表示忽略 pagenum 页号 N.9 默认值为 1 pagesize 页尺寸 N.9 默认值为 20 注： 除以上所列参数外，也可任意

34、选取表6 文献编目信息表中的任意字段作为检索参数，可由接口实现者自由提供 实现，但为了提供更加实用的功能，推荐选用更多字段作为检索关键字或组合。 参数 jsonStr 示例： searchtype:0, searchrange:1, DB34/T 28372017 13 classes:A1, pagenum:1, pagesize:20 返回值说明：遵循 JSON 格式串要求，数据元素描述参见表6。 返回值示例： state:0, statedesc:执行成功, searchtype:0, searchrange:1, classes:A1, pagenum:1, pagesize:20 l

35、ist: catalogcode:432423334, seriesname:, bookname:稻茬冬小麦不同播种方式和播种量试验研究, isocode:, publisher:北京地矿出版社, publishdate:2009-01, author:王红磊, authormodifier:作者, abstract:稻茬冬小麦不同播种方式和播种量试验研究, publishingperiod:15, coverpicture:, topic:冬小麦, harvestsource:zhiwang, sourceurl:http:/61.190.99.10:9995/kns55/detail/d

36、etail.aspx?recid= 描述：获取指定书目的成员馆馆藏描述明细信息。 参数说明：遵循 JSON 格式串要求，数据元素描述见表14。 表14 馆藏接口参数表 标识符 名称 说明 表示格式 备注 librarycode 成员馆编码 成员馆唯一标识符 C.20 参见附录A.19 catalogcode 文献编目代码 C.50 pagenum 页号 N.9 默认值为 1 pagesize 页尺寸 N.9 默认值为 20 参数 jsonStr 示例： DB34/T 28372017 15 librarycode :3725021568124000, catalogcode:20110877,

37、 pagenum:1, pagesize:20 返回值说明：遵循 JSON 格式串要求，数据元素描述见表13 及表15。 表15 馆藏接口返回值表 标识符 名称 说明 表示格式 备注 state 执行状态 指示功能的执行状态 N1 取值范围见附录A.5 statedesc 状态描述 执行结果的详细描述 C.100 performdate 执行日期 操作执行的本地服务器 日期时间 D8T6 返回值示例： state:0, statedesc:描述, performdate:2012-03-05 55:54:34, data: catalogcode:20110217003, librarycod

38、e:3725022013254000, pagenum:1, pagesize:10, pagedata: isocode:isbn, bookname:书名, copier:副本数, volumes:卷数, barcode:图书条码号, indexnumber:图书条码号, roomlocation:馆藏地点, holdlocation:排架位置, libstatus:馆藏状态 5.5 总分馆流通统计 5.5.1 流通接口数据 流通数据的通用共性约定内容见表16。 DB34/T 28372017 16 表16 流通数据通用共性约定表 标识符 名称 说明 表示格式 备注 id 内部标识 per

39、formdate 执行日期 D8T6 readercode 读者标识 接口用户自行确定读者数据 的标识字段 C.20 推荐采用身份证号 barcode 条码号 C.20 对于数字资源， 可以采用记录的 id 或编码 title 题名 书名、杂志名等 C.100 若是 MARC 书目，则取 F200a 字段的值 ltcode 文献类型 说明 C.40 取值范围见附录A.15 ownerlib 所属馆 成员馆名称 C.60 hlcode 馆藏地点 成员馆的实际馆藏地点 C.60 reborrownum 续借次数 同一个读者连续续借的最大 次数，超出即不可再借。 N.2 borrowtype 借出类

40、型 N1 取值范围： 1 表示首次借出，2 表示续借 financetype 财经类型 超期罚款，污损罚款等 N1 取值范围见附录A.13 borrowdate 借阅日期 D8 returndate 应还日期 D8 realreturndate 实还日期 D8 isexpire 是否超期 BL usercode 工作人员代码 C.20 attachstatus 附件是否借出 BL 例如光盘是否随书借出 altfield0 备用 Api 实现者，可根据情况使 用本字段传递额外信息 C.4000 数据形式，采用 json 数组形 式。 altfield1 备用 Api 实现者，可根据情况使 用本字

41、段传递额外信息 C.4000 数据形式，采用 json 对象形 式。 5.5.2 人次统计 定义：String circB yReader(String jsonStr); 描述：根据不同口径和维度统计人次。 参数说明：遵循 JSON 格式串要求，数据元素描述见表17。 表17 人次统计接口参数表 标识符 名称 说明 表示格式 备注 strange 统计口径 限定了所统计数据的范围，如日 月季年等的限定 N.2 取值范围见附录A.7 sttype 统计类型 限定了所统计数据的内容，例如 对于借入、还回、污损等 N.2 取值范围见附录A.9 DB34/T 28372017 17 表17（续） 标

42、识符 名称 说明 表示格式 备注 fromdate 开始日期 统计期间的开始日期 D8 todate 结束日期 统计期间的结束日期 D8 参数 jsonStr 示例： strange:1, sttype:1, fromdate:2013-10-01, todate:2013-10-31 返回值说明：遵循 JSON 格式串要求，数据元素描述见表18。 表18 人次统计接口返回值表 标识符 名称 说明 表示格式 备注 state 执行状态 指示功能的执行状态 N1 取值范围见附录A.5 statedesc 状态描述 执行结果的详细描述 C.100 stdate 请求日期 执行本功能的日期时间 D8

43、T6 strange 统计口径 N.2 取值范围见附录A.7 sttype 统计类型 N.2 取值范围见附录A.9 fromdate 开始日期 统计期间的开始日期 D8 todate 结束日期 统计期间的结束日期 D8 year 年代 自然年 C.4 month 月份 自然月 C.2 week 周 自然周 C.1 date 天 自然天 C.3 stationname 工作站 业务办理的主机标识 C.30 roomlocation 馆藏地点 文献地点 C.30 sumdata 汇总数据 统计出的流通人次 N.8 altfield0 备用 Api 实现者， 可根据情况使用本字 段传递额外信息 C.

44、4000 数据形式，采用 json 数组形式。 altfield1 备用 Api 实现者， 可根据情况使用本字 段传递额外信息 C.4000 数据形式，采用 json 对象形式。 返回值示例： state:0, statedesc:成功执行, stdate:2012-03-05 55:54:34, data: strange:1, DB34/T 28372017 18 sttype:1, fromdate:2013-10-01, todate:2013-10-31, pagedata: year:年代, month:月份, week:周, date:天, stationname:3楼大厅第4号

45、, roomlocation:馆藏地点, sumdata:90234 5.5.3 流通册次统计 定义：String circByC ollection(String jsonStr); 描述：根据不同口径和维度统计流通册次。 参数说明：遵循 JSON 格式串要求，数据元素描述见表19。 表19 流通册次统计接口参数表 标识符 名称 说明 表示格式 备注 strange 统计口径 N.2 取值范围见附录A.8 sttype 统计类型 N.2 取值范围见附录A.10 fromdate 开始日期 统计期间的开始日期 D8 todate 结束日期 统计期间的结束日期 D8 参数 jsonStr 示例： strange:1, sttype:1, fromdate:2013-10-01, todate:2013-10-31 返回值说明：遵循 JSON 格式串要求，数据元素描述见表20。 表20 流通册次统计接口返回值表 标识符 名称 说明 表示格式 备注 state 执行状态 指示功能的执行状态 N1 取值范围见附录A.5 statedesc 状态描述 执行结果的详细描述 C.100 stdate 统计日期 本统计的请求日期 D8 strange 统计口径 N.2 取值