DigitalPlatform
commented
5 months ago Borrow
action动作，有两个值borrow和renew（续借）
改进点： 增加一个 readerRefID 元素，内容为读者记录的参考 ID。 增加了一个 itemRefID 元素，内容为册记录的参考 ID。
<root>
<libraryCode></libraryCode> 馆代码
<operation>borrow</operation> 操作类型
<action>borrow/renew</action> 动作 borrow/renew
<readerBarcode>R0000002</readerBarcode> 读者证条码号
<readerRefID>...</readerRefID> 读者参考 ID
<itemBarcode>0000001</itemBarcode> 册条码号
<itemRefID>...</itemRefID> 册参考 ID
<borrowDate>Fri, 08 Dec 2006 04:17:31 GMT</borrowDate> 借阅日期。RFC1123 格式
<borrowPeriod>30day</borrowPeriod> 借阅期限
<returningDate>Wed, 20 Mar 2024 12:00:00 +0800</returningDate> 还书日期。RFC1123格式
<type>普通</type> 册类型
<price>CNY16.80</price> 册价格
<no>0</no> 续借次数。0为首次普通借阅，1开始为续借
<lastReturningDate>Wed, 20 Mar 2024 12:00:00 +0800</lastReturningDate> 当续借次数>0时，此字段表示续借前的应还日期
<operator>test</operator> 操作者
<operTime>Fri, 08 Dec 2006 04:17:31 GMT</operTime> 操作时间。RFC 1123 格式
<borrowID>78f9df8a-6019-4452-be44-d2c7741e6c78</borrowID> 借书id，待进一步说明此字段功能
<confirmItemRecPath>...</confirmItemRecPath> 辅助判断用的册记录路径
<readerRecord recPath='...'>...</readerRecord> 最新读者记录，里面的内容是转义过的。
<itemRecord recPath='...'>...</itemRecord> 最新册记录，里面的内容是转义过的。
<clientAddress via="net.pipe://localhost/dp2library/xe">localhost</clientAddress> 前端地址
<version>1.10</version> 日志版本
<time start="2024-02-18T11:25:39" end="2024-02-18T11:25:40" seconds="0.070" /> 使用时长
<uid>a181295f-c6ea-45e3-be6f-6a5db1e0c6d8</uid> 日志id
</root>注: 1) confirmItemRecPath 元素里面是前端认为的，可以在册条码号发生重复的情况下辅助程序进行取舍的一个册记录路径。如果册条码号检索发现并没有遇到重复现象，这个路径就根本用不上。而且，即便发生了重复，也有可能这个路径并不和重复的记录的任何一个路径相同。不得不说这个路径给出相当随意，日志记录中这个元素仅仅是把它记载下来，建议服务器处理的时候，如果可能直接看 itemRecord 元素的 recPath 属性，这个路径更靠谱。
详细样例
借书日志示例
<root>
<libraryCode>
</libraryCode>
<operation>borrow</operation>
<action>borrow</action>
<readerBarcode>P00001</readerBarcode>
<readerRefID>3c70aeea-e3e9-4d1b-82de-965b3bd7f65d</readerRefID>
<itemBarcode>DPB000003</itemBarcode>
<itemRefID>6487e028-9b79-4b8a-8bad-5e44777bcb63</itemRefID>
<borrowDate>Sun, 18 Feb 2024 11:25:40 +0800</borrowDate>
<borrowPeriod>31day</borrowPeriod>
<returningDate>Wed, 20 Mar 2024 12:00:00 +0800</returningDate>
<type>普通</type>
<price>CNY16.80</price>
<no>0</no>
<operator>supervisor</operator>
<operTime>Sun, 18 Feb 2024 11:25:40 +0800</operTime>
<borrowID>78f9df8a-6019-4452-be44-d2c7741e6c78</borrowID>
<readerRecord recPath="读者/1">...</readerRecord>
<itemRecord recPath="中文图书实体/12">...</itemRecord>
<clientAddress via="net.pipe://localhost/dp2library/xe">localhost</clientAddress>
<version>1.10</version>
<time start="2024-02-18T11:25:39" end="2024-02-18T11:25:40" seconds="0.070" />
<uid>a181295f-c6ea-45e3-be6f-6a5db1e0c6d8</uid>
</root>readerRecord表示读者信息，内容样例如下：看到borrow元素中，增加了refID属性
<?xml version="1.0" encoding="utf-8"?>
<root>
<barcode>P001</barcode>
<readerType>本科生</readerType>
<name>任1</name>
<department>24级1班</department>
<refID>9131f365-772d-4ce1-b6ae-334380d41a21</refID>
<libraryCode>
</libraryCode>
<password type="bcrypt">$2a$11$a73g23qT2ApEeJ6qLmEXMO8SY1qe9AzcwtwWWTgIvy1uzFEMQKbb.</password>
<operations>
<operation name="create" operator="supervisor" time="Mon, 20 May 2024 10:11:20 +0800" />
</operations>
<reservations />
<borrows>
<borrow barcode="B001" refID="94623e97-65e2-470e-b55e-160f0ce178a4" oi="" recPath="ryh测试库实体/1" biblioRecPath="ryh测试库/1" location="流通库" borrowDate="Tue, 21 May 2024 16:06:00 +0800" borrowPeriod="31day" borrowID="d7bdf7c3-460f-4150-b911-5e0c563332ad" returningDate="Fri, 21 Jun 2024 12:00:00 +0800" operator="supervisor" type="普通" price="CNY19.00" />
</borrows>
</root>itemRecord 表示册信息，内容样例如下：看到borrow元素的内容是@refID:xxx形态
<?xml version="1.0" encoding="utf-8"?>
<root>
<parent>1</parent>
<location>流通库</location>
<bookType>普通</bookType>
<batchNo>20240307验收2</batchNo>
<price>CNY19.00</price>
<accessNo>B848.4/K433</accessNo>
<barcode>B001</barcode>
<refID>94623e97-65e2-470e-b55e-160f0ce178a4</refID>
<operations>
<operation name="create" time="Wed, 27 Mar 2024 11:21:33 +0800" operator="supervisor" />
</operations>
<borrower>@refID:9131f365-772d-4ce1-b6ae-334380d41a21</borrower>
<borrowerReaderType>本科生</borrowerReaderType>
<borrowerRecPath>ryh读者/1</borrowerRecPath>
<borrowDate>Tue, 21 May 2024 16:06:00 +0800</borrowDate>
<borrowID>d7bdf7c3-460f-4150-b911-5e0c563332ad</borrowID>
<checkInOutDate>Tue, 21 May 2024 16:06:00 +0800</checkInOutDate>
<borrowPeriod>31day</borrowPeriod>
<returningDate>Fri, 21 Jun 2024 12:00:00 +0800</returningDate>
<operator>supervisor</operator>
</root>续借日志示例
<operation>borrow</operation>
<action>renew</action>
<returningDate>Thu, 18 Apr 2024 12:00:00 +0800</returningDate> 续借后的最新应还日期
<no>1</no> 续借次数
<lastReturningDate>Wed, 20 Mar 2024 12:00:00 +0800</lastReturningDate> 续借前的应还日期
renyh
本文介绍 dp2library 中各类型操作日志记录的 XML 格式。