dp2
dp2 copied to clipboard
DigitalPlatform
Integrated Library System / 图书馆集成系统
最新版 dp2ssl 增加了自动感知 dp2library 一端 library.xml 文件变化的功能，当感知到文件中 rfid 元素变化时，会触发一次读者记录和册记录的全量下载同步。这种感知是通过拉取 dp2library 操作日志实现的。 最新版 dp2library 为此增加了一种操作日志动作 configChanged。 测试要点： 1) dp2ssl 的配置画面应该有菜单可以手动触发读者记录或者册记录的全量下载同步。 2) dp2ssl 会把获得的 library.xml 文件中的 rfid 内容保存到本地 settings.xml 文件内，当从拉取的操作日志中得知 rfid 元素内容可能发生变化后，会用...
997 字段，里面存储了一个唯一性的查重键值。当任何书目记录保存的时候，都要先自动在服务器端产生这个 997 字段，然后对所有数据记录进行检索查重，不重的才让保存。这个新特性是配置了才启用的，默认是不启用，以兼容以前的不查重的效果。 这项查重机制一旦启用，就是必须保证新增 MARC 数据与已有数据不重复才可以保存，要求比较很严格了。这样可以有效改变目前大部分用户单位书目记录重复严重的局面。如果以前的记录已经发生重复了，它们必须要归并以后，只剩下一条才让修改，所以 dp2内务 也提供了一套对比修改记录的机制。 在导出 MARC 数据时，如果不需要含有 997 字段，可以在导出过程中过滤掉该字段。
# 0.01 版机构代码映射算法 dp2library 模块的 library.xml 文件中，rfid 元素负责配置册记录和读者记录如何映射到 OI (机构代码)。 dp2 系统内的册记录和读者记录中，并不直接存储机构代码，而是通过定义一套映射规则，将册记录和读者记录中的馆代码或者某些字段映射到机构代码。映射关系在 dp2library 模块的 library.xml 文件的 rfid/ownerInstitution 元素中配置定义。当 rfid/ownerInstitution 元素定义修改后，即便系统中的册记录和读者记录本身没有任何变化，这些记录所对应的机构代码也会发生变化，这一点要引起注意。 定义举例如下： ``` ``` (注：最新版也提供了一种改进后的匹配算法，以 ownerInstitution/@version 属性值为 "0.02" 表示新版本算法。若 ownerInstitution/@version 属性缺省、或者属性值为...
先安装 PostgreSQL 14 版。 安装页面 URL 在这里： https://www.enterprisedb.com/downloads/postgres-postgresql-downloads 选最新的 14 版 一般情况下，安装参数如下： ``` Installation Directory: C:\Program Files\PostgreSQL\14 Server Installation Directory: C:\Program Files\PostgreSQL\14 Data Directory: C:\Program Files\PostgreSQL\14\data Database Port: 5432 Database...
RFID使用指南
# 目录 ### 一、准备工作 ### 二、新书册登记写RFID标签流程 ### 三、已有图书增加RFID标签流程 ### 四、RFID借书、还书流程 ### 五、门禁识别 ### 六、RFID通用工具 ### 七、一台电脑连多个RFID读写器，同时工作
dp2library 最新版经过改造，允许同一个实例内的不同分馆之间互相借书。 值得关注的技术点如下： 1) 需要在流通借阅权限 XML 定义中，立足于图书所在的一个分馆，为来自另一些分馆的读者类型，定义各项权限。 注意，权限是定义在图书所在的分馆。从这个视角，读者是外来的，服从本分馆的管理。 原先借阅权限定义中的读者类型是这样的“普通读者"，而为外来读者增加的读者类型规定采用”西城分馆/普通读者“这样的形态。为简化定义，可以使用通配符，比如”西城分馆/*“代表西城分馆的所有读者类型都适用此项参数。 2) 借阅权限中的”可借总册数“，是有馆代码语境的。如果一个外来读者，他既借阅了他所在分馆的图书，又借阅了目标分馆的图书，那么这个”可借总册数“应该按照两类不同的图书册数分别计算。 3) 还书时要检查是否超期，超期测算要用到开馆日历。那么是用图书所在分馆的开馆日历么？如果读者是亲自还书到图书所在分馆，这是合理的。并且，读者还应当关注图书所在分馆是否开馆，如果是闭馆日可能还无法还书，所以牵涉到图书所在分馆的日历是有道理的。 但如果读者只是还书到自己所属的分馆呢？首先开馆日历和图书所在分馆可能不同，若按照图书所在分馆的日历来计算超期豁免期似乎不太合理。 综上所述，似乎应该是当时读者还书实际去到的那个分馆的日历。这样，还书 API 实际上还需要一个(除了读者证条码号和册条码号以外的)第三参数即”实际还书的分馆“。 4) 从属于分馆的馆员账户，需要根据馆际互借需求，自动在 GetReaderInfo() API 中临时扩大可见的分馆范围，这样允许馆员查看有互借关系的其它分馆的读者记录。内务快捷出纳窗扫入(其它分馆)读者证条码号的时候需要显示读者信息，需要这个能力。但并不是全面默认扩大这个馆员账户的分馆馆代码范围，只是和借还操作直接相关的部分临时放开这个范围。 需要一个从 library.xml 中流通借阅权限定义中抽取出相关馆代码(列表)的函数。 5) 从属于分馆的馆员账户，需要根据馆际互借需求，让 SearchReader() API 和...
SIP2消息测试
20220223 留言记录： 请求里面必须包含 AO 字段，只是个粗略的说法。如果仔细说起来，还包含“一个 AO 字段无法同时描述读者和册的两种不同机构”的情况。建议你们先熟悉一下这些情况，等后面 dp2library 进行馆际互借改造后，需要用用户单位可以听懂的语言给他们解释，敦促自助机厂家改进软件，以便可以在号码中使用 xxx.xxxx 形态，达到馆际互借和任意漂流的效果 就是说我们的 dp2capo 也允许这样请求：AO 字段内容为空，而在读者证条码号和册条码号两个字段内容里面使用 xxx.xxxx 形态达到传输机构代码的效果 目前 dp2library 还没有进行改造前，读者证条码号和册条码号字段内传输不同的机构代码，还无法成功执行。但其实字段这种用法已经准备好了，只等改造完成就可以成功执行了。就是说我们设计规划实际上是远远走在前头的，这样的好处是可以避免用户加工标签等环节出现适应不了改造后新情况、导致返工的问题 *** 2020/12/15 如果dp2installer不升级，调19接口，返回序列号错误，如下： >2020-12-15 09:30:57 send:1920201215 093057AOdp2Library|ABB001|AC|CH|AQ流通库 2020-12-15 09:30:57 recv:20020201215...
# 测试还书同时修改册的当前位置 ## 开发说明 SIP2服务器还书接口及后台使用的dp2libaray还书API，实现了还书同时修改册的当前位置的功能。 还书时册的当前位置可能来自3个地方，按优先顺序依次为：1）还书API传的当前位置；2）前端登录传的location；3）登录帐号配置的默认位置。 详细开发说明参考：https://github.com/DigitalPlatform/dp2/issues/937 **2022/3/2版本更新： 还书时更新位置，要求位置的值是合法的馆藏地，如果指定要用一个非法的值，前面要用?，即形态为`?xxx`** **2022/3/4版本更新：dp2library(xe)版本号 3.105.8097.22276，dp2Capo 版本: 1.37.8098.16894，还书消息AP输入非法值，还书成功，也把位置更新了，但警告标志位为Y，返回提示为还书成功，但拟写入的馆藏地不合法** ## 测试环境准备 安装dp2installer和dp2librarayxe最新测试版。 安装SIP2服务器。 dp2SIPClient最新版。 安装dp2installer最新正式版 ## 还书测试思路 分成三个前端来测，一种用SIP2前端，二是用内务前端（只能测登录location和帐号默认位置），三是用TestRestLibrary前端。 每个前端，先单纯地分别针对三种情况进行测试，达到效果后，再组合测试检查是否按照优先顺序处理的。 ## 还书测试大纲 2022/3/2 注：由于新版本在还书时会校验当前位置是否合法，?XXX形态表示放过，所以每个case要用三种形态的值分别测试： 1）?xxx，不校验，还书成功更新位置成功。再在内务编辑这条记录（随便改一点其它内容），应不校验，应保存成功。 2）~2022/3/2版本：非法的馆藏地，校验不合法，还书失败不会更新位置。~ **2022/3/4版本还书消息AP输入非法值，还书成功也更新了位置，但警告标志位为Y，返回提示为还书成功，但拟写入的馆藏地不合法。**...
# dp2-RFID工具箱 使用指南 dp2-RFID工具箱是用来脱机进行RFID加工的软件。根据RFID标签的应用，可以进行图书RFID标签加工，给读者记录关联ISO15693协议读者卡，加工层架标。 *********************************** ## 准备工作 1）需要一台RFID读写器（RFID读写器建议是USB接口的），RFID读写器与电脑连接。 2）电脑安装“dp2-RFID工具箱” ，测试版安装地址：http://dp2003.com/rfidtool/v1_dev/publish.htm 电脑的操作系统建议为正版windows10。 3）运行 “dp2-RFID工具箱”，先通过菜单“文件/设置”配置机构代码,如果不设置机构代码，将无法进行加工。如何设置机构代码请参见 https://github.com/DigitalPlatform/dp2/wiki/%E5%A6%82%E4%BD%95%E8%AE%BE%E7%BD%AE%E6%9C%BA%E6%9E%84%E4%BB%A3%E7%A0%81 ### 注： A. **dp2-RFID工具箱 不能与dp2-RFID中心 同时使用**。如果开启dp2-RFID工具箱 时dp2-RFID中心已经打开，会导致dp2-RFID工具箱 无法识别导读写器。因为这两个软件使用的是一个读写器。 B. **不设置机构代码将无法通过dp2-RFID工具箱进行加工**。机构代码表示这本书是属于哪个机构。在馆际互借时，自助设备会根据图书的机构代码判断是否符合馆际互借约定。在加工图书之前就配好机构代码，可以使后续所加工RFID标签中都具备机构代码信息，为以后的馆际互通打下基础。 *** ## 加工图书标签 加工图书标签，即给图书RFID标签里写入信息，包括册条码(PII)、机构代码(OI/AOI）、应用类别（TOU）为10表示流通馆藏、防盗标志（EAS）设置为“on”。 ### 操作步骤...