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 目    次 前言 ............................................................................... II  1 范围 .............................................................................. 1  2 规范性引用文件 .................................................................... 1  3 术语和定义 ........................................................................ 1  4 数据元素的描述格式 ................................................................ 3  5 数据与接口 ........................................................................ 3  5.1 5.2 5.3 5.4 5.5 5.6 5.7 认证 .......................................................................... 4  成员馆注册与注销 .............................................................. 4  总分馆资源数据 ................................................................ 6  总分馆馆藏数据 ............................................................... 14  总分馆流通统计 ............................................................... 15  总分馆流通操作 ............................................................... 19  总分馆用户操作 ............................................................... 22  附录 A（规范性附录） 数据字典 ....................................................... 28  参考文献 ............................................................................ 36  I DB34/T 2837—2017 前    言 本标准按照 GB/T 1.1-2009 给出的规则起草。 本标准由安徽省图书馆提出。 本标准由安徽省信息技术标准化技术委员会归口。 本标准起草单位：安徽省图书馆、安徽省智慧公共文化服务工程技术研究中心、安徽省质量和标准 化研究院、安徽华博胜讯信息科技股份有限公司、合肥市图书馆、合肥工业大学、安徽大学。 本标准主要起草人：胡敏、王学杰、许俊松、步翠兰、刘树峰、王建涛、李永钢、智淑英、吴锦、 郑利平、林泽明、汪佂。 II DB34/T 2837—2017 公共图书馆 总分馆 数据接口规范 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 在一个总馆下设立若干分馆,实行一元化垂直管理体系和网状结构模式。 1 DB34/T 2837—2017 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 用一组属性描述定义、标识、表示和允许值的数据单元，它是图书馆业务自动化系统间数据接口所 输入和输出数据的不可分割的基本单位。 2 DB34/T 2837—2017 3.13 活动 activity 活动是对图书馆举办的线上和线下聚会的泛称。 4 数据元素的描述格式 数据元素的描述格式如下： a) 标识符：数据元素的内部唯一标识，由字母与数字组合形成； b) 名称：数据元素的中文名称； c) 说明：数据元素内容的描述与解释； d) 表示格式：数据元素值的类型及长度的表示形式，具体形式见表 1； e) 备注：与该数据元素相关的其他说明，包括数据元素的取值范围、遵循的标准规范要求等。 表1 字符 含义 C 表示数据类型为字符型 N 表示数据类型为数值型 数据元素的表示格式 说明 用 C 后直接加自然数的方式表示定长，如 C4 表示 4 个字符定 长（一个汉字相当于两个 Byte）。 N 后直接加自然数的方式表示定长，N3 表示 3 位数字定长。 用 D 后加 4、6、8 等，分别表示不同数据格式的日期型数据元。 D4 表示 YYYY 即只表示到年份； D 表示数据类型为日期型和日期时间型 D6 表示 YYYY-MM 即表示到月份； D8 表示 YYYY-MM-DD 即表示到日。 遵循 GB/T 7408 数据和交换格式信息交换日期和时间表示法。 用 T 后加 2、4、6 分别表示不同数据格式的时间型数据元。 T2 表示 hh 即只表示小时； T 表示数据类型为时间型 T4 表示 hh:mm 即表示到分钟； T6 表示 hh:mm:ss 即表示到秒。 注意，本部分为 24 小时制。 DnTm 表示日期时间型 BL 表示数据类型为布尔型 BN 表示数据类型为二进制型 N 表示字段的最小长度，M 表示字段 N..M 最大长度（N 可以省去，表示可以是 空串，M 不可省去） N..p,q (p、q 均代表一个 自然数) 表示数据类型为数值型，最长 p 位， 小数点后 q 位（小数点前为 p-q 位） n 代表 4、6、8，m 代表 2、4、6。 例如 D8T6,表示 YYYY-MM-DD hh:mm:ss 在数据格式中应标识出二进制的具体格式，如“JPEG”。 如 C..6 表示最多 6 个字符； N2..7 表示最少 2 位数字最多 7 位数字 如 N..8,2 表示最多 8 位数字，小数点后 2 位 注：在系统建设中遇到数据格式为“..”时建议按最大值使用 5 数据与接口 3 DB34/T 2837—2017 5.1 认证 定义：String authenticate(String jsonStr); 描述：成员馆登录认证。 参数说明：遵循 JSON 格式串要求，数据元素描述见表2。 表2 认证接口参数表 标识符 名称 说明 表示格式 loginname 用户名 用户凭证 C..30 password 口令 SHA 处理过的口令 备注 在成员馆中此凭证需要满足唯一 性要求 通讯端保证用户口令经过 SHA C..60 串。 512 处理。 参数 jsonStr 示例： { "loginname": "uname", "password": "pwd" } 返回值说明：遵循 JSON 格式串要求，数据元素描述见表3。 表3 认证接口返回值表 标识符 名称 说明 表示格式 state 执行状态 指示功能的执行状态 N1 statedesc 状态描述 执行结果的详细描述 C..100 备注 取值范围见附录A.5 返回值示例： { "state":0, "statedesc":"执行成功" } 5.2 成员馆注册与注销 5.2.1 注册 定义：String enroll(String jsonStr); 描述：成员馆注册。 参数说明：遵循 JSON 格式串要求，数据元素描述见表4。 表4 成员馆基本信息表 标识符 名称 说明 表示格式 librarycode 成员馆编码 成