SetSystemParameter() API 的操作日志记录增加 oldValue 和 snapshot 元素

[DigitalPlatform]

dp2library 此前版本的 SetSystemParameter() API 产生的操作日志记录中只有 value 元素记载了本次提交的新值，但没有元素记载修改前的旧值。最新版为日志记录增加了 oldValue 元素，用于记载修改前的旧值。

另外，为了便于将来日志恢复阶段进行快照式恢复，最新版日志记录中还增加了 snapshot 元素，用于记载修改前相关的一个完整单元的内容，范围可能比 oldValue 元素记载的内容更大。

oldValue 元素内容和 snapshot 元素内容的区别，是 oldValue 原则上尽量只记载修改涉及到的最小单元内容。一般而言，对 create 动作，因为 create 之前相关位置不存在内容，所以 snapshot 元素内容为空；对 modify 动作，为修改之前的最小单元内容；对 delete 动作，为删除之前的最小单元内容。

一些操作的最小单元和完整单元是相同的，那么此时 oldValue 元素内容和 snapshot 元素内容相同。

日志记录内的 version 元素记载了日志记录格式的版本号。最新版为 1.12。

[DigitalPlatform]

测试计划 center

strCategory: "center"
strName: "delete" "modify" "create" 之一
strValue:

<center>
    <server refid="xxxx" name="xxx" url="xxx" username="xxx" password="xxx"/>
</center>

注:

0. strValue 中的 center/server 元素可能是多个(center 元素作为根元素只有一个)。strSnapshot 中返回了操作前 library.xml 中的 center 元素的 OuterXml 内容(注意包含的内容是 center 元素的以及其下所有 server 元素的全部内容，不仅仅是被修改的部分 server 元素内容 )。strOldValue 中返回了操作修改涉及到的 server 元素的修改前的内容。这里所指的 strOldValue 中返回的内容会被写入操作日志记录的 oldValue 元素；strSnapshot 中返回的内容会被写入操作日志记录的 snapshot 元素。oldValue 元素和 snapshot 元素是最新版 dp2library 为 setSystemParameter 操作日志记录新增的两个元素。

1. strName 为 "delete" 时，操作前要求 library.xml 中存在 center/server/@refid 属性值和 strValue 中center/server/@refid 属性值匹配的(一个或多个) server 元素。操作即是删除 library.xml 中匹配的 server 元素。

2. strName 为 "modify" 时，操作前要求 library.xml 中存在 center/server/@refid 属性值和 strValue 中center/server/@refid 属性值匹配的 server 元素。并且要求修改成的 server/@name 属性值在 library.xml 中所有 center/server 元素中没有被使用过。操作即是用来自 strValue 中的 server 元素替换 library.xml 中的对应 server 元素的下列属性值: name url username password。

3. strName 为 "create" 时，操作前要求 library.xml 中不存在 center/server/@refid 属性值和 strValue 中 center/server/@refid 属性值匹配的 server 元素。并且要求新创建的 server/@name 属性值在 library.xml 中所有 center/server 元素中没有被使用过。操作即是用来自 strValue 中的 server 元素在 library.xml 中的 center 元素之下创建新的 server 元素，并使用来自 strValue 的下列属性值: name url username password。

4. 和本功能对应的 GetSystemParameter() API 用法为 GetSystemParameter(strCategory: "center", strName: "def")

5. 安全性考量：
   a) 要求 GetOperLog() 和 GetOperLogs() API 在获得日志记录的时候，对低权限用户过滤掉 value 、 oldValue 和 snapshot 元素内容文本中的 password 属性值。如果value 和 oldValue 元素文本内容不是合法的 XML 结构，则跳过过滤处理。
   b) 日志记录中记载的 value 元素文本值，其中的 password 属性值是 hashed 状态，和当初请求 SetSystemParameter() API 的 value 参数内容不同，需特别注意。
   c) 日志记录中 oldValue 元素文本值，其中的 password 属性值也是 hashed 状态，这一点和 library.xml 中的 center/server/@password 属性内容一致。

===
20240418-ryh 测试计划

