DigitalPlatform
commented
5 months ago 读者记录
改进点:
1) borrows/borrow 元素中，增加了一个 refID 属性，值为册记录的参考 ID。原有的 barcode 属性依然有效，是册条码号
2) reservations/request 元素的 arrivedItemBarcode 属性，内容可能是册条码号，现在也可能是 @refID:xxx 形态
3) reservations/request 元素的 items 属性，内容可能是册条码号列表，现在也可能是 @refID:xxx 形态的列表
4) outofReservations/request 元素的 itemBarcode 属性，内容原来是册条码号，现在还可能是 @refID:xxx 形态
5) overdues/overdue 元素中，增加了一个 refID 属性，值为册记录的参考 ID。原有的 barcode 属性依然有效，是册条码号
册记录
改进点:
1) borrower 元素的内容，目前改为写入 @refID:xxxx 形态。以前的 证条码号形态 依然有效，注意使用的时候对两种可能性加以判断
2) Reservation() API 中，预约时对册记录的 reservations/request/@reader 属性中写入的可能是证条码号或 @refID:xxx 形态
预约队列记录
改进点: 1) 增加了一个 patronRefID 元素，内容为读者记录的参考 ID。原有 readerBarcode 元素依然有效 (注: 其实 2016 年开始预约队列库的 keys 配置文件里面就为 patronRefID 元素添加了一个检索点，只是当时的程序代码里面还没有给预约队列记录主动写入这个元素)
违约金记录
改进点: 1) 增加 itemRefID 元素，内容为超期册的参考 ID。 2) 增加 readerRefID 元素，内容为读者参考 ID。 3) 违约金库 keys 模板里面为上述两个元素增加了检索点，名为“册参考ID”和“读者参考ID”。
出纳日志记录(mongodb)
改进点:
1) ItemBarcode 字段原来是存储册条码号。现在改为 @refID:xxx 形态。升级版本的时候，有个模块会自动把以前记录的全部此字段内容替换为新的形态。
2) PatronBarcode 字段原来是存储读者证条码号。现在改为 @refid:xxx 形态。升级版本的时候，有个模块会自动把以前记录的全部此字段内容替换为新的形态。
2024/5/22 发现写入mongodb的borrow的BorrowDate是一个默认值，说明如下： 这个 BorrowDate 字段的语义是“还书的时候，回顾当时借书的时间”，也就是说这个字段对借书动作不管用(属于多余的字段)，对还书动作才管用。借书动作要看借书时间，要看 OperTime 字段。(类似道理，还书动作要看还书时间，看 OperTime 字段。也就是说，并没有一个 ReturnDate 字段) 出现多余的字段，这是由数据行要整齐地放入同一个数据记录类引起的。假设如果不同动作的行放入不同的数据记录类，就不会有这个问题，比如负责定义借书动作的类就根本不提供这个 BorrowDate 字段就可以了。不过，这面这种假设的做法，成本太高一般不会考虑使用。
{
"_id": {
"$oid": "664d5385562b1ade073690cd"
},
"LibraryCode": "",
"Operation": "borrow",
"Action": "borrow",
"ItemBarcode": "@refID:94623e97-65e2-470e-b55e-160f0ce178a4",
"PatronBarcode": "@refID:9131f365-772d-4ce1-b6ae-334380d41a21",
"BiblioRecPath": null,
"Period": "31day",
"No": "0",
"Volume": null,
"ClientAddress": "localhost",
"Operator": "supervisor",
"OperTime": {
"$date": "2024-05-22T02:08:05.000Z"
},
"BorrowDate": {
"$date": {
"$numberLong": "-62135596800000"
}
}
}Borrow() API 操作日志记录
Return() API 操作日志记录
改进点: 1) 增加一个 readerRefID 元素，内容为读者记录的参考 ID。 2) 增加了一个 itemRefID 元素，内容为册记录的参考 ID。
Reservation() API 操作日志记录
改进点: 1) 增加了一个 itemRefIdList 元素。原有 itemBarcodeList 元素依然有效 2) 增加了一个 readerRefID 元素。原有 readerBarcode 元素依然有效
Amerce() API 操作日志记录
改进点: 1) 增加了一个 readerRefID 元素。原有 readerBarcode 元素依然有效
WriteRes() API 操作日志记录
改进点: 1) 增加了一个 record 元素和一个 oldRecord 元素(和其它类型的日志记录中的 record 和 oldRecord 元素用法相同)。分别表示新旧文本 XML 记录。适用于文本记录。如果使用了这两个元素，日志记录就不会有附件了。
renyh
一直以来 dp2library 中的借阅双链都是使用的读者证条码号和册条码号。由于允许存在没有册条码号的册记录，为了允许这部分册进行借还，双链中也允许用
@refID:xxx形态使用册记录的参考 ID。但不允许没有证条码号的读者记录。这样的缺点是，当读者记录修改了证条码号字段内容以后，或者册记录修改了册条码号字段内容以后，双链的关系就被破坏。若修改的同时要自动去修改双链中的连接字段内容，则寻找双链的连接字段的过程会比较复杂，难以实现。
现计划对双链进行改造，全面允许使用读者记录和册记录的参考 ID。并兼容以前的证条码号和册条码号用法。这样等系统运行一段时间以后，读者以前借阅的图书都被还回了，新产生的借阅信息链可以确保都是新的参考 ID 形态，这样等读者记录和册记录修改条码号字段以后，双链依然可以保持正确。
本 issue 将记载代码重构中涉及到的数据格式变动，给出测试建议。