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

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 总分馆馆藏数据.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俊松、步翠兰、刘树峰、王建涛、李永钢、智淑英、吴锦、郑利平、林泽明、汪f正。II DB34/T 2837-2017 公共图书馆总分馆数据接口规范1 范围本标准规定了图书馆业务信息化系统之间的数据接口规范。本标准适用于公共图书馆、高校图书馆和数宁资源提供商，也可适用于图书馆行业信息资源交换体系的设计与建设。2 规范性引用文件下列文件对于本文件的同用是必不可少的。)也是注山期的习|用文件，仅所注U期的版本适用于本文件。凡是不注且期的引用文件，其最新版本(包括所有的修改单)适用于本文件。GB/T 2260 中华人民共和国行政F划代码GB/T 2659lli:界各国和地区名称代码GB/T 3304 中国各民族名称的罗马字母拼写法和代码GB/T 4658 午?历代码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 在一个总馆下设立若干分馆实行一元化垂直管理体系和网状结构模式。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数据以可视化的形式向用户早现、表示的过程。3.10 馆藏reserves 图书馆收集的各种类型文献资料的总和。3.11 流通circulation 罔书或其他资源进山罔节馆的过程。3.12 数据元素data element 用一组属性描述定义、柿、识、表示和允许值的数据单元，它是图书馆业务自动化系统问数据接口所输入和输出数据的不J分割的某本单No2 DB34/T 2837-2017 3.13 活动activity 活功是对罔书馆举办的线上和线下聚会的泛称。4 数据元素的描述格式数据兀素的描述格式如下:a)标识符:数据兀素的内部唯一标识，由于母与数字组合形成:b)名称:数据兀素的中文名称:c)说明:数据兀京内容的描述与解释:d)表示格式:数据兀京值的类型及长度的表示形式，具休形式见表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/T7408数据和交换恪式信息交换日朗和时间表示法。用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川省去)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认证接口参数表说明表示格式用户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 librarynarne 成员饨名称成员饲巾文名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: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 用户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 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 义;献编目代问自动化系统为书目条目生成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 若有类型书的作者，杂志的编者等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，具体值可入表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 据创建(变更)口书进行书目编目时所创建(变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 等等:标水资源类刑书籍、期刊、学位论文(学位)、艺术类型电影、山视剧、棕艺、动漫、例如:动漫、新闻、电影等等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 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 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 organlzer;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-2017 描述:获取成员馆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:活动类刑keywords:活动关键字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-2017 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:2015-12-25 说明收剖开始U期成员馆唯一标识符数y资源提供商的编码返|值说明:遵循SON格式串要求，数据元素描述见表10。表示格式D8 c.20 表10收割资源总数接口返回值表标识符名称说明state 执行状态指示功能的执行状态statedesc 状态拍述执行结果的详细拍述fromdate 开始日期收剖开始日期1ibrarvcode 成员馆编码成员馆H住标识符harvestsource 收剖来源数宁资源提供商的编问tota1 总条数才肯定时间范围内立献编目总数;返回值示例:state:0,statedesc:执行成功气librarycode:3725022005156000,harvestsource:chaoxing气fromdate:2011-02-17 10 表示格式N1 C.100 D8 C.20 C.20 N.9 备注参见附录A.19取值、范围见附录A.20备注取值范阳|见附录A.5 参见附录A.19取值范围见附录A.20 Fromdate参数缺省时，返问所有文献编日数量DB34/T 2837-2017/total:289 5.3.5 收割文献编目接口定义StringharvestMetaDesc(String jsonStr);描述:获取成员m待收割资源的文献编目信息，一般包括数字资源的部分兀数据及纸质节目的部分MARC数据;若成员馆某条文献口录发生了变更，需要本地予以标记，以供下次收割。参数说明:单循SON格式申要求，数据兀素描述见表110表11收割文献编目接口参数表标识符名称说明librarvcode 成员馆编码成员馆啡一标识符harvestsource 收割来源数宁资源提供商的编码frorndate 开始U期pagenurn Y工4工仁勺3 pageslZe 页尺寸参数jsonStr示例:librarycode:3725022005156000,harvestsource:chaoxing,fromdate:2011-02-17,pagenum:1,pagesize:20 收剖开始U期返|值脱明:遵循SON格式串要求，数据元素描述参见表60返|值示例:state:0,statedesc:执行成功气list:librarycode:3725022005156000气harvestsource:chaoxing,catalogcode:432423334,元现7元，serlesname bookname:稻茬冬小麦不同播种左式和播种量试验研究气/i socode/:1111,publisher:北京地矿山版社publishdate:2009-01,author:王红磊authormodifier:作者厅，abstract:稻茬冬小麦不同播种方式和播种量试验研究表示格式备注C.20 参见附录A.19C.20 取值范围见附录/.20D8 N.9 默认值为1N.9 默认值为2011 DB34/T 2837-2017 nu 吁中VA ru VA HU可一一u nu a M川e-i.-i hr 且也一JU.1i pu pu r 门f-X RV n、da-.-i a 十Le-u/J/,1i-i a 牛Le Eq/D广Dnb n LUH/,/J DQdp 门ynUQuhr IJ n凹LMH-i二白eO Qdd0 908 尸七口。口EDu门。QURuqdunq 口b1i且也q白町i1i丑-qd一-ioua1i1i民U-O白口dwhuounuq中q中-1i/qI-nu。Uh/T14-o5H z511122j山dpPAnnul-7fpph4 OPJvtLZOPP23dpzp斗囚士一门仨kptDPZrlllnpz11灵/ehhr-me-e、vELee、CNJ-NV2办一/、J妾prJ1rceplep-ep写PFT中，gurh、UN二teoelepJutNf-2、口t刁oleatevepeoa-PN21CPErmdaselypcmpn也啊-tuatdelbtyyreop SPANSPUNS口veahtrop-KER-rceCLue-rs1icaanIytr1布刷le-vrDvgeOir-retaa川一、bvpru&rispaadbltcmuvtuooaooarexvee-1ro已pcthslhoreasmlfalru 彤彤彤彤彤口PPMHMHMHMHMHMHMHMHMHMHIJIJ民u1li Qund-ti 11Fhu 定义Stringsearch(String jsonStr);描述:在收割的资源库检索市要的文献编目，在检索参数巾，必须至少按照附录A.3巾所列要求提供分类检索，能够按照中国图书馆分类法提供分类检索，返回数据符合数据规格要求，参见5.3.5 收刮文献编目的相关规定。参数说明:遵循SON格式中要求，数据元素描述见表120表12资源检索接口参数表标识衍名称说明表示格式备注searchtype 检索类型N.2 L仅值范围从L附录A.3，默认值为Osearchrange 检索范围N.2 L仅f直范围见附录A.4，默认值为1classes 巾国图书饨分类法c.20 缺省表;豆忽略pagenum 页号N.9 默认值为1pageslze 页尺寸N.9 默认值为20注:除以上所列参数外，也可征意j在取农6文献纺目信息求中的征意于段作为检索参数，可由接口实现者自由提供实现，但为了提供更加|实用的功能，推荐选用更多于段作为检索关键宁或组介。参数jsonStr示例:/searchtype/:0,/searchrange/:1,12/classes:/Al/,/pagenum/:1,pagesize:20 返回值说明:遵循JSON格式申要求，数据兀素描述参见表50返回值示例:/sta te/:0,/statedesc/:/执行成功/searchtype/:0,/searchrange/:1,元classes:/Al/，/pagenum/:1,元pagesize/:20 list/:元catalogcode/:/432423334气元serlesname/bookname/:/稻茬冬小麦不同播种方式和播种量试验研究/i socode/:彤彤，/publisher/:/北京地布出版杜厅，/publishdate/:/2009-01/,/author/:/十红磊/authormodifier/:/作者厅，/abstract/:/1西非冬小麦不同播种方式和播种量试验研究气/publishingperiod/:15,coverpicture/:/,/topic/:/冬小麦厅，/harvestsource/:/zhiwang/,DB34/T 2837-2017/sourceurl/:/http:/51.190.99.10:9995/kns55/detail/detail.aspx?recid二&FileName二QXKX20l1S1010&DbName二CJFDLAST2013&DbCode二CJFQ/，/harvestdateN:/2014-08-23/,origindateN:N2011-02-17N,NreservescopierN:lO,NexposelevelN:l,NavailablelevelN:2,searchtypeN:2,N mediatypeN:2,NlibrarycodeN:N3725021989124000气NremarkN产各注信息 13 DB34/T 2837-2017 5.4 总分tEt自藏数据5.4.1 馆藏接口数据馆藏数据的描述见表130标识符名称id 内部标识librarvcode 成员馆编码catalogcode 文献编目代码isocode isbn或issn号bookname 书名appenddate 添加U期copler 藏量barcode 图书条同号indexnumber 索书号roomlocation t自喊地)，holdlocation 排架位官libstatus 馆藏状态altfieldO 备用a1tfield1 备用5.4.2 馆藏接口表13馆藏数据描述表说明成员馆唯一标识衍臼动化系统为书目条口生成的唯一标识符图书国际统一编码书名、杂志名(报纸/杂志)采访入戚的U期依据表6中publishingperiod的取值情况米确定为本f直是复今;数或卷数。tR内藏书的唯标识符例如，第一|到览室女11B-8等Api实现者，可根据情况使用木字段传递额外信息Api实现者，可根据情况使用木字段传递额外信息定义StringfetchCo11ections(String jsonStr);描述:获取指定书日的成员馆馆藏描述明细信息。参数说明:遵循SON格式串要求，数据元素描述见表14。表14馆藏接口参数表标识符名称凶明librarvcode 成员馆主的问成员馆唯标识符catalogcode 文献古时J目代问pagenum 页弓pageslZe 页尺寸参数jsonStr示例:14 求示格式备注N12 C.20 参见附录A.19C.50 C.100 C.100 D8T5 若是MARC书目，则C.100 取F905b或F905c字段的值c.50 若是MARC书日，则C.100 取F905a的值C.50 C.50 N.2 取直范围见附录A.2 数据形式，采用jsonC.4000 数细形式。数据形式，采用jsonC.4000 对象形式。表示格式备注C.20 参见附录:A.19C.50 N.9 默认值为1N.9 默认值为20Hlibrarycode H:H3725021568124000H,HcatalogcodeH:H20110877气/pagenumH:1,HpagesizeH:20 返回值说明:遵循SON格式申要求，数据兀主抽述见表13及表1.50表15t;藏接口返回值表标识符名称说明state 执行状态指示功能的执行状态statedesc 状态拍述执行纣果的详细描述操作执行的本地服务吉普performdate 执行H期返回值示例:H stateH:0,HstatedescH:H描述HperformdateH:H2012-03-05 55:54:34H,HdataH:HcatalogcodeH:H20110217003H,HlibrarycodeH:H3725022013254000气H pagenumH:1,pagesizeH:10,HpagedataH:(HisocodeH:Hisb口气HbooknameH:H书名HcopierH:H副本数气HvolumesH:H卷数HbarcodeH:/图书条码口气HindexnumberH:H图书条码号气HroomlocationH:H.1藏地点气HholdlocationH:H架位置气HlibstatusH:H馆藏状态 5.5 总分t盲流通统计5.5.1 流通接口数据流通数据的通用共性约定内容见表160U期时间农示格式N1 c.100 D8T6 DB34/T 2837-2017 备注取值范围见附录A.5 15 DB34/T 2837-2017 表16流通数据通用共性约定表标识符名称说明表示将式id 内部标识performdate 执行日期D8T6 读者标识接口用户臼行确定读者数据readercode c.20 的标主只手段barcode 条码号C.20 title 埋名书名、杂志名节C.100 ltcode 文献类，1川说明c.40 ownerlib 所属馆成员馆名称c.60 hlcode 馆藏地点成员馆的实际馆藏地点c.60 续借次数同一个读者注续续倍的故大reborrownum N.2 次数，超出即不可内111:f0 borrowtype 借出类型N1 fi日a口cetype财经类型超期罚款，污损罚款等N1 borrowdate 借阅U期D8 returndate 应还日期D8 realreturndate 实还日期D8 lsexplre 是否超期BL usercode 工作人民代码c.20 attachstatus 附件是有借出BL 备用Api实现者，口l根据情况使altfieldO c.4000 用本于段传递额外信息备山Api实现者，可根据情况使altfield1 c.4000 用木字段传递额外信息5.5.2 人次统计定义StringcircByReader(String jsonStr);描述:根据不同口径和维度统计人次。参数说明:遵循SON格式串要求，数据元素描述儿表170表17人次统计接口参数表标识符名称说明统计口径限定了所统计数据的范围，如日strange 月季年等的限定统计类型限定了所统计数据的内容，例如sttype 对于借入、还回、污损等16 备注推荐采用身份证弓对于数字资源，可以采时记录的id或编码若是MARCt;t:j，则取F200a字段的伯取伯范围见附录A.15 取值范围.l表元二首次借出，2表元二续借取值范围见附录A.13 例如光盘是台随书肯出数据形式，采用json数组形式。数据形式，采用json对象形式。表示格式备注N.2 取值范田m附录A.7 N.2 取值范田m附录A.9 DB34/T 2837-2017 表17(续)todate 名称)1始U期纣束U期说明统计期间的)1始U期统计期间的约束U期式一叫-m一回去一标识符备注fromdate 参数jsonStr示例:/strange/:1,/sttype/:1,/fromdate/:/2013-10-01/,/todate/:/2013-10-31/返回值说明:遵循SON格式串要求，数据元素描述见表180表18人次统计接口返回值表标识符名称说明表示格式各注state 执行状态指示功能的执行状态N1 垠值范围见附录11.5statedesc 状态描述执行结果的详细描述c.100 stdate 请求H期执行木功能的同期时间D8T6 strange 统计口径N.2 取值范旧见附录A.7 sttype 统计类型N.2 取值范围见附录11.9fromdate)1始U期统计期间的)1始U期D8 todate 约束U期统计期间的结束U期D8 year 年代自然年C.4 month 片份自然月C.2 week 周自然周c.1 date 大自然大c.3 stationname Tfr站业务办理的主机标识C.30 roomlocation 馆藏地点文献地点C.30 sumdata 扎总数据统计川i的流通人次N.8 备用Api 实现右，可根据情况使用本子数据形式，采山JsonaltfieldO c.4000 段传递额外信息数;组形式。备山Api实现者，lrJ根据情况使用木宁数据形式，采用Jsonaltfie1d1 C.4000 段传递额外信息对象形式。返回值示例:/sta te/:0,/sta tede sc/:形成功执行/stdate/:/2012-03-05 55:54:34/,/data/:/strange/:1,17 DB34/T 2837-2017/sttype:1,fromdate:2013-10-01,todate:2013-10-31,/pageda ta/:/year.1I年代month:/月份IIweek:1I用/date:天/stationname:丁楼人厅第4号气roomlocation:馆藏地点/sumdata:90234 5.5.3 流通册次统计定义StringcircByCollection(String jsonStr);描述:根据不同口径和维度统计流通册次。参数说明:遵幅SON格式串要求，数据元素描述见表190表19流通册;欠统计接口参数表标认1;jstrange sttype fromdate todate 参数jsonStr示例:strange:1,./sttype:1,名称统计口径统计类型开始日期结束H期fromdate:2013-10-01,todate:2013-10-31 说明表不格式N.2 N.2 统计期间的开始日期D8 统计期间的结束H期D8 返回值说明:遵循SON格式申要求，数据元素描述见表20。表20流通册次统计接口返回值表标识符名称说明农示恪式state 执行状态指示功能的执行状态N1 statedesc 状态描述执行结果的详细描述c.100 stdate 统计U期本统计的请求U期D8 strange 统计口径N.2 18 备注取值范田见附录A.8 取值范田1M附录A.10 备注取f直范围见附录A.5 取f直范围从L附录A.8 表20(续)标识衍名称说明sttype 统计类型fromdate)1始U期统计期间的)1始期todate 约束U期统计期间的约束期year 年代自然年month 月份自然月week 周自然用date 天自然天stationname 一仁fr站业务办理的主机标识roomlocation 馆藏地点文献地点classes 图书分类sumdata、汇总数据统计出的流通册次备用Api实现右，可根据情况使altfieldO 时本于段传j单额外信息备用Api实现者，可根据恬况1taltfield1 用本于段传递额外信息、返回值示例: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/./年代/mon th:/月份厅，/week/:/用/date/:/大stationname:3楼第4号roomlocation:馆藏地点，文献地点classes产分类sumdata:统计出的流通朋次 5.6 总分t盲流通操作DB34/T 2837-2017 表示格式备注N.2 l仅f血范围从L附录A.10 D8 D8 C.4 C.2 C.1 C.3 c.50 c.50 参见中国罔节B分类法C.100 http:/ 数据形式，采时json数组形c.4000 式。数据形式，采用json对象形C.1000 式。19 DB34/T 2837-2017 5.6.1 修改