1. 检查create/modify/delete的操作，和产生的日志
   1）create：
   新建refid已存在的server应失败，新建refid为新值的server应成功，检查应更新到library.xml注意password为hashed形态，通过内务的系统管理/中心服务器 刷新能看到。--符合预期。
   新建产生的操作日志，value本次新增的内容，oldValue无值，snapshot为修改前完整内容，涉及到的password 属性值是 hashed 。--符合预期。
   2）modify：
   修改refid不存在的server应失败，修改refid存在的server应成功，通过内务的系统管理/中心服务器 刷新能看到改变。--符合预期。
   修改产生的操作日志，value本次修改的内容，oldValue与修改对应的原来的内容，snapshot为修改前完整内容，涉及到的password 属性值是 hashed 。--符合预期。
   3）delete:
   删除refid不存在的server应失败，删除refid存在的server应成功，通过内务的系统管理/中心服务器 刷新能看到删除了。--符合预期。
   删除产生的操作日志，value本次删除的内容，oldValue与删除对应的server原来的内容，snapshot为删除前完整内容，涉及到的password 属性值是 hashed 。--符合预期。

2. 安全性检查
   1）GetOperLog() 和 GetOperLogs() API ，低权限看不到password，高权限应能看到password，为 hashed型态。--符合预期
   2）内务日志窗应不能看到。--符合预期

3. 日志恢复测试
   用dp2libraryxe全新环境 ，恢复第1步create/modify/delete产生的日志，应能根据日志兑现操作。--符合预期

[DigitalPlatform]

测试计划 valueTable

strCategory: "valueTable"
strName: "new" "change" "overwirte" "delete" 之一
strValue:

<table name="issueState">部分到,全部到,预测</table>

注:

0. strValue 中的根元素应该是 table 元素。strOldValue 中返回的 OuterXml 表示操作前 library.xml 中的 valueTables 元素下被操作修改的部分 XML 结构(注：不是 valueTables 的全部内容，而是被修改的部分 table 元素内容 )。strSnapshot 中返回修改前 library.xml 中的 valueTables 元素的 OuterXml 内容。这里所指的 strOldValue 中返回的内容会被写入操作日志记录的 oldValue 元素；strSnapshot 中返回的内容会被写入操作日志记录的 snapshot 元素。oldValue 元素和 snapshot 元素是最新版 dp2library 为 setSystemParameter 操作日志记录新增的两个元素。

1. strName 为 "delete" 时，操作前要求 library.xml 中存在 valueTables/table/@name 属性值、dbname 属性值和 strValue 中 table/@name 属性值、dbname 属性值任一匹配的 table 元素。操作即是删除 library.xml 中匹配的 table 元素。

2. strName 为 "change" 时，操作前要求 library.xml 中存在 valueTables/table/@name 属性值、dbname 属性值和 strValue 中 table/@name 属性值、dbname 属性值任一匹配的 table 元素。操作即是用来自 strValue 中的 table 元素替换 library.xml 中的对应 valueTables/table 元素的下列属性值: name dbname 和元素文本。注意，如果 library.xml 中有多个 table 元素匹配，则它们会被替换为一个 table 元素。

3. strName 为 "overwrite" 时，效果和 "change" 类似。差别是，overwrite 不要求 library.xml 预先存在匹配的 table 元素。可以理解为 overwrite 相当于分条件的 change 或 new。

4. strName 为 "new" 时，操作前要求 library.xml 中不存在 valueTables/table/@name 属性值、dbname 属性值和 strValue 中 table/@name 属性值、dbname 属性值任一匹配的 table 元素。操作即是用来自 strValue 中的 table 元素在 library.xml 中的 valueTables 元素之下创建新的 table 元素。

5. 从测试角度，和本功能对应的 GetSystemParameter() API 用法为 GetSystemParameter(strCategory: "circulation", strName: "valueTables")

6. 和本功能相关的另一 SetSystemParameter() API 用法为：SetSystemParameter(strCategory: "circulation", strName: "valueTables", strValue)。上述用法的用途全面修改 valueTables 元素下的所有 table 元素，而本功能的作用是零星修改 table 元素。

7. 安全性考量：无。

---

20240418-ryh 测试计划
1）测试 new/change/overwrite/delete 4种操作，
对于new如果已存在对应name+dbname则新增失败，
对于change和delete如果根据name+dbname找到对应事项成功，未命中不做处理。
对于overwrite如果根据name+dbname找到对应事项则修改，如果未命中则新增。

