如何使用dp2batch导出 导入XML文件 - DigitalPlatform/dp2 GitHub Wiki

如果用户想导出书目和下属册记录的完整信息,可以使用dp2batch工具来导出。读者信息的XML文件也可以通过dp2batch来导出,但由于内务【读者查询】窗已有了导出读者信息到XML文件功能,不推荐使用dp2batch来导出。

所导出的XML信息也需要通过dp2batch来导入到新的dp2服务器上。本文以导出书目记录为例,讲解使用dp2batch导出导入的过程。


一.数据导出

1.安装dp2batch

由于dp2batch是直连到服务器的dp2kernel底层模块去导出数据,一般情况下服务器的dp2kernel底层模块只允许本机访问,所以要到服务器所在的电脑上去运行dp2batch。

dp2batch安装地址:http://dp2003.com/dp2Batch/v3/publish.htm

2.打开dp2batch,设置 dp2kernel 服务器的 URL 地址和账号。

点击【文件】-【缺省账户管理...】,进入【服务器地址和缺省账户管理】对话框,点击【新增服务器】,在弹出的【新增服务器地址和缺省账户】对话框里面设置需要导出的dp2kernel服务器地址和账户密码。

标准版的dp2kernel服务器地址可以利用dp2installer(注:在服务器机器上)安装实用工具来看(在【dp2kernel】-【配置实例】双击目标实例后,在【修改一个实例】对话框的【协议绑定】栏位可以看到,一般以net.pipe开头)。(单机版) dp2kernel 服务器地址为“net.pipe://localhost/dp2kernel/xe”。

标准版 dp2kernel 的账户密码是在安装服务器的时候就设定好的,一般是账户名是root。 单机版 dp2kernel 的账户固定为root,密码为空。

设置后点【确定】,关闭【新增服务器地址和缺省账户】对话框。这时dp2batch右侧区域显示当前所绑定的所有kernel服务器名称。

3.导出数据

由于dp2batch一次只能导出一个库的数据,所以相关的书目库和实体库数据要分别导出。书目记录和实体记录的导出步骤是一样的,只是所选择的“库”不同。

数据导出过程中,要注意记录所导数据在原来服务器中的数据库名称。因为后面在新服务器上导入时,需要将两台服务器的数据库进行对应设置。

导出步骤如下:

1)切换到【按记录ID导出】属性页;

2)在右边的树状目录中,点击服务器名称左边的+号,展开服务器中的所有数据库,选定要导出的书目库节点;

3)在【输出记录范围】组中,根据需要指定要导出的记录ID号码起止范围,如果需要导出所有记录,则指定为“全部”;

4)勾选【校准首尾ID】和【未命中时继续循环】。 如果只是单纯导出记录,要确保“删除记录”处于清除状态;如果要在一边导出记录的同时一边删除数据库中的记录,则要勾选“删除记录”;

5)点工具条上的打勾的按钮(开始按钮);

6)系统弹出【指定方案名】对话框,勾选“忽略方案”,然后按“确定”按钮;

7)系统弹出【指定要保存的文件名】对话框,在“保存类型”中,选择*.xml格式,给需要保存的文件命名,或者在对话框中选定一个已经存在的文件名,然后按【保存】按钮;

8)导出操作开始执行,在导出过程中,随时可按工具条上的红色停止按钮来中断处理过程,导出完成后弹出提示框“数据导出完成”,并提示导出数据条数。

二、在新的dp2服务器上使用dp2batch导入XML数据

1.在新服务器上安装dp2batch模块。

2.配置导出服务器和导入服务器的的dp2kernel地址和账号。

3.导入数据

由于册记录是建立在书目记录的基础之上的,所以导入图书信息时,要先导书目记录,再导册记录。

1)在dp2batch点【导入】,点击【文件名】文本框后面的【...】按钮,从【打开】对话框找到需要导入的书目XML文件后,点【打开】。这时【文件名】文本框关闭。

2)如果要将文件中的全部记录导入数据库,则【导入范围】文本框内容保持为空。如果要导入文件中的部分数据记录,可以指定一个范围字符串,如“1-200,300-400”这样的形态;

3)点击【库名映射规则】文本框右侧的【…】,在弹出的【库名映射规则】对话框里创建和编辑映射规则。

由于数据记录在导出到文件的时候是携带了记录路径信息的,数据导入前建立库名映射规则,目的是让所导入的数据文件的记录路径和目标服务器中可用的数据库记录路径之间建立对应关系。让数据存储到正确的数据库,并存储到正确的记录序号位置。

另外,数据记录在导出到文件的时候是携带了记录路径信息存储的,而如果将这些记录导入数据库的时候如果希望用追加和覆盖方式之一来进行,也需要通过指定特定的库名映射规则来决定。

在【库名映射规则】文本框的空白处右击-【新增】,系统弹出【库名映射事项】对话框,

点【源】文本框中右边的【...】按钮,在随后打开的【选择源数据库】对话框中选择所导出数据服务器中的数据库节点,就获得了这个数据库的路径字符串;

点【目标】文本框中右边的【...】按钮,在随后打开的【选择目标数据库】对话框中选择所导入数据服务器中的导入目标库节点,就获得了这个数据库的路径字符串;

在【写入方式】组合框中,选择一个适当的写入方式。如果选择了append,即追加方式,则目标文本框中不必输入内容;

点【确定】按钮。在【库名映射规则】对话框的映射规则列表内,会出现一个新的规则事项。

image

如果要修改一个已有的规则事项,直接双击事项,在出现的【映射规则事项】对话框内进行修改,然后点【确定】按钮即可。

4)点工具条上的打勾的按钮(开始按钮),会出现一个【指定方案名】对话框,并默认勾选【忽略方案】,点【确定】按钮;

5)系统导入书目数据完成,弹出提示“恢复文件''完成”。

册记录和读者信息XML文件的导入过程与书目记录雷同,只是所选择的库不同,导入册记录时选择实体库,导入读者记录时选择读者库。

完成导入后,就可以到新服务器上去检索确认所导入的数据是否兑现。


dp2系统里所导出的读者XML文件里面包含读者的在借信息和借阅历史,如果将读者信息XML文件,连同相关的书目/册信息都通过这种方式导入新系统,那么读者的借阅链是完整的,在老系统里借出的图书可以在新系统里还。