DB34∕T 2837-2017 公共图书馆 总分馆 数据接口规范.pdf
《DB34∕T 2837-2017 公共图书馆 总分馆 数据接口规范.pdf》由会员分享,可在线阅读,更多相关《DB34∕T 2837-2017 公共图书馆 总分馆 数据接口规范.pdf(40页珍藏版)》请在咨信网上搜索。
1、lCS 35.100 L 79 DB34 r-1-.文徽省巾blTLF 方标准DB 34/T 2837一一2017公共图书馆总分馆数据接口规范The public library-central branch libraries Data interface specification 2017-03-30发布2017-04-30实施安徽省质量技术监督局发布DB34/T 2837-2017 目欠.言.11 1 范围.1 2 规范性引用文件.1 3 术语和定义.1 4 数据元素的描述格式.3 5 数据与接口.3 5.1 认证.4 5.2 成员馆注册与注销.4 5.3 总分馆资源数据.6 5.4
2、总分馆馆藏数据.14 5.5 总分馆流通统计.1.5 5.6 总分馆流通操作.19 5.7 总分馆用户操作.22 附录A(规范性附录)数据宁典.28 参考文献.36 DB34/T 2837-2017 目IJ1=1 本标准按照GB/T1.1-2009给山的划则起草。本标准由安徽省罔书馆提山。本标准由安徽省信息技术标准化技术委员会归口。本标准起草单位:安散省图节馆、安徽省智慧公共文化服务上程技术研究中心、安散省质量和标准化研究院、安徽华博胜讯信息、科技股份有限公司、合肥市图书馆、合肥l业大学、安i敦大学。本标准主要起草人:明敏、王学杰、t俊松、步翠兰、刘树峰、王建涛、李永钢、智淑英、吴锦、郑利平、
3、林泽明、汪f正。II DB34/T 2837-2017 公共图书馆总分馆数据接口规范1 范围本标准规定了图书馆业务信息化系统之间的数据接口规范。本标准适用于公共图书馆、高校图书馆和数宁资源提供商,也可适用于图书馆行业信息资源交换体系的设计与建设。2 规范性引用文件下列文件对于本文件的同用是必不可少的。)也是注山期的习|用文件,仅所注U期的版本适用于本文件。凡是不注且期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T 2260 中华人民共和国行政F划代码GB/T 2659lli:界各国和地区名称代码GB/T 3304 中国各民族名称的罗马字母拼写法和代码GB/T 4658 午?历
4、代码GB!T 7408 数据元和交换恪式信息交换日期和时问表示法GB!T 10114 县级以下行政区划代码编制规则GB 11643 公民身份号码GA!T 2000.1.56 公安信息代码第156部分:常用证件代码中国罔书馆分类法第五版13 术语和定义下列术语和定义适用于本文件。3.1 公共图书馆联盟publ ic I ibrary consortium 县、区及其以上级公共图书馆形成的联盟。3.2 成员馆member I i brary 注册成为图书馆联盟正式成员的图书馆。3.3 总分馆central-branch I ibrary 在一个总馆下设立若干分馆实行一元化垂直管理体系和网状结构模式
5、。DB34/T 2837-2017 3.4 机器可i卖目录machine readable catalog,MARC 以代码形式和特定结构记录在计算机存储载休上的、可供计算机识别与阅读的目录。3.5 本体数据ontology data 由MARC描述的日标数据。3.6 发现级别expose level 阅读资源在文献编口级别的对外暴露程度。3.7 可用级另available level 最终读者现软件获得木体数据的能力程度。3.8 q1/:割harvest根据发现级别,联盟或成员馆以下载的形式获得其他成员馆文献编目的过程。3.9 揭示reveal 将MARC数据以可视化的形式向用户早现、表示的
6、过程。3.10 馆藏reserves 图书馆收集的各种类型文献资料的总和。3.11 流通circulation 罔书或其他资源进山罔节馆的过程。3.12 数据元素data element 用一组属性描述定义、柿、识、表示和允许值的数据单元,它是图书馆业务自动化系统问数据接口所输入和输出数据的不J分割的某本单No2 DB34/T 2837-2017 3.13 活动activity 活功是对罔书馆举办的线上和线下聚会的泛称。4 数据元素的描述格式数据兀素的描述格式如下:a)标识符:数据兀素的内部唯一标识,由于母与数字组合形成:b)名称:数据兀素的中文名称:c)说明:数据兀京内容的描述与解释:d)表
7、示格式:数据兀京值的类型及长度的表示形式,具休形式见表1;e)备注:与该数据兀素相关的其他说明,包括数据兀素的取值范围、遵循的标准规范要求等。表1数据元素的表示格式于符含义说明表示数据类型J,j字符型用C)言自接力11自然数的方式表示定长,如C4表示4个于衍定C 长(个i父子相当于内个Byte)。N 表示数据类型为数值型N后直接力11白然数的万式表示定长,N3表示3位数y定长。用D后力114、6、8等,分别兰兰示不同数据恪式的日期型数据元。D4表示YYYY即只表示到午份:D 表示数据类型为H期型和H期时间型D6表示YYYY-MM即表示到月份;D8表示YYYY-MM-DD即表示到日。遵循GB/T
8、7408数据和交换恪式信息交换日朗和时间表示法。用T后加2、4、6分别表不不同数据格式的时间型数据儿。T2表不hhIJ只表不小时:T 表示数据类型为时间型T4表示hh:mm即表示到分钟:T6表示hh:mm:ss即表示到秒。注意,本部分为21小时制。表示口期时间型n代表t、6、8,m代表2、七60DnTm 例如D8T6,表示YYYY-MM-DD hh:mm:s s BL 表示数据类型J,j布尔型BN 农刁可数据类型为进制型在数据格式中应标识出-进制的具体格式,如JPEG。N表示字段的最小长度,M表不手段如C.6表示最多6个字符:N.M 最大长度CNlrJ以省去,表示IrJ以是空申,M不l川省去)
9、N2.7表不最少2位数字最多7位数字N.p,q(p、q表不数扣类型为数值型,最长p守,均代表一个如N.8,2表示最多8位数宁,小数点后2位小数点后q守(小数点前为p-q市)自然数)注:在系统建设巾遇到数据格式为时建议按最大值使用5 数据与接口3 DB34/T 2837-2017 5.1 认证定义Stringauthenticate(String jsonStr);描述:成员m登录认证。参数说明:遵循JSON恪式申要求,数据)G素描述见表20拍、识付名称loginnarne 用户名passVord U令参数jsonStr示例:loginname:u口ame,password:pwd 表2认证接口
10、参数表说明表示格式用户it址c.30 SHA处理过的口令c.60 串。返回值说明:遵循JSON恪式串要求,数据)G素描述见表30表3认证接口返回值表标识衍state statedesc 返回值示例:state:0,名称执行状态状态描述statedesc:执行成功P说明指忌功能的执行状态执行结果的详细描述5.2 成员馆注册与注销5.2.1 注册定义Stringenroll(String jsonStr);描述:成员馆注册。参数说明:遵循JSON格式串要求,数据元素描述见表40表4成员馆基本信息表标识拍名称说明表示格式1 i brarycode 成员自编码成员蚀唯一标识符c.20 libraryn
11、arne 成员饨名称成员饲巾文名1可C.100 loginnarne 用户名用户凭证c.30 4 备注在成员馆中此凭证需要满足唯一tl要求通讯端何证用户口令经过SHA512处理。表示格式N1 C.100 参见附录A.19 备注取f直范围见附录A.5 备注图书馆对外公示的名称在成员时巾此凭证满足唯一性要求DB34/T 2837-2017 标识衍名称password 11令1 i braryaddr 成lIH自地址1ibrarycity 所在城市libraryprovince 所在省份巳nrolldate注册日期unenrolldate 注销日期参数jsonStr示例:NlibrarycodeN:
12、N成员馆编码NlibrarynameN:N成员馆名称NloginnameN:N登录名N pas swordN:N W令气Nlibraryaddr:N成员馆地址NlibrarycityN:N所在城市气NlibraryprovinceN:N所在省份NenrolldateN:N注册日期NunenrolldateN:斗士销日期H表4(续)说明SHA处理过的11令申通讯地址城市全称省份全称注册发生日注销发生日返回值说明:参见5.1认证接口的返回值说明C返回值示例:参见5.1认i正接口的返回值示例。5.2.2 注销定义Stringunenroll(String jsonStr);表示格式备注c.60 用户
13、11令经过SHA512处理c.100 c.50 C.100 D8 非生效日D8 注销日即为生效日描述:成员馆注俏,注销后即表示退出联盟,不再字有联盟所提供的各项功能及服务。参数说明:遵循SON格式串要求,数据兀素描述见表50表5注销接口参数表标识符名称说明衣不格式备注用户名用户凭证在成员馆中此凭证需要满足10ginname password U令1ibrarvcode 成员馆编码参数jsonStr示例:NloginnameN:NunameN,passwordN:NpwdN,NlibrarycodeN 形成员馆编码c.30 唯i生要求SHA处现过的U令申。通讯端保证用),口令经过c.60 SHA
14、 512处理。要注销的成员馆编码C.20 参见附录A.19 5 DB34/T 2837-2017 返回值说明:参见5.1认证接口的返回值说明C返回值习、例:参见5.1认证接口的返回值在例C5.3 总分馆资源数据5.3.1 资源接口数据资源接口数据包括CNMARC描述的资源和数字资源厂商系统描述的元数据资源,具体描述见表60表6资源接口数据描述表标识符名称说明表示格式备注lG录外部资源的标识符,与成1did 资源描述ID员馆、收割米源一起组成组合C.30 分馆各自系统的控制号H佳索。|1 i b1a1vcode 成员馆编码成员馆唯标识符c.20 参见附录A.19 义;献编目代问自动化系统为书目条
15、目生成catalogcode C.50 的唯标识符se11巳snarne丛I名丛I名C.100 可选题名书名、杂志名等若;址MARCIt:I,则取F200atitle c.100 手段的值isbn或lSS口号图I同际统一编码若是MARC书厅,则取F010aisocode C.100 字段的值出版社若是MARC书日,则取F210cpublishe1 C.150 字段的值出版日期若是MARC书日,则取F210dpublishdate D4 字段的值著者作者,节的或者文章的作者若是MARC书日,则取F200fauthor c.300 字段的值autho1rnodifie1 若有类型书的作者,杂志的编
16、者等C.20 取值范|韦|见附录A.12 对J杂志米说,挝供杂志目abst1act 摘要内容挝耍C.200 录:对J书籍则挝供内容挝要主题词主题词,关键字,可以是句于:topic C.200 均以逗号隔开封面图片一个引用地址,小保存封面数I(J边,接11实现者若提供木111cove1pictu1e c.100 据本身须为有效URL地址。I(J边,对于报刊、杂志须提供publishingperiod 出版周期期刊,杂志的出版周期N.4 本值,单位是天;对于节期刊,该值设青为O对于纸本,按照实际馆P藏数量藏量成员馆中总藏量赋值,多卷数旦旦去民本资源,此1es巳1vescop1e1N.2 值为0,具
17、体值可入表13,对于数于资源,取值为16 DB34/T 2837-2017 表6(续)标识衍名称说明表示格式备注IrJ以是厂商协j址信息:也IrJ以是成员馅标识拍成厂收刮来源标识本条资源L&剖白哪个数商的标识,主11superstar(超harvestsource c.100 字资源厂商坦克成员馆星),bookan(博看)寺,IrJ 由收剖接U实现提供者自行定义如果发现级别为2,本链口l用于获得源义献口录所描述的sourceurl 源URL资源链接c.512 明细信息:如果使用级别为2,本链将口l用于直接下载本休数据。收剖来源的书目数自动化系统中,编目阶段对罔origindate 据创建(变更
18、)口书进行书目编目时所创建(变D8 期更)的书目数据的当天日期。收害IJ日期收割到检索库或索引库的Uharvestdate D8 期exposelevel 发现级圳N1 l仅f血范围从L附录A.1 l仅值也罔:availablelevel 使用级别N1 1代表内部元伞可肘,2代表对外元伞可用searchtype 数据检索类型N1 取值范围见附录A.3 mediatype 媒体类刑N1 取值范围见附录A.6 资源丰各式pdf,html,txt,avi,mp4,wmv fileformat c.50 等等:标水资源类刑书籍、期刊、学位论文(学位)、艺术类型电影、山视剧、棕艺、动漫、例如:动漫、新闻
19、、电影等等arttype C.50 直播、新问、娱乐、休育、游戏、短视频location 地域大陆、香港、美国等c.50 备注若资源本休不可以获得,则在remark c.500 此提供咨询信息等等备用Api实现有,可根据情况史时数据形式,采!+Jj son数组形altfieldO c.4000;卒于段传边额外信息工飞。备用Api*圳右,可根据情况使时数据形式,采时json对象形altfieldl c.4000;卒于段传边额外信息工飞。5.3.2 活动接口数据活动资源数据描述见表707 DB34/T 2837-2017 表7活动资源数据描述表标识符名称说明表示将式备注id 活动标识内部标识N16
20、 code 活动编码各t自系统内的活动标识c.30 ti tle 活动名称C.100 abstracts;市动简介摘要C.300;I;z丑J类型例如培训11、讲座、电影播放、创客珩types C.40 动等采纳馆方系统中对等的数据,是指i币;r;.t;占关键字动所涉及主题的分类词,例如饮食、销;力可白行;义keywords C.40 茶道、解读、人物、教育、少儿等等,允|有多个关键子,以逗号隔开。url 宣传地址宣传罔片或视顿的地址c.80 address 活动举办地邮政的地址C.100 startdate 活动举办日D8 活动持续日天为单位,IrJ以是小数,如O.5代continuenum
21、N2 表半天enddate 活三J结束UD8 periodnum 活动周期性O代表1次,其余数字代表周期,N2 例如7代表每隔7天进行一次;占z:.)状态如期举行:捉前驭消如期举行为1,status Nl 提前取消为2librarycode 活动所属单价指各级罔节馆,包括乡镇文化站等C.20 参见附录A.19;r;动流动性固立场所,巡i寅如卡乡;r;动哇哇1为固定场所,portable C.40 2为巡演。contactman 活动联系人接U人C.40 contactpho日e活动联系人山讯C.20 sponsor 活动主办方C.40 sponsorphone 主办力联系电话C.20 orga
22、nlzer;r;民J承办为C.40 organizerphone 承办;力联系电话c.20 partingnum 参加人数N6 partednum 实际参加|人数N6 commentsnum 评论量N10 备时Api实现者,lrJ根据情况使用本字段数据形式,采用jsonaltfieldO C.4000 传递额外信息数组形式。各国Api实现者,lrJ根据情况使用本字段数据形式,采用jsonaltfield1 c.4000 传递额外信息对象形式。5.3.3 收割活动接口定义StringharvestActivityMetaDesc(String jsonStr);8 DB34/T 2837-201
23、7 描述:获取成员馆n活动元数据信息,提供本接口功能的系统需要打行否重处理。参数说明:遵循SON格式串要求,数据元素描述见表80表8收割活动接口参数表标识符名称fromdate 汀始U期page口um页弓pageslZe 页尺寸参数jsonStr示例:fromdate:2011-02-17 pagenum:1,pagesize:20 说明收剖)1始U期返回值说明:遵循SON格式串要求,数据元素描述参见表70返回值示例:/state:0,/statedesc:执行成功list:/idN:/活动标识气C(丁deFF:活动编码气title:活动标题abstracts:活动简介气types:活动类刑k
24、eywords:活动关键字url/:/宣传地址address:/活动举办地startdate:/活动举办H气continuenum:活动持续归,飞nddate:/活动结束H 气periodnum:7,/status:1,librarycode:活动所属单位portable:活动流功性/contactman:活动联系人contactphone:活动联系人电话/sponsor:活动主办方sponsorphone:主办力联系电话/organi zer:活动承办方彤,organizerphone:勺共办方联系电话农示格式备注D8 N.9 默认值为1N.9 默认值为209 DB34/T 2837-201
25、7 Y partingnum:1268,parted口um:986,/commentsnum:1984 5.3.4 收割资源总数接口定义StringharvestMetaDescTotal(String jsonStr);描述:获取成员馆待欠剖资源的文献编日总数。参数说明:遵循SON格式吊要求,数据兀京描述见表90表9收割资源、总数接口参数表标识符名称fromdate 开始U期1ibrarvcode 成员馆编码harvestsource 收割来源参数jsonStr示例:librarycode:3725022005156000,harvestsource:chaoxing气fromdate:20
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB34T 2837-2017 公共图书馆 总分馆 数据接口规范 DB34 2837 2017 分馆 数据 接口 规范
1、咨信平台为文档C2C交易模式,即用户上传的文档直接被用户下载,收益归上传人(含作者)所有;本站仅是提供信息存储空间和展示预览,仅对用户上传内容的表现方式做保护处理,对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿,我们不确定上传用户享有完全著作权,根据《信息网络传播权保护条例》,如果侵犯了您的版权、权益或隐私,请联系我们,核实后会尽快下架及时删除,并可随时和客服了解处理情况,尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确),网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据,平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺,下载前须认真查看,确认无误后再购买,务必慎重购买;若有违法违纪将进行移交司法处理,若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传,付费前请自行鉴别,如您付费,意味着您已接受本站规则且自行承担风险,本站不进行额外附加服务,虚拟产品一经售出概不退款(未进行购买下载可退充值款),文档一经付费(服务费)、不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印,是因预览和防盗链等技术需要对页面进行转换压缩成图而已,我们并不对上传的文档进行任何编辑或修改,文档下载后都不会有水印标识(原文档上传前个别存留的除外),下载后原文更清晰;试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓;PPT和DOC文档可被视为“模板”,允许上传人保留章节、目录结构的情况下删减部份的内容;PDF文档不管是原文档转换或图片扫描而得,本站不作要求视为允许,下载前自行私信或留言给上传者【曲****】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用;网站提供的党政主题相关内容(国旗、国徽、党徽--等)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。
6、文档遇到问题,请及时私信或留言给本站上传会员【曲****】,需本站解决可联系【 微信客服】、【 QQ客服】,若有其他问题请点击或扫码反馈【 服务填表】;文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“【 版权申诉】”(推荐),意见反馈和侵权处理邮箱:1219186828@qq.com;也可以拔打客服电话:4008-655-100;投诉/维权电话:4009-655-100。