注意，name+dbname作为整体一对来匹配。例如下面三项值是可以新增成功的:

    <table name="readerState" dbname="b">挂失,注销,离职,退休1</table>
    <table name="readerState" dbname="">挂失,注销,离职,退休1</table>
    <table name="readerState1" dbname="b">挂失,注销,离职,退休1</table>

--符合预期

2）检查上述动作产生的操作日志，value应为接口提交的内容，oldValue应为提交name对应的原来的值， snapshot元素内容应为完整信息。--符合预期

3）dp2libraryxe全新环境，恢复new/change/overwrite/delete操作日志，应根据日志兑现。--符合预期。

4）检查内务的“值列表”编辑界面，使用的是SetSystemParameter() API 用法为：SetSystemParameter(strCategory: "circulation", strName: "valueTables", strValue)，感觉这种方法更简单。

---

2025/04/18 开发留言

匹配算法的程序代码如下：

        static List<XmlElement> MatchTableNodes(XmlNode root,
            string strName,
            string strDbName)
        {
            var results = new List<XmlElement>();

            XmlNodeList nodes = root.SelectNodes("table[@name='" + strName + "']");
            if (nodes.Count == 0)
                return results;

            foreach (XmlElement node in nodes)
            {
                string strCurDbName = DomUtil.GetAttr(node, "dbname");
                if (String.IsNullOrEmpty(strCurDbName) == true
                    && String.IsNullOrEmpty(strDbName) == true)
                {
                    results.Add(node);
                    continue;
                }

                if (strCurDbName == strDbName)
                    results.Add(node);
            }

            return results;
        }

详细描述，可以把匹配过程这样解释：

先用 strName 参数选择所有 table/@name 属性值符合的 table 元素。注意这样可能得到一个或者多个 table 元素。然后对这些 table 元素进行进一步筛选：当 table/@dbname 属性值为空、或者 strDbName 参数为空，或者当 strDbName 参数和 table/@dbname 属性值符合，都被选中，否则就排除掉。

上述“进一步筛选”阶段，分情况说：

1. 如果 strDbName 参数值为空，并且 table/@dbname 为空或者属性不存在，被选中。
2. 如果 strDbName 参数值不为空，则要求 table/@dbname 属性值要和 strDbName 一致。

这里分两种情况说，主要是考虑到把 table 元素的 dbname 属性不存在，和属性存在但属性值为空，统一起来，避免出现逻辑漏洞。(table 元素的 name 属性是必备的属性，没有上述问题)

模糊一点说，说是两者平等起来 AND 都要匹配的概念，也可以。

---

各动作详细说明：

1）对于 new 动作来说，要先进行上述匹配，如果符合条件的数量 > 0 则会报错。

2）对于 delete 动作来说，要先进行上述匹配，如果符合条件的数量 == 0 则会报错(这里今天做了改进)。注意如果匹配多个 table 元素，是匹配的全部都要被删除。

3）对于 change 动作来说，要先进行上述匹配，如果符合条件的数量 == 0 则会报错。注意如果匹配多个 table 元素，会把匹配上的第一个 table 元素替换为要修改成的内容，其余 table 元素删除掉。也就是说假设匹配了三个 table 元素，这三个元素修改后剩下一个 table 元素。

4）对于 overwrite 元素来说，和 change 动作差不多效果。只是进行上述匹配阶段，如果符合条件的数量 == 0，并不报错，而是把要修改成的 table 元素内容，新插入一个 table 元素到配置文件相关位置。

[DigitalPlatform]

测试计划 circulation

strCategory: circulation

strName: ?AcceptBlankReaderBarcode

strValue: "true" "false" 之一

临时修改内存中的 app.AcceptBlankReaderBarcode 值

从测试角度，和本功能对应的 GetSystemParameter() API 用法为 GetSystemParameter(strCategory: "circulation", strName: "?AcceptBlankReaderBarcode")

strName: ?AcceptBlankItemBarcode

strValue: "true" "false" 之一

临时修改 dp2library 内存中的 app.AcceptBlankItemBarcode 值

strOldValue 和 strSnapshot 返回修改前的 app.AcceptBlankItemBarcode 值。后面的所有名字以问号开头的 strName 参数沿用同样的习惯。

strName: ?UpperCaseItemBarcode

strValue: "true" "false" 之一

临时修改 dp2library 内存中的 app.UpperCaseItemBarcode 值

