SZCND
commented
2 years ago 测试用例1.1 还书请求API字段传值（AP表示当前位置）
测试目的
还书请求API字段传值（AP表示当前位置），确保还书后检查册的currentLocation应为AP的值，同时检查操作日志中operator的location属性应一致。
操作步骤
- 打开dp2SIP2 Client，在“服务器参数”区域，选择“编码方式”为UTF-8，然后点击“连接1”，在最下方看到“连接SIP2服务器127.0.0.1成功...”。
- 在登录区域的“账户名”中输入：例如“zizhu1@T800”，“密码”“x”，点击“登录”，前端发送93消息，服务器返回94消息，右侧能看到详细信息。
- 在“基础操作”区域输入“图书册条码”B001，“读者证条码”P001。~在“当前位置AP”中输入“A”~，点击下方 “借书”，前端发送11消息，服务器返回12消息，右侧能看到详细信息。在“当前位置AP”中输入“A”，然后点击“还书”，前端发送09消息，服务器返回10消息，右侧能看到详细信息。
- 登录dp2内务对应的实例，在菜单命令，册窗/册条码号一栏输入“B001”，点击右侧“装载”，点击左上方“XML”，用鼠标滚轮滑到最下面，预期册的currentLocation应为“A”，实际为"A"。
- 打开命令菜单，功能/系统维护/日志窗，在“日志文件名”一栏的右侧点击“今天”，“日志文件名”中显示“20220301.log”，点击下方“装载日志记录”，在弹出窗口点击“确定”，找到刚才还的记录，左键点击，在右侧会有详细信息，点击右侧“XML”，预期operator的location为“A”，实际为
<operator location="A">zizhu1</operator>
测试结果
2022/03/06-1227-ryh dp2library正式版3.105.8098.39412 dp2Capo正式版1.38.8098.32803
1）还书消息AP输入非法值test，还书成功，且更新位置成功，返回消息的警告标志位为Y，返回提示为还书成功，但拟写入的馆藏地不合法。符合预期。
SIP2请求和返回消息
2022-03-06 11:54:47 send:09N20220306 11544620220306 115446APtest|AO|ABCN-110108-1-ABC.B001|AC|BIN
2022-03-06 11:54:47 recv:101YNY20220306 115447AOCN-110108-1-ABC|ABCN-110108-1-ABC.B001|AQ流通库|AJ剪面包的男孩小|CLsort bin|AA001|AF还书操作成功。拟写入册记录的当前位置值 'test' 不合法(根据馆藏地 locationTypes 定义)|AG还书操作成功。拟写入册记录的当前位置值 'test' 不合法(根据馆藏地 locationTypes 定义)|AY4AZA48E
册记录中<currentLocation>test</currentLocation>。
操作日志中<operator location="test">zizhu</operator>
2）使用?xxx，服务器不校验，警告标志位为N，返回提示还书成功，且册记录的currentLocation和操作日志中的operator元素的location属性都为AP输入的值。符合预期
2022-03-06 12:01:12 send:09N20220306 12011220220306 120112AP?abc|AO|ABCN-110108-1-ABC.B001|AC|BIN
2022-03-06 12:01:12 recv:101YNN20220306 120112AOCN-110108-1-ABC|ABCN-110108-1-ABC.B001|AQ流通库|AJ剪面包的男孩小|CLsort bin|AA001|AF还书成功|AG还书成功|AY4AZ869C册记录中<currentLocation>?abc</currentLocation>。
操作日志中<operator location="?abc">zizhu</operator>
3）使用合法值，警告标志位为N，返回提示还书成功，且册记录的currentLocation和操作日志中的operator元素的location属性都为AP输入的值。符合预期。
2022-03-06 12:09:54 send:09N20220306 12095420220306 120954AP流通库|AO|ABCN-110108-1-ABC.B001|AC|BIN2022-03-06 12:09:55 recv:101YNN20220306 120954AOCN-110108-1-ABC|ABCN-110108-1-ABC.B001|AQ流通库|AJ剪面包的男孩小|CLsort bin|AA001|AF还书成功|AG还书成功|AY4AZ868E册记录中<currentLocation>流通库</currentLocation>。
操作日志中<operator location="流通库">zizhu</operator>
2022-03-05 12:07:27 WYC dp2library正式版3.105.8098.39412 dp2Capo： 1.38.8098.32803
- 还书消息AP输入非法值，还书成功，但警告标志位为Y，返回提示为还书成功，但拟写入的馆藏地不合法。` 符合预期
2022-03-05 12:07:27 send:09N20220305 12072720220305 120727APtest|AO|ABB001|AC|BIN 2022-03-05 12:07:27 recv:101YNY20220305 120727AOCN-00000-1-ZG|ABB001|AQ流通库|AJ怪物大师|CLsort bin|AAP001|AF还书操作成功。拟写入册记录的当前位置值 'test' 不合法(根据馆藏地 locationTypes 定义)|AG还书操作成功。拟写入册记录的当前位置值 'test' 不合法(根据馆藏地 locationTypes 定义)|AY4AZFE4C
册记录中<currentLocation>test</currentLocation>操作日志中<operator location="test">zizhu1</operator> - 使用?xxx不校验，警告标志位为N，返回提示还书成功，且册记录的currentLocation和操作日志operator元素的 location属性都为AP输入的值。符合预期
2022-03-06 14:13:08 send:09N20220306 14130820220306 141308AP?test|AO|ABB001|AC|BIN 2022-03-06 14:13:08 recv:101YNN20220306 141308AOCN-00000-1-ZG|ABB001|AQ流通库|AJ怪物大师|CLsort bin|AAP001|AF还书成功|AG还书成功|AY4AZE04C册记录中
<currentLocation>?test</currentLocation>操作日志中<operator location="?test">zizhu1</operator> - 使用合法值，警告标志位为N，返回提示还书成功，且册记录的currentLocation和操作日志operator元素的 location属性都为AP输入的值。符合预期
2022-03-06 14:16:23 send:09N20220306 14162320220306 141623AP保存本库|AO|ABB001|AC|BIN 2022-03-06 14:16:23 recv:101YNN20220306 141623AOCN-00000-1-ZG|ABB001|AQ流通库|AJ怪物大师|CLsort bin|AAP001|AF还书成功|AG还书成功|AY4AZE04C册记录中
<currentLocation>保存本库</currentLocation>操作日志中<operator location="保存本库">zizhu1</operator>
2022/3/4-1125-ryh dp2libraryxe版本号 3.105.8097.22276，dp2Capo 版本: 1.37.8098.16894，还书消息AP输入非法值，还书成功，但警告标志位为Y，返回提示为还书成功，但拟写入的馆藏地不合法。` 符合预期
2022-03-04 11:21:30 send:09N20220304 11213020220304 112130APabcdef|AO|ABB001|AC|BIN 2022-03-04 11:21:30 recv:101YNY20220304 112130AOCN-110108-1-ABC|ABB001|AQ流通库|AJ剪面包的男孩小|CLsort bin|AA001|AF还书操作成功。拟写入册记录的当前位置值 'abcdef' 不合法(根据馆藏地 locationTypes 定义)|AG还书操作成功。拟写入册记录的当前位置值 'abcdef' 不合法(根据馆藏地 locationTypes 定义)|AY4AZA6DC
***
20220302 1100 WYC dp2library测试版：3.104.8095.35002 dp2内务测试版：3.60.8092.18686，dp2Capo 版本: 1.37.8095.33438，测试结果符合预期。
在“基础操作”区域使用不校验形态：“?测试A”，预期还书成功且更新册的当前位置，实际成功还书并更新册的当前位置，`<currentLocation>?测试A</currentLocation> `，符合预期。在dp2内务编辑这条册，可以保存成功。符合预期
在“基础操作”区域使用“测试A”，并且不在dp2内务配置该馆藏地，预期还书失败，实际还书失败提示`当前位置字段中的馆藏地 '测试A' 不合法: 馆代码 '' 没有定义馆藏地点 '测试A'...`
在“基础操作”区域使用“测试A”，且在dp2内务配置了馆藏地“测试A”，预期还书成功，实际还书成功，且更新了册的当前位置，符合预期。
***
20220301 1248 WYC dp2library测试版：3.104.8092.25348 dp2内务测试版：3.60.8092.18686，dp2Capo 版本: 1.37.8094.20517，测试结果符合预期。
册记录中
册记录中
册记录中
册记录中
册记录中
册记录中
册记录中
册记录中
册记录中
册记录中
册记录中
册记录中
册记录中
册记录中
册记录中
册记录中
册记录中
册记录中
册记录中
测试还书同时修改册的当前位置
开发说明
SIP2服务器还书接口及后台使用的dp2libaray还书API，实现了还书同时修改册的当前位置的功能。 还书时册的当前位置可能来自3个地方，按优先顺序依次为：1）还书API传的当前位置；2）前端登录传的location；3）登录帐号配置的默认位置。
详细开发说明参考：https://github.com/DigitalPlatform/dp2/issues/937
2022/3/2版本更新： 还书时更新位置，要求位置的值是合法的馆藏地，如果指定要用一个非法的值，前面要用?，即形态为
?xxx2022/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，返回提示为还书成功，但拟写入的馆藏地不合法。 3）合法的馆藏地，校验合法，还书成功更新位置成功。另外合法的馆藏地还要扩展一种形态，即
馆藏地:xxx，也应与合法馆藏地一样的效果。1 用SIP2前端来测
单纯地针对每种情况测试，也就是只有一处设置了值，没有其它值干扰。 1.1 还书请求API字段传值（AP表示当前位置），还书后检查册的currentLocation应为AP的值，同时检查操作日志中operator的location属性应一致。
关于SIP2登录时传的location，因为是第三方传来的，传的location值不能随便相信是可以用来更新册的当前位置，也可能是前端登录随便传的，所以location=普通值时，dp2libary后来不会用来更新册位置。当location=!值，则明确表示可用来修改当前位置。 1.2-1 SIP2登录请求传location=普通值，还书后检查册的currentLocation应不变，操作日志中没有operatorlocation属性。 1.2-2 SIP2登录请求传location=!值，还书后检查册的currentLocation应为登录请求传的location值，同时检查操作日志中operator的location属性应一致。
1.3 SIP2登录帐号本身，在内务用户管理界面，配置好“默认位置”，注意在SIP2前端登录请求和还书请求都不传位置，那么还书操作会按帐号的默认位置来设置册的location，同时检查操作日志应一致。
组合测试 1.4 还书09消息AP有值，login登录请求中location=!值，还书时册的当前位置应优先使用还书09消息的位置，检查操作日志operator的location属性应一致。不应为login登录请求的location值。 1.5 还书09消息AP有值，帐号也配了默认位置，还书时册的当前位置应优先使用还书09消息的位置，检查操作日志operator的location属性应一致。不应为帐号配置中的默认位置。 1.6 login登录请求中location=!值，帐号也配了默认位置，还书时册的当前位置应优先使用login登录请求配的location值，检查操作日志operator的location属性应一致。不应为登录帐号配置的默认位置。 1.7 login登录请求中location=普通值，帐号也配了默认位置，还书时册的当前位置应优先使用登录帐号配置的默认位置，检查操作日志operator的location属性应一致。不应为登录请求location传的普通值，因为前面不带!号，表示不按此值修改册位置。
2 用dp2内务前端来测
单纯地针对每种情况测试，也就是只有一处设置了值，没有其它值干扰。 2.1 内务登录时输入工作台号（同理SIP2登录请求的location），还书后检查册的currentLocation应为登录时传的工作台号值，同时检查操作日志中operator的location属性应一致。 2.2 登录帐号本身，在内务用户管理界面，配置好“默认位置”，那么还书操作会按帐号的默认位置来设置册的location，同时检查操作日志应一致。 组合测试 2.3 内务登录时传的工作台号，同时帐号也配置了默认位置，还书时册的当前位置应优先使用使用登录的工作台号（即location），检查操作日志operator的location属性应一致。不应为登录帐号配置的默认位置。
3 用TestRestLibrary前端来测
TestRestLibrary工具说明： TestRestLibrary是一个使用Rest API访问dp2libraray的测试前端工具。从 http://dp2003.com/files/TestRestLibrary.zip 下载绿色安装包，或者从 https://github.com/renyh/TestRestLibrary 克隆源代码自行编译。 在全局信息的Service URL输入dp2library的rest协议地址，注意要把前面的rest.删除。
还书等操作之前，需要先登录，在Login/Logout界面进行登录，输入username和password，工作人员身份登录type选工作人员，strParameters自动会根据type产生一个参数，可以在这里根据测试要求增加其它参数，例如在登录参数中设置位置可以加一段
location=学校本部，合起来parameters为type=worker,location=学校本部，点login按钮，下方是登录结果，如果Result为NoError，表示登录成功。还书reutrn API中strStyle 参数中可以放位置子参数，格式为
currentLocation:xxx(xxx换成实际的值）单纯地针对每种情况测试，也就是只有一处设置了值，没有其它值干扰。 3.1 在Return API的style参数加入当前位置子参数
currentLocation:xxx(xxx换成实际的值），还书后检查册的currentLocation应为API参数的值，同时检查操作日志中operator的location属性应一致。3.2 在登录Login API的strParameters参数加入当前位置子参数
location=XXX(xxx换成实际的值），还书后检查册的currentLocation应为登录参数的值，同时检查操作日志中operator的location属性应一致。3.3 在登录帐户本身配置默认位置，login API与return API都不传位置参数，那么还书操作会按帐号的默认位置来设置册的location，同时检查操作日志应一致。
组合测试 3.4 return API有位置参数，login登录请求有位置参数，还书时册的当前位置应优先使用return API的位置，检查操作日志operator的location属性应一致。不应为login登录请求的location值。
3.5 return API有位置参数，帐号也配了默认位置，还书时册的当前位置应优先使用return API的位置，检查操作日志operator的location属性应一致。不应为帐号配置中的默认位置。
3.6 login API 有位置参数，帐号也配了默认位置，还书时册的当前位置应优先使用login API的位置，检查操作日志operator的location属性应一致。
3.7 return API有位置参数，login API 有位置参数，帐号也配了默认位置，还书时册的当前位置应优先使用return API的位置，检查操作日志operator的location属性应一致。
测试dp2library修改册记录时，对currentLocation元素的是否校验做的区分
开发说明
dp2library 修改册记录的时候，会分情况决定是否校验 currentLocation 元素，如果currentLocation值为问号开头的内容则不校验，却
?xxx这种形态的值，不进行校验是否为合法的馆藏地，但对不是?号开头的值，依然保持校验是否为合法的馆藏地。测试环境准备
升级dp2installer和dp2librarayxe最新测试版。
测试思路
首先测试一下内务创建册记录是否正确，因为内务创建册记录不涉及到当前位置currentLocation，所以不涉及校验该值，预期正常新建。
然后在内务修改册记录的当前位置currentLocation（在实体查询窗，通过右健命令"批处理/快速修改册记录"可修改当前架位），分别修改为三种情况：1）
?xxx，应不校验，应保存成功；2）不合法的值，应校验，应保存失败；3）合法的值，应校验，应保存成功。然后在通过SIP2前端还书请求，将册的当前位置分别修改为三种情况测试，参见1.1。
最后再用dp2inventory前端来测试修改当前位置，分别修改为三种情况：1）
?xxx服务器应不校验，应更新成功；2）不合法的值，服务器应校验，应更新失败；3）合法的值，服务器应校验，应更新成功。测试大纲
4.1 内务创建册记录，不涉及到当前位置currentLocation，预期正常新建。
4.2-1 在内务修改册的当前位置，修改为
?xxx，应不校验，应保存成功。 4.2-2 在内务修改册的当前位置，修改为不合法的值，应校验，应保存失败。 4.2-3 在内务修改册的当前位置，修改为合法的值，应校验，应保存成功。扩展为：合法的值:xxx，也应保存成功。4.3-1 在dp2Inventory修改当前位置，修改为
?xxx，服务器应不校验，应更新成功。 4.3-2 在dp2Inventory修改当前位置，修改为不合法的值，服务器应校验，应更新失败。 4.3-3 在dp2Inventory修改当前位置，修改为合法的值，服务器应校验，应更新成功。4.4-1 在SIP2更新图书信息接口19/20修改当前位置，修改为
?xxx，服务器应不校验，应更新成功。 4.4-2 在SIP2更新图书信息接口19/20修改当前位置，修改为不合法的值，服务器应校验，应更新失败。 4.4-3 在SIP2更新图书信息接口19/20修改当前位置，修改为合法的值，服务器应校验，应更新成功。关于借书还书时是否修改当前位置的说明
借书目前还没有 currentLocation 概念。也不会自动修改册记录的 currentLocation。这样做的考虑是，让借出状态的册记录，保留借出前的 currentLocation 字段内容，有一定价值。因为借出暗含“图书在读者手上”意思，并不需要 currentLocation 内容来表达。将来系统改进时候，借书动作是不是会修改册 currentLocation，还没有定论。
还书动作自动修改册记录 currentLocation 字段内容，这是比较确定的事情。因为图书经过读者拿走以后，回到图书馆，还没有上架，位置肯定不是借书前的那个 currentLocation 内容了。清理一下 currentLocation 字段内容，有好处。等后面上架盘点后，currentLocation 字段内容还会再次被修改，反映当时的确切位置。