关 键 词：

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

资源描述：

ICS 35 100 L 79 DB34 安徽省地方标准 DB 34 T 2837 2017 公共图书馆 总分馆 数据接口规范 The public library central branch libraries Data interface specification 2017 03 30 发布 2017 04 30 实施 安徽省质量技术监督局 发 布 DB34 T 2837 2017 I 目 次 前言 II 1 范围 1 2 规范性引用文件 1 3 术语和定义 1 4 数据元素的描述格式 3 5 数据与接口 3 5 1 认证 4 5 2 成员馆注册与注销 4 5 3 总分馆资源数据 6 5 4 总分馆馆藏数据 14 5 5 总分馆流通统计 15 5 6 总分馆流通操作 19 5 7 总分馆用户操作 22 附录 A 规范性附录 数据字典 28 参考文献 36 DB34 T 2837 2017 II 前 言 本标准按照 GB T 1 1 2009 给出的规则起草 本标准由安徽省图书馆提出 本标准由安徽省信息技术标准化技术委员会归口 本标准起草单位 安徽省图书馆 安徽省智慧公共文化服务工程技术研究中心 安徽省质量和标准 化研究院 安徽华博胜讯信息科技股份有限公司 合肥市图书馆 合肥工业大学 安徽大学 本标准主要起草人 胡敏 王学杰 许俊松 步翠兰 刘树峰 王建涛 李永钢 智淑英 吴锦 郑利平 林泽明 汪佂 DB34 T 2837 2017 1 公共图书馆 总分馆 数据接口规范 1 范围 本标准规定了图书馆业务信息化系统之间的数据接口规范 本标准适用于公共图书馆 高校图书馆和数字资源提供商 也可适用于图书馆行业信息资源交换体 系的设计与建设 2 规范性引用文件 下列文件对于本文件的应用是必不可少的 凡是注日期的引用文件 仅所注日期的版本适用于本文 件 凡是不注日期的引用文件 其最新版本 包括所有的修改单 适用于本文件 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 library consortium 县 区及其以上级公共图书馆形成的联盟 3 2 成员馆 member library 注册成为图书馆联盟正式成员的图书馆 3 3 总分馆 central branch library 在一个总馆下设立若干分馆 实行一元化垂直管理体系和网状结构模式 DB34 T 2837 2017 2 3 4 机器可读目录 machine readable catalog MARC 以代码形式和特定结构记录在计算机存储载体上的 可供计算机识别与阅读的目录 3 5 本体数据 ontology data 由 MARC 描述的目标数据 3 6 发现级别 expose level 阅读资源在文献编目级别的对外暴露程度 3 7 可用级别 available level 最终读者或软件获得本体数据的能力程度 3 8 收割 harvest 根据发现级别 联盟或成员馆以下载的形式获得其他成员馆文献编目的过程 3 9 揭示 reveal 将 MARC 数据以可视化的形式向用户呈现 表示的过程 3 10 馆藏 reserves 图书馆收集的各种类型文献资料的总和 3 11 流通 circulation 图书或其他资源进出图书馆的过程 3 12 数据元素 data element 用一组属性描述定义 标识 表示和允许值的数据单元 它是图书馆业务自动化系统间数据接口所 输入和输出数据的不可分割的基本单位 DB34 T 2837 2017 3 3 13 活动 activity 活动是对图书馆举办的线上和线下聚会的泛称 4 数据元素的描述格式 数据元素的描述格式如下 a 标识符 数据元素的内部唯一标识 由字母与数字组合形成 b 名称 数据元素的中文名称 c 说明 数据元素内容的描述与解释 d 表示格式 数据元素值的类型及长度的表示形式 具体形式见表 1 e 备注 与该数据元素相关的其他说明 包括数据元素的取值范围 遵循的标准规范要求等 表1 数据元素的表示格式 字符 含义 说明 C 表示数据类型为字符型 用 C 后直接加自然数的方式表示定长 如 C4 表示 4 个字符定 长 一个汉字相当于两个 Byte 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 即表示到秒 注意 本部分为 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 位 如 N 8 2 表示最多 8 位数字 小数点后 2 位 注 在系统建设中遇到数据格式为 时建议按最大值使用 5 数据与接口 DB34 T 2837 2017 4 5 1 认证 定义 String authenticate String jsonStr 描述 成员馆登录认证 参数说明 遵循 JSON 格式串要求 数据元素描述见表2 表2 认证接口参数表 标识符 名称 说明 表示格式 备注 loginname 用户名 用户凭证 C 30 在成员馆中此凭证需要满足唯一 性要求 password 口令 SHA 处理过的口令 串 C 60 通讯端保证用户口令经过 SHA 512 处理 参数 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 格式串要求 数据元素描述见表4 表4 成员馆基本信息表 标识符 名称 说明 表示格式 备注 librarycode 成员馆编码 成员馆唯一标识符 C 20 参见附录A 19 libraryname 成员馆名称 成员馆中文名称 C 100 图书馆对外公示的名称 loginname 用户名 用户凭证 C 30 在成员馆中此凭证满足唯一性要求 DB34 T 2837 2017 5 表4 续 标识符 名称 说明 表示格式 备注 password 口令 SHA 处理过的口令串C 60 用户口令经过 SHA512 处理 libraryaddr 成员馆地址 通讯地址 C 100 librarycity 所在城市 城市全称 C 50 libraryprovince 所在省份 省份全称 C 100 enrolldate 注册日期 注册发生日 D8 非生效日 unenrolldate 注销日期 注销发生日 D8 注销当日即为生效日 参数 jsonStr 示例 librarycode 成员馆编码 libraryname 成员馆名称 loginname 登录名 password 口令 libraryaddr 成员馆地址 librarycity 所在城市 libraryprovince 所在省份 enrolldate 注册日期 unenrolldate 注销日期 返回值说明 参见 5 1 认证接口的返回值说明 返回值示例 参见 5 1 认证接口的返回值示例 5 2 2 注销 定义 String unenroll String jsonStr 描述 成员馆注销 注销后即表示退出联盟 不再享有联盟所提供的各项功能及服务 参数说明 遵循 JSON 格式串要求 数据元素描述见表5 表5 注销接口参数表 标识符 名称 说明 表示格式 备注 loginname 用户名 用户凭证 C 30 在成员馆中此凭证需要满足 唯一性要求 password 口令 SHA 处理过的口令串 C 60 通讯端保证用户口令经过 SHA 512 处理 librarycode 成员馆编码 要注销的成员馆编码 C 20 参见附录A 19 参数 jsonStr 示例 loginname uname password pwd librarycode 成员馆编码 DB34 T 2837 2017 6 返回值说明 参见 5 1 认证接口的返回值说明 返回值示例 参见 5 1 认证接口的返回值示例 5 3 总分馆资源数据 5 3 1 资源接口数据 资源接口数据包括 CNMARC 描述的资源和数字资源厂商系统描述的元数据资源 具体描述见表6 表6 资源接口数据描述表 标识符 名称 说明 表示格式 备注 rdid 资源描述 ID 记录外部资源的标识符 与成 员馆 收割来源一起组成组合 唯一索引 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 出版日期 D4 若是 MARC 书目 则取 F210d 字段的值 author 著者 作者 书的或者文章的作者 C 300 若是 MARC 书目 则取 F200f 字段的值 authormodifier 著者类型 书的作者 杂志的编者等 C 20 取值范围见附录A 12 abstract 摘要 内容提要 C 200 对于杂志来说 提供杂志目 录 对于书籍则提供内容提要 topic 主题词 主题词 关键字 可以是句子 均以逗号隔开 C 200 coverpicture 封面图片 一个引用地址 不保存封面数 据本身 C 100 可选 接口实现者若提供本值 须为有效 URL 地址 publishingperiod 出版周期 期刊 杂志的出版周期 N 4 可选 对于报刊 杂志须提供 本值 单位是天 对于非期刊 该值设置为 0 reservescopier 藏量 成员馆中总藏量 N 2 对于纸本 按照实际馆藏数量 赋值 多卷数或纸本资源 此 值为 0 具体值写入表 13 对于数字资源 取值为 1 DB34 T 2837 2017 7 表6 续 标识符 名称 说明 表示格式 备注 harvestsource 收割来源 标识本条资源收割自哪个数 字资源厂商或成员馆 C 100 可以是厂商网址信息 也可以是成员馆标识符或厂 商的标识 如 superstar 超 星 bookan 博看 等 可 由收割接口实现提供者自行 定义 sourceurl 源URL 资源链接 C 512 如果发现级别为 2 本链可用 于获得源文献目录所描述的 明细信息 如果使用级别为 2 本链将可 用于直接下载本体数据 origindate 收割来源的书目数 据创建 变更 日 期 自动化系统中 编目阶段对图 书进行书目编目时所创建 变 更 的书目数据的当天日期 D8 harvestdate 收割日期 收割到检索库或索引库的日 期 D8 exposelevel 发现级别 N1 取值范围见附录A 1 availablelevel 使用级别 N1 取值范围 1 代表内部完全可用 2 代表对外完全可用 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 实现者 可根据情况使用 本字段传递额外信息 C 4000 数据形式 采用 json 数组形 式 altfield1 备用 Api 实现者 可根据情况使用 本字段传递额外信息 C 4000 数据形式 采用 json 对象形 式 5 3 2 活动接口数据 活动资源数据描述见表7 DB34 T 2837 2017 8 表7 活动资源数据描述表 标识符 名称 说明 表示格式备注 id 活动标识 内部标识 N16 code 活动编码 各馆系统内的活动标识 C 30 title 活动名称 C 100 abstracts 活动简介 摘要 C 300 types 活动类型 例如培训 讲座 电影播放 创客活 动等 C 40 keywords 活动关键字 采纳馆方系统中对等的数据 是指活 动所涉及主题的分类词 例如饮食 茶道 解读 人物 教育 少儿等等 允许有多个关键字 以逗号隔开 C 40 馆方可自行定义 url 宣传地址 宣传图片或视频的地址 C 80 address 活动举办地 邮政的地址 C 100 startdate 活动举办日 D8 continuenum 活动持续日 天为单位 可以是小数 如 0 5 代 表半天 N2 enddate 活动结束日 D8 periodnum 活动周期性 0 代表 1 次 其余数字代表周期 例如 7 代表每隔 7 天进行一次 N2 status 活动状态 如期举行 提前取消 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 partednum 实际参加人数 N6 commentsnum 评论量 N10 altfield0 备用 Api 实现者 可根据情况使用本字段 传递额外信息 C 4000 数据形式 采用 json 数组形式 altfield1 备用 Api 实现者 可根据情况使用本字段 传递额外信息 C 4000 数据形式 采用 json 对象形式 5 3 3 收割活动接口 定义 String harvestActivityMetaDesc String jsonStr DB34 T 2837 2017 9 描述 获取成员馆待活动元数据信息 提供本接口功能的系统需要自行查重处理 参数说明 遵循 JSON 格式串要求 数据元素描述见表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 活动类型 keywords 活动关键字 url 宣传地址 address 活动举办地 startdate 活动举办日 continuenum 活动持续日 enddate 活动结束日 periodnum 7 status 1 librarycode 活动所属单位 portable 活动流动性 contactman 活动联系人 contactphone 活动联系人电话 sponsor 活动主办方 sponsorphone 主办方联系电话 organizer 活动承办方 organizerphone 承办方联系电话 DB34 T 2837 2017 10 partingnum 1268 partednum 986 commentsnum 1984 5 3 4 收割资源总数接口 定义 String harvestMetaDescTotal String jsonStr 描述 获取成员馆待收割资源的文献编目总数 参数说明 遵循 JSON 格式串要求 数据元素描述见表9 表9 收割资源总数接口参数表 标识符 名称 说明 表示格式 备注 fromdate 开始日期 收割开始日期 D8 librarycode 成员馆编码 成员馆唯一标识符 C 20 参见附录A 19 harvestsource 收割来源 数字资源提供商的编码 取值范围见附录A 20 参数 jsonStr 示例 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 收割来源 数字资源提供商的编码 C 20 取值范围见附录A 20 total 总条数 指定时间范围内文献编目总数N 9 Fromdate 参数缺省时 返回所有文献编目数量 返回值示例 state 0 statedesc 执行成功 librarycode 3725022005156000 harvestsource chaoxing fromdate 2011 02 17 DB34 T 2837 2017 11 total 289 5 3 5 收割文献编目接口 定义 String harvestMetaDesc String jsonStr 描述 获取成员馆待收割资源的文献编目信息 一般包括数字资源的部分元数据及纸质书目的部分 MARC 数据 若成员馆某条文献目录发生了变更 需要本地予以标记 以供下次收割 参数说明 遵循 JSON 格式串要求 数据元素描述见表11 表11 收割文献编目接口参数表 标识符 名称 说明 表示格式 备注 librarycode 成员馆编码 成员馆唯一标识符 C 20 参见附录A 19 harvestsource 收割来源 数字资源提供商的编码C 20 取值范围见附录A 20 fromdate 开始日期 收割开始日期 D8 pagenum 页号 N 9 默认值为 1 pagesize 页尺寸 N 9 默认值为 20 参数 jsonStr 示例 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 稻茬冬小麦不同播种方式和播种量试验研究 isocode publisher 北京地矿出版社 publishdate 2009 01 author 王红磊 authormodifier 作者 abstract 稻茬冬小麦不同播种方式和播种量试验研究 DB34 T 2837 2017 12 publishingperiod 15 coverpicture topic 冬小麦 harvestsource zhiwang sourceurl http 61 190 99 10 9995 kns55 detail detail aspx recid 描述 在收割的资源库检索需要的文献编目 在检索参数中 必须至少按照附录A 3 中所列要求提 供分类检索 能够按照 中国图书馆分类法 提供分类检索 返回数据符合数据规格要求 参见 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 注 除以上所列参数外 也可任意选取表6 文献编目信息表中的任意字段作为检索参数 可由接口实现者自由提供 实现 但为了提供更加实用的功能 推荐选用更多字段作为检索关键字或组合 参数 jsonStr 示例 searchtype 0 searchrange 1 DB34 T 2837 2017 13 classes A1 pagenum 1 pagesize 20 返回值说明 遵循 JSON 格式串要求 数据元素描述参见表6 返回值示例 state 0 statedesc 执行成功 searchtype 0 searchrange 1 classes A1 pagenum 1 pagesize 20 list 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 detail aspx recid 描述 获取指定书目的成员馆馆藏描述明细信息 参数说明 遵循 JSON 格式串要求 数据元素描述见表14 表14 馆藏接口参数表 标识符 名称 说明 表示格式 备注 librarycode 成员馆编码 成员馆唯一标识符 C 20 参见附录A 19 catalogcode 文献编目代码 C 50 pagenum 页号 N 9 默认值为 1 pagesize 页尺寸 N 9 默认值为 20 参数 jsonStr 示例 DB34 T 2837 2017 15 librarycode 3725021568124000 catalogcode 20110877 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 librarycode 3725022013254000 pagenum 1 pagesize 10 pagedata isocode isbn bookname 书名 copier 副本数 volumes 卷数 barcode 图书条码号 indexnumber 图书条码号 roomlocation 馆藏地点 holdlocation 排架位置 libstatus 馆藏状态 5 5 总分馆流通统计 5 5 1 流通接口数据 流通数据的通用共性约定内容见表16 DB34 T 2837 2017 16 表16 流通数据通用共性约定表 标识符 名称 说明 表示格式 备注 id 内部标识 performdate 执行日期 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 借出类型 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 实现者 可根据情况使 用本字段传递额外信息 C 4000 数据形式 采用 json 对象形 式 5 5 2 人次统计 定义 String circByReader String jsonStr 描述 根据不同口径和维度统计人次 参数说明 遵循 JSON 格式串要求 数据元素描述见表17 表17 人次统计接口参数表 标识符 名称 说明 表示格式 备注 strange 统计口径 限定了所统计数据的范围 如日 月季年等的限定 N 2 取值范围见附录A 7 sttype 统计类型 限定了所统计数据的内容 例如 对于借入 还回 污损等 N 2 取值范围见附录A 9 DB34 T 2837 2017 17 表17 续 标识符 名称 说明 表示格式 备注 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 请求日期 执行本功能的日期时间 D8T6 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 4000 数据形式 采用 json 数组形式 altfield1 备用 Api 实现者 可根据情况使用本字 段传递额外信息 C 4000 数据形式 采用 json 对象形式 返回值示例 state 0 statedesc 成功执行 stdate 2012 03 05 55 54 34 data strange 1 DB34 T 2837 2017 18 sttype 1 fromdate 2013 10 01 todate 2013 10 31 pagedata year 年代 month 月份 week 周 date 天 stationname 3楼大厅第4号 roomlocation 馆藏地点 sumdata 90234 5 5 3 流通册次统计 定义 String circByCollection 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 取值范围见附录A 8 DB34 T 2837 2017 19 表20 续 标识符 名称 说明 表示格式 备注 sttype 统计类型 N 2 取值范围见附录A 10 fromdate 开始日期 统计期间的开始日期 D8 todate 结束日期 统计期间的结束日期 D8 year 年代 自然年 C 4 month 月份 自然月 C 2 week 周 自然周 C 1 date 天 自然天 C 3 stationname 工作站 业务办理的主机标识 C 50 roomlocation 馆藏地点 文献地点 C 50 classes 图书分类 C 100 参见 中国图书馆分类法 sumdata 汇总数据 统计出的流通册次 N 8 altfield0 备用 Api 实现者 可根据情况使 用本字段传递额外信息 C 4000 数据形式 采用 json 数组形 式 altfield1 备用 Api 实现者 可根据情况使 用本字段传递额外信息 C 4000 数据形式 采用 json 对象形 式 返回值示例 state 0 statedesc 成功执行 stdate 2012 03 05 55 54 34 data strange 1 sttype 1 fromdate 2013 10 01 todate 2013 10 31 pagedata year 年代 month 月份 week 周 date 天 stationname 3楼第4号 roomlocation 馆藏地点 文献地点 classes 分类 sumdata 统计出的流通册次 5 6 总分馆流通操作 DB34 T 2837 2017 20 5 6 1 修改馆藏状态 定义 String performCirculateOperate String jsonStr 描述 修改成员馆的馆藏资源的馆藏状态 参数说明 遵循 JSON 格式串要求 数据元素描述见表21 表21 修改馆藏状态接口参数表 标识符 名称 说明 表示格式 备注 readercode 读者标识符 C 30 barcode 图书条码号 C 60 librarycode 成员馆编码 成员馆唯一标识符 C 20 参见附录A 19 operatetype 流通类型 表示纸本图书的存在状态N1 取值范围参见附录A 11 operatedate 操作日期 发生本操作的日期 D8 operator 操作者或读者 表示馆藏状态的操作人 C 30 参数 jsonStr 示例 readercode 1 barcode 176582323 librarycode 3725022012596000 operatetype 1 operatedate 2013 10 31 operator libadmin 返回值说明 遵循 JSON 格式串要求 数据元素描述见表22 表22 修改馆藏状态接口返回值表 标识符 名称 说明 表示格式 备注 state 执行状态 指示功能的执行状态 N1 取值范围见附录A 5 statedesc 状态描述 执行结果的详细描述 C 100 operatedate 操作日期 说明 D8T6 返回值示例 state 0 statedesc 成功执行 operatedate 2012 03 05 55 54 34 5 6 2 当前流通查询 定义 String qyCircByReader String jsonStr 描述 根据读者卡号和成员馆注册号查询一个读者在本成员馆当前的流通信息 返回中不包括流通 历史数据 DB34 T 2837 2017 21 参数说明 遵循 JSON 格式串要求 数据元素描述见表23 表23 当前流通查询接口参数表 标识符 名称 说明 表示格式 备注 readercode 读者编码 跨馆分配的统一标识符 可以是卡号 C 20 要做到省内唯一 建议为身 份证号码 librarycode 成员馆编码 成员馆唯一标识符 C 20 参见附录A 19 参数 jsonStr 示例 readercode 读者代码 证号 librarycode 3725022006256000 返回值说明 遵循 JSON 格式串要求 数据元素描述见表24 及表16 表24 当前流通查询接口返回值表 标识符 名称 说明 表示格式 备注 state 执行状态 指示功能的执行状态 N1 取值范围见附录A 5 statedesc 状态描述 执行结果的详细描述 C 100 performdate 执行日期 检索返回时的日期 D8T6 返回值示例 state 0 statedesc 成功执行 performdate 2012 03 05 55 54 34 data userid 1 libid 38 pagedata readercode 读者标识 barcode 条码号 booktitle 10万个为什么 ltcode 文献类型 ownerlib 所属馆 hlcode 馆藏地点 文献地点 roomlocation reborrownum 2 borrowtype 1 financetype 1 borrowdate 2015 03 12 returndate 2015 04 15 realreturndate 2015 03 20 DB34 T 2837 2017 22 isexpire false usercode 工作人员代码 attachstatus false 5 7 总分馆用户操作 5 7 1 用户接口数据 用户数据描述见表25 表25 用户数据表 标识符 名称 说明 表示格式 备注 id 内部标识 N12 librarycode 成员馆编码 成员馆唯一标识符 C 20 参见附录A 19 readercode 读者代码 证号 读者标识 C 20 cardstate 读者证状态 N1 取值范围见附录A 18 name 读者姓名 C 50 loginname 用户名 用户凭证 C 30 在成员馆中此凭证需要满足 唯一性要求 password 口令 SHA 处理过的口令串 C 60 通讯端保证用户口令经过 SHA 512 处理 idtype 身份证件类型 N1 取值范围见附录A 16 idno 身份证件号码 C 20 按照 GB 11643 规定执行 gender 性别 N1 取值 1 或 2 1 为男 2 为女 birthday 出生年月 D4 deputy 监护人 C 50 workunit 单位名称 C 50 address 联系地址 C 120 telephone 联系电话 C 20 mobile 手机号 C 20 email Email C 40 postcode 邮编 C 6 rtcode 读者类型代码 N1 取值范围见附录A 14 spanlibtype 馆际流通类型 N1 取值范围见附录A 17 isspanlib 是否馆际读者 BL workercode 经办人 C 50 enabledate 启用日期 D8 expirydate 有效日期 D8 DB34 T 2837 2017 23 表25 续 标识符 名称 说明 表示格式 备注 createdate 办证日期 D8 checkdate 核证日期 D8 imageurl 照片地址 C 100 specialty 专业 C 40 educationdegree 文化程度 C 10 按照 GB T 4658 规定执行 nation 民族 C 20 按照 GB T 3304 规定执行 nativeplace 籍贯 C 50 按照 GB T 2659 规定执行 professionaltitle 职称 C 20 job 职务 C 30 business 职业行业 C 30 interesting 兴趣 C 100 remark 备注 C 100 altfield0 备用 Api 实现者 可根据情 况使用本字段传递额 外信息 C 4000 数据形式 采用 json 数组形 式 altfield1 备用 Api 实现者 可根据情 况使用本字段传递额 外信息 C 4000 数据形式 采用 json 对象形 式 5 7 2 用户收割 5 7 2 1 获取收割用户总数 定义 String harvestUserTotal String jsonStr 描述 获取成员馆待收割读者用户总数 参数说明 遵循 JSON 格式串要求 数据元素描述见表26 表26 获取收割用户总数接口参数表 标识符 名称 说明 表示格式 备注 fromdate 开始日期 收割开始日期 D8 librarycode 成员馆编码 成员馆唯一标识符 C 20 参见附录A 19 参数 jsonStr 示例 librarycode chaoxing fromdate 2015 12 25 返回值说明 遵循 JSON 格式串要求 数据元素描述见表27 DB34 T 2837 2017 24 表27 获取收割用户总数接口返回值表 标识符 名称 说明 表示格式 备注 state 执行状态 指示功能的执行状态 N1 取值范围见附录A 5 statedesc 状态描述 执行结果的详细描述 C 100 librarycode 成员馆编码 成员馆唯一标识符 C 20 参见附录A 19 fromdate 开始日期 收割开始日期 D8 total 总用户数 指定时间范围内用户总数 N 9 Fromdate 参数缺省时 返 回所有用户数量 返回值示例 state 0 statedesc 执行成功 librarycode 3725022013689000 fromdate 2011 02 17 total 289 5 7 2 2 收割用户 定义 String harvestUsers String jsonStr 描述 批量收割成员馆中的读者数据 成员馆可根据情况 决定可以对外共享的用户数据 参数说明 遵循 JSON 格式串要求 数据元素描述见表28 表28 收割用户接口参数表 标识符 名称 说明 表示格式 备注 fromdate 开始日期 收割开始日期 D8 包含开始日期当日数据 pagenum 页号 N 9 默认值为 1 pagesize 页尺寸 N 9 默认值为 20 参数 jsonStr 示例 fromdate 2011 02 17 pagenum 1 pagesize 20 返回值说明 参见表25 及表29 表29 收割用户接口返回值表 标识符 名称 说明 表示格式 备注 state 查询执行状态 N 2 取值范围见附录A 8 statedesc 执行状态描述 N 2 取值范围见附录A 10 fromdate 开始日期 统计期间的开始日期 D8 DB34 T 2837 2017 25 表29 续 标识符 名称 说明 表示格式 备注 pagenum 页号 N 9 默认值为 1 pagesize 页尺寸 N 9 默认值为 20 返回值示例 state 0 statedesc 执行成功 fromdate 2011 02 17 pagenum 1 pagesize 20 list librarycode 成员馆编码 readercode 读者代码 证号 cardstate 读者证状态 name 读者姓名 loginname 用户名 idtype 身份证件类型 idno 身份证件号码 gender 1 birthday 出生年月 deputy 监护人 workunit 单位名称 address 联系地址 telephone 联系电话 mobile 手机号 email Email postcode 邮编 rtcode 读者类型代码 spanlibtype 馆际流通类型 isspanlib false workercode 经办人 enabledate 启用日期 expirydate 有效日期 createdate 办证日期 checkdate 核证日期 imageurl 照片地址 specialty 专业 educationdegree 文化程度 nation 民族 nativeplace 籍贯 professionaltitle 职称 DB34 T 2837 2017 26 job 职务 business 职业行业 interesting 兴趣 5 7 3 读取用户信息 定义 String getReaderinfo String jsonStr 描述 获得成员馆中某个读者的明细描述信息 参数说明 遵循 JSON 格式串要求 数据元素描述见表30 表30 读取用户信息接口参数表 标识符 名称 说明 表示格式 备注 readercode 读者代码 读者标识 C 20 librarycode 成员馆编码 成员馆唯一标识符 C 20 取值范围见附录A 19 参数 jsonStr 示例 readercode 读者代码 证号 librarycode 成员馆编码 返回值说明 遵循 JSON 格式串要求 数据元素描述见表31 及表25 表31 读取用户信息接口返回值表 标识符 名称 说明 表示格式 备注 state 执行状态 指示功能的执行状态 N1 取值范围见附录 A 5 statedesc 状态描述 执行结果的详细描述 C 100 返回值示例 state 0 statedesc 执行成功 librarycode 成员馆编码 readercode 读者代码 证号 cardstate 读者证状态 name 姓名 loginname 登录名 idtype 身份证件类型 idno 身份证件号码 gender 1 birthday 2015 11 deputy 监护人 DB34 T 2837 2017 27 workunit 单位名称 address 联系地址 telephone 联系电话 mobile 手机号 email Email postcode 邮编 rtcode 读者类型代码 typeid 读者类型ID typetitle 读者类型 spanlibtype 馆际流通类型 isspanlib false workercode 经办人 enabledate 启用日期 expirydate 有效日期 createdate 办证日期 checkdate 核证日期 imageurl 照片地址 specialty 专业 educationdegree 文化程度 nation 民族 nativeplace 籍贯 professionaltitle 职称 job 职务 business 职业行业 interesting 兴趣 remark 备注 DB34 T 2837 2017 28 A A 附 录 A 规范性附录 数据字典 A 1 发现级别 exposelevel 见表A 1 表A 1 级别编码 发现级别 说明 1 1 级发现数据 只暴露部分编目数据 2 2 级发现数据 只暴露部分编目和馆藏数据 3 3 级发现数据 只暴露全部编目数据 除馆藏部分外 4 4 级发现数据 暴露全部编目数据 包括编目和馆藏两部分数据的全部 A 2 馆藏状态 libstatus 见表A 2 表A 2 状态编码 状态名称 说明 1 在馆 可供借出 处于在馆状态 图书可以流通 2 借出 成员馆已经将此书借出 在读者手上 3 剔旧 退出流通 4 目录 新购 处于编目状态 图书刚刚上架 尚未进入流通 5 丢失 图书丢失 A 3 检索类型 searchtype 见表A 3 表A 3 检索代码 检索类型 说明 0 全部 不限定类型 从全部资源中获取 1 图书 从成员馆自动化系统中收割来的元数据 一律采用这个类型 2 期刊 从成员馆自动化系统中收割来的元数据 一律采用这个类型 3 报纸 从成员馆自动化系统中收割来的元数据 一律采用这个类型 4 音频 用于其他来源的音频类 采用此值 5 视频 用于其他来源的视频类 采用此值 DB34 T 2837 2017 29 A 4 检索范围 searchrange 见表A 4 表A 4 范围代码 范围名称 说明 1 本馆 2 跨馆 3 本省 4 跨省

内容简介：

-