strName: ?UpperCaseReaderBarcode

strValue: "true" "false" 之一

临时修改 dp2library 内存中 app.UpperCaseReaderBarcode 值

strName: ?VerifyBookType

strValue: "true" "false" 之一

临时修改 dp2library 内存中 app.VerifyBookType 值

strName: ?VerifyReaderType

strValue: "true" "false" 之一

临时修改 dp2library 内存中 app.VerifyReaderType 值

strName: ?BorrowCheckOverdue

strValue: "true" "false" 之一

临时修改 dp2library 内存中 app.BorrowCheckOverdue 值

strName: ?CirculationNotifyTypes

strValue: string 类型

临时修改 dp2library 内存中 app.CirculationNotifyTypes 值

strName: ?AcceptBlankRoomName

strValue: "true" "false" 之一

临时修改 dp2library 内存中 app.AcceptBlankRoomName 值

strName: ?VerifyRegisterNoDup

strValue: "true" "false" 之一

临时修改 dp2library 内存中 app.VerifyRegisterNoDup 值

strName: ?PatronAdditionalFroms

strValue: string 类型。逗号间隔的内容

临时修改 dp2library 内存中 app.PatronAdditionalFroms 值

strName: ?PatronAdditionalFields

strValue: string 类型。逗号间隔的内容

临时修改 dp2library 内存中 app.?PatronAdditionalFields 值

strName: valueTables

strValue:

<table name="issueState" dbname="">部分到1,全部到1,预测1</table>
<table name="itemState" dbname="">xxx,xxx</table>

注：可能是多个 OuterXml 连接起来。没有容器元素。

修改 library.xml 根元素下 valueTables 元素的 InnerXml 内容。

从测试角度，和本功能对应的 GetSystemParameter() API 用法为 GetSystemParameter(strCategory: "circulation", strName: "valueTables")

strOldValue 和 strSnapshot 返回修改前 library.xml 根元素下 valueTables 元素的 OuterXml 内容。

strName: rightsTable

strValue:

    <type reader="本科生">
        <param name="可借总册数" value="10" />
        <param name="可预约册数" value="5" />
        <param name="以停代金因子" value="1.0" />
        <param name="工作日历名" value="基本日历" />
        <type book="普通">
            <param name="可借册数" value="10" />
            <param name="借期" value="31day,15day" />
            <param name="超期违约金因子" value="CNY1.0/day" />
            <param name="丢失违约金因子" value="1.5" />
        </type>
        <type book="教材">
            <param name="可借册数" value="10" />
            <param name="借期" value="31day,15day" />
            <param name="超期违约金因子" value="CNY1.0/day" />
            <param name="丢失违约金因子" value="1.5" />
        </type>
        <type book="教学参考">
            <param name="可借册数" value="10" />
            <param name="借期" value="31day,15day" />
            <param name="超期违约金因子" value="CNY1.0/day" />
            <param name="丢失违约金因子" value="1.5" />
        </type>
        <type book="原版西文">
            <param name="可借册数" value="2" />
            <param name="借期" value="31day,15day" />
            <param name="超期违约金因子" value="CNY1.0/day" />
            <param name="丢失违约金因子" value="3.0" />
        </type>
    </type>
    <type reader="硕士生">
        <param name="可借总册数" value="15" />
        <param name="可预约册数" value="5" />
        <param name="以停代金因子" value="1.0" />
        <param name="工作日历名" value="基本日历" />
        <type book="普通">
            <param name="可借册数" value="10" />
            <param name="借期" value="31day,15day" />
            <param name="超期违约金因子" value="CNY1.0/day" />
            <param name="丢失违约金因子" value="1.5" />
        </type>
        <type book="教材">
            <param name="可借册数" value="10" />
            <param name="借期" value="31day,15day" />
            <param name="超期违约金因子" value="CNY1.0/day" />
            <param name="丢失违约金因子" value="1.5" />
        </type>
        <type book="教学参考">
            <param name="可借册数" value="10" />
            <param name="借期" value="31day,15day" />
            <param name="超期违约金因子" value="CNY1.0/day" />
            <param name="丢失违约金因子" value="1.5" />
        </type>
        <type book="原版西文">
            <param name="可借册数" value="3" />
            <param name="借期" value="31day,15day" />
            <param name="超期违约金因子" value="CNY1.0/day" />
            <param name="丢失违约金因子" value="3.0" />
        </type>
    </type>
    <type reader="博士生">
        <param name="可借总册数" value="20" />
        <param name="可预约册数" value="5" />
        <param name="以停代金因子" value="1.0" />
        <param name="工作日历名" value="基本日历" />
        <type book="普通">
            <param name="可借册数" value="10" />
            <param name="借期" value="31day,15day" />
            <param name="超期违约金因子" value="CNY1.0/day" />
            <param name="丢失违约金因子" value="1.5" />
        </type>
        <type book="教材">
            <param name="可借册数" value="10" />
            <param name="借期" value="31day,15day" />
            <param name="超期违约金因子" value="CNY1.0/day" />
            <param name="丢失违约金因子" value="1.5" />
        </type>
        <type book="教学参考">
            <param name="可借册数" value="10" />
            <param name="借期" value="31day,15day" />
            <param name="超期违约金因子" value="CNY1.0/day" />
            <param name="丢失违约金因子" value="1.5" />
        </type>
        <type book="原版西文">
            <param name="可借册数" value="4" />
            <param name="借期" value="31day,15day" />
            <param name="超期违约金因子" value="CNY1.0/day" />
            <param name="丢失违约金因子" value="3.0" />
        </type>
    </type>
    <type reader="讲师">
        <param name="可借总册数" value="20" />
        <param name="可预约册数" value="5" />
        <param name="以停代金因子" value="1.0" />
        <param name="工作日历名" value="基本日历" />
        <type book="普通">
            <param name="可借册数" value="10" />
            <param name="借期" value="31day,15day" />
            <param name="超期违约金因子" value="CNY1.0/day" />
            <param name="丢失违约金因子" value="1.5" />
        </type>
        <type book="教材">
            <param name="可借册数" value="10" />
            <param name="借期" value="31day,15day" />
            <param name="超期违约金因子" value="CNY1.0/day" />
            <param name="丢失违约金因子" value="1.5" />
        </type>
        <type book="教学参考">
            <param name="可借册数" value="10" />
            <param name="借期" value="31day,15day" />
            <param name="超期违约金因子" value="CNY1.0/day" />
            <param name="丢失违约金因子" value="1.5" />
        </type>
        <type book="原版西文">
            <param name="可借册数" value="5" />
            <param name="借期" value="31day,15day" />
            <param name="超期违约金因子" value="CNY1.0/day" />
            <param name="丢失违约金因子" value="3.0" />
        </type>
    </type>
    <type reader="教授">
        <param name="可借总册数" value="30" />
        <param name="可预约册数" value="5" />
        <param name="以停代金因子" value="1.0" />
        <param name="工作日历名" value="基本日历" />
        <type book="普通">
            <param name="可借册数" value="10" />
            <param name="借期" value="31day,15day" />
            <param name="超期违约金因子" value="CNY1.0/day" />
            <param name="丢失违约金因子" value="1.5" />
        </type>
        <type book="教材">
            <param name="可借册数" value="10" />
            <param name="借期" value="31day,15day" />
            <param name="超期违约金因子" value="CNY1.0/day" />
            <param name="丢失违约金因子" value="1.5" />
        </type>
        <type book="教学参考">
            <param name="可借册数" value="10" />
            <param name="借期" value="31day,15day" />
            <param name="超期违约金因子" value="CNY1.0/day" />
            <param name="丢失违约金因子" value="1.5" />
        </type>
        <type book="原版西文">
            <param name="可借册数" value="6" />
            <param name="借期" value="31day,15day" />
            <param name="超期违约金因子" value="CNY1.0/day" />
            <param name="丢失违约金因子" value="3.0" />
        </type>
    </type>
    <readerTypes>
        <item>本科生</item>
        <item>硕士生</item>
        <item>博士生</item>
        <item>讲师</item>
        <item>教授</item>
    </readerTypes>
    <bookTypes>
        <item>普通</item>
        <item>教材</item>
        <item>教学参考</item>
        <item>原版西文</item>
    </bookTypes>

注：可能是多个 OuterXml 连接起来。没有容器元素。

修改 library.xml 根元素下 valueTables 元素的 InnerXml 内容。

从测试角度，和本功能对应的 GetSystemParameter() API 用法为 GetSystemParameter(strCategory: "circulation", strName: "rightsTable")

strOldValue 和 strSnapshot 返回修改前 library.xml 根元素下 rightsTable 元素的 OuterXml 内容。

strName: locationTypes

strValue:

<item canborrow="no">保存本库</item>
<item canborrow="no">阅览室</item>
<item canborrow="yes">流通库</item>

修改 library.xml 根元素下 locationTypes 元素的 InnerXml 内容。

从测试角度，和本功能对应的 GetSystemParameter() API 用法为 GetSystemParameter(strCategory: "circulation", strName: "locationTypes")

strOldValue 和 strSnapshot 返回修改前 library.xml 根元素下 locationTypes 元素的 OuterXml 内容。

strName: zhongcihao

strValue:

<nstable name="nstable">
    <item prefix="unimarc" uri="http://dp2003.com/UNIMARC" />
    <item prefix="usmarc" uri="http://www.loc.gov/MARC21/slim" />
</nstable>
<group name="中文书目" zhongcihaodb="种次号">
    <database name="中文图书" leftfrom="索取类号" rightxpath="//marc:record/marc:datafield[@tag='905']/marc:subfield[@code='e']/text()" titlexpath="//marc:record/marc:datafield[@tag='200']/marc:subfield[@code='a']/text()" authorxpath="//marc:record/marc:datafield[@tag='200']/marc:subfield[@code='f' or @code='g']/text()" />
</group>

修改 library.xml 根元素下 zhongcihao 元素的 InnerXml 内容。

从测试角度，和本功能对应的 GetSystemParameter() API 用法为 GetSystemParameter(strCategory: "circulation", strName: "zhongcihao")

strOldValue 和 strSnapshot 返回修改前 library.xml 根元素下 zhongcihao 元素的 OuterXml 内容。

strName: callNumber

strValue:

<group name="中图法" classType="中图法" qufenhaoType="Cutter-Sanborn Three-Figure,GCAT" zhongcihaodb="" callNumberStyle="索取类号+区分号">
    <location name="保存本库" />
    <location name="阅览室" />
    <location name="流通库" />
</group>

修改 library.xml 根元素下 zhongcihao 元素的 InnerXml 内容。

从测试角度，和本功能对应的 GetSystemParameter() API 用法为 GetSystemParameter(strCategory: "circulation", strName: "callNumber")

strOldValue 和 strSnapshot 返回修改前 library.xml 根元素下 callNumber 元素的 OuterXml 内容。

strName: dup

strValue:

                <project name="采购查重" comment="示例方案">
                    <database name="测试书目库" threshold="60">
                        <accessPoint name="著者" weight="50" searchStyle="" />
                        <accessPoint name="题名" weight="70" searchStyle="" />
                        <accessPoint name="索书类号" weight="10" searchStyle="" />
                    </database>
                    <database name="编目库" threshold="60">
                        <accessPoint name="著者" weight="50" searchStyle="" />
                        <accessPoint name="题名" weight="70" searchStyle="" />
                        <accessPoint name="索书类号" weight="10" searchStyle="" />
                    </database>
                </project>
                <project name="编目查重" comment="这是编目查重示例方案">
                    <database name="中文图书" threshold="100">
                        <accessPoint name="责任者" weight="50" searchStyle="" />
                        <accessPoint name="ISBN" weight="80" searchStyle="" />
                        <accessPoint name="题名" weight="20" searchStyle="" />
                    </database>
                    <database name="图书测试" threshold="100">
                        <accessPoint name="责任者" weight="50" searchStyle="" />
                        <accessPoint name="ISBN" weight="80" searchStyle="" />
                        <accessPoint name="题名" weight="20" searchStyle="" />
                    </database>
                </project>
                <default origin="中文图书" project="编目查重" />
                <default origin="图书测试" project="编目查重" />

修改 library.xml 根元素下 dup 元素的 InnerXml 内容。

从测试角度，和本功能对应的 GetSystemParameter() API 用法为 GetSystemParameter(strCategory: "circulation", strName: "dup")

strOldValue 和 strSnapshot 返回修改前 library.xml 根元素下 dup 元素的 OuterXml 内容。

strName: script

strValue:

<![CDATA[
using System;
using System.Xml;

...
...
]]>
<refs>
    <ref>system.dll</ref><ref>system.xml.dll</ref>
    <ref>%bindir%/digitalplatform.xml.dll</ref>
    <ref>%bindir%/digitalplatform.io.dll</ref>
    <ref>%bindir%/digitalplatform.text.dll</ref>
</refs>

修改 library.xml 根元素下 script 元素的 InnerXml 内容。

从测试角度，和本功能对应的 GetSystemParameter() API 用法为 GetSystemParameter(strCategory: "circulation", strName: "script")

strOldValue 和 strSnapshot 返回修改前 library.xml 根元素下 script 元素的 OuterXml 内容。

strName: barcodeValidation

strValue:

    <validator >
      <patron>
        <CMIS />
        <range value='P000001-P999999' />
      </patron>
      <entity>
        <range value='0000001-9999999'></range>
      </entity>
    </validator>

修改 library.xml 根元素下 barcodeValidation 元素的 InnerXml 内容。

从测试角度，和本功能对应的 GetSystemParameter() API 用法为 GetSystemParameter(strCategory: "circulation", strName: "barcodeValidation")

strOldValue 和 strSnapshot 返回修改前 library.xml 根元素下 barcodeValidation 元素的 OuterXml 内容。

[DigitalPlatform]

测试计划 opac

strCategory: opac

strName: databases

strValue:

    <database name="中文图书" alias="cbook">
        <caption lang="zh">中文图书</caption>
        <from name="ISBN" style="isbn">
            <caption lang="zh-CN">ISBN</caption>
            <caption lang="en">ISBN</caption>
        </from>
        <from name="ISSN" style="issn">
            <caption lang="zh-CN">ISSN</caption>
            <caption lang="en">ISSN</caption>
        </from>
        <from name="题名" style="title">
            <caption lang="zh-CN">题名</caption>
            <caption lang="en">Title</caption>
        </from>
        <from name="题名拼音" style="pinyin_title">
            <caption lang="zh-CN">题名拼音</caption>
            <caption lang="en">Title pinyin</caption>
        </from>
        <from name="主题词" style="subject">
            <caption lang="zh-CN">主题词</caption>
            <caption lang="en">Thesaurus</caption>
        </from>
        <from name="中图法分类号" style="clc,__class">
            <caption lang="zh-CN">中图法分类号</caption>
            <caption lang="en">CLC Class number</caption>
        </from>
        <from name="责任者" style="contributor">
            <caption lang="zh-CN">责任者</caption>
            <caption lang="en">Contributor</caption>
        </from>
        <from name="责任者拼音" style="pinyin_contributor">
            <caption lang="zh-CN">责任者拼音</caption>
            <caption lang="en">Contributor pinyin</caption>
        </from>
        <from name="出版发行者" style="publisher">
            <caption lang="zh-CN">出版发行者</caption>
            <caption lang="en">Publisher</caption>
        </from>
        <from name="出版时间" style="publishtime,_time,_freetime">
            <caption lang="zh-CN">出版时间</caption>
            <caption lang="en">Publish Time</caption>
        </from>
        <from name="批次号" style="batchno">
            <caption lang="zh-CN">批次号</caption>
            <caption lang="en">Batch number</caption>
        </from>
        <from name="目标记录路径" style="targetrecpath">
            <caption lang="zh-CN">目标记录路径</caption>
            <caption lang="en">Target Record Path</caption>
        </from>
        <from name="状态" style="state">
            <caption lang="zh-CN">状态</caption>
            <caption lang="en">State</caption>
        </from>
        <from name="操作时间" style="opertime,_time,_utime">
            <caption lang="zh-CN">操作时间</caption>
            <caption lang="en">OperTime</caption>
        </from>
        <from name="其它标识号" style="identifier">
            <caption lang="zh-CN">其它标识号</caption>
            <caption lang="en">Identifier</caption>
        </from>
        <from name="查重键" style="ukey">
            <caption lang="zh-CN">查重键</caption>
            <caption lang="en">Uniform Key</caption>
        </from>
        <from name="查重码" style="ucode">
            <caption lang="zh-CN">查重码</caption>
            <caption lang="en">Uniform Code</caption>
        </from>
        <from name="__id" style="recid" />
    </database>
    <database name="中文期刊" alias="cseries">
    ......
    ......
    </database>
    <database name="西文图书" alias="ebook">
    ......
    ......
    </database>
    <database name="西文期刊" alias="eseries">
    ......
    ......
    </database>

修改 library.xml 根元素下 virtualDatabases 元素的 InnerXml 内容。

从测试角度，和本功能对应的 GetSystemParameter() API 用法为 GetSystemParameter(strCategory: "opac", strName: "databases")

strOldValue 和 strSnapshot 返回修改前 library.xml 根元素下 virutalDatabases 元素的 OuterXml 内容。

strName: browseformats

strValue:

<database name="中文图书">
    <format name="详细" type="biblio">
        <caption lang="zh-CN">详细</caption>
        <caption lang="en">Detail</caption>
    </format>
</database>
<database name="中文期刊">
    <format name="详细" type="biblio">
        <caption lang="zh-CN">详细</caption>
        <caption lang="en">Detail</caption>
    </format>
</database>
<database name="西文图书">
    <format name="详细" type="biblio">
        <caption lang="zh-CN">详细</caption>
        <caption lang="en">Detail</caption>
    </format>
</database>
<database name="西文期刊">
    <format name="详细" type="biblio">
        <caption lang="zh-CN">详细</caption>
        <caption lang="en">Detail</caption>
    </format>
</database>

修改 library.xml 根元素下 browseformats 元素的 InnerXml 内容。

从测试角度，和本功能对应的 GetSystemParameter() API 用法为 GetSystemParameter(strCategory: "opac", strName: "browseformats")

strOldValue 和 strSnapshot 返回修改前 library.xml 根元素下 browseformats 元素的 OuterXml 内容。

strName: serverDirectory

strValue:

https://dp2003.com/dp2opac

修改 dp2library 的 app.OpacServerUrl 内容。

从测试角度，和本功能对应的 GetSystemParameter() API 用法为 GetSystemParameter(strCategory: "opac", strName: "serverDirectory")

strOldValue 和 strSnapshot 返回修改前 dp2library 的 app.OpacServerUrl 内容。

---

20240418-ryh 测试计划
1）通过内务的系统管理中“opac”操作界面，新增、修改、删除 opac/databases，功能应正确，产生的操作日志应正确，value是完整最新值，oldValue与napshot是修改前完整内容。--符合预期

2）通过内务的系统管理中“opac”操作界面，新增、修改、删除 opac/browseformats，功能应正确，产生的操作日志应正确，，value是完整最新值，oldValue与napshot是修改前完整内容。--符合预期

3）通过接口设置和修改open/serverDirectory，功能应正常，产生的操作日志应正确。对应library.xml中的opacServer元素的url，注意设置完是存在内存中，退出dp2library时会保存到library.xml中。--符合预期。

4）全新dp2libraryxe环境，恢复setSystemParam/opac相关操作日志，应能兑现。--符合预期。

[renyh]

测试 circulation/?xxx

1）通过GetSystemParameter观察和SetSystemParameter修改，以下?号参数，检测内存是否修改成功。符合预期
2）修改的值只存储在内存中，重启dp2library恢复成原来的值，符合预期
3）恢复 setSystemParameter日志，这些参数在内存中的值根据日志被修改，符合预期。

==修改成false
?AcceptBlankReaderBarcode
?AcceptBlankItemBarcode
?UpperCaseItemBarcode
?UpperCaseReaderBarcode
?VerifyBookType
?VerifyReaderType
?BorrowCheckOverdue
?VerifyRegisterNoDup

==修改成具体的值
?CirculationNotifyTypes=abc
?PatronAdditionalFroms=证号
?PatronAdditionalFields=test

==修改成true
?AcceptBlankRoomName

测试 circulation/XXX

valueTables 值列表
rightsTable 流通权限
locationTypes 馆藏地
zhongcihao 种次号
callNumber 排架体系
dup 查重方案
script 脚本
barcodeValidation 条码校验

1）通过GetSystemParameter和SetSystemParameter以及内务观察和修改上述参数是否正确，观察产生的操作日志是否正确（value没有根元素，oldValue和snapshot内容一样且有根元素），是否正确兑现到library.xml文件中。符合预期

2）退出重启dp2library恢复成原来的值，应是修改后的值。符合预期

3）用一个全新的单机恢复，恢复这批setSystemParameter日志，能根据日志兑现修改参数。符合预期。