珠海泰坦接口工具使用手册

1、珠海泰坦接口工具使用手册珠海泰坦接口工具用户手册珠海泰坦软件系统有限公司联系电话：0756-2009年4月36目 录1接口工具配置11.1环境部署（安装.NET2.0框架）11.2安装数据库（以ORACLE客户端为例）21.2.1 ORACLE客户端（仅当连接oracle数据库时需要）21.3接口工具使用流程91.4从超越和darms产品中导出模板文件101.4.1导出超越模板101.4.2导出darms模板142主系统接收超越和darms数据流程163配置文件夹介绍163.1 Template173.2 Data173.3 Build184接口工具使用194.1 模板工具使用191.模板源选

2、择202.连接数据库223.选择新旧系统234.选择档案类型245.对应档案类型246.编辑字段257.删除字段288.新加字段299.选择模板路径和保存模板314.2转换工具使用331.配置路径342.处理类型343.生成XML文件344.日志351 接口工具配置1.1环境部署（安装.NET2.0框架）点击.NET2.0框架安装文件夹，双击运行安装程序，系统会自动检测本机是否安装.NET Framework 2.0程序，如果没有安装会自动弹出安装该组件的协议框，如下图：点击【接受】按钮，进行程序安装，如下图：1.2安装数据库（以ORACLE客户端为例）1.2.1 ORACLE客户端（仅当连接

3、oracle数据库时需要）安装前提：1.接口工具所连接的数据库是oracle数据库2.当工具不在数据库所在的服务器机器上运行，并且本机没有安装oracle数据库或客户端。安装好Oracle数据库客户端后，则创建连接到指定数据库的数据库服务名，具体操作如下：1.3接口工具使用流程接口工具分为模板设置工具和转换工具，执行步骤：模板工具：1. 先从超越，darms或者其他产品中导出的模板文件，详细操作请参考1.4模板导出操作。2. 将模板文件引入模板工具中进行重新调整对应后并保存在指定目录下。注意：Template文件夹内分为单位模板和公共模板，将对应的模板保存在相对应的位置。转换工具：1. 在转换

4、工具配置需引用的模板文件路径，源数据路径和生成数据路径。注意：转换工具在调用模板的时候遵循的规则是：先调用单位模板，当没有对应的单位模板将调用公共模板。2. 将需要转换的数据放置在源数据文件夹内，点击生成XML文件按钮使用转换工具进行数据转换操作，生成成功的数据包存放在生成数据文件夹内。1.4从超越和darms产品中导出模板文件1.4.1导出超越模板进入超越系统维护界面，点击【备份恢复】-【数据备份】，如图：进入数据备份选择页面，如图：如上图，选择对应的五大数据管理模块：案卷，卷内，资料，未归，归档管理，并且勾选“仅备份系统数据”，点击【下一步】，进入备份路径选择，如图：在上图中点击【设置】弹

5、出框可以选择自定义备份路径或者默认位置，选择完毕后点击【确定】，如图：在上图中，选择备份目录，例如：备份4，点击【开始备份】。如图：系统会弹出提示点击【确定】即完成备份操作。在刚才设置了备份文件存放的本地路径找到数据存放文件夹，如图：刚才是设置了备份4的备份目录，点击进入文件夹，如图：后缀名为“*.dat”的文件即为超越的模板文件，如图：1.4.2导出darms模板进入darms系统维护界面，点击【数据库设置】-【栏目转出】，如图：进入选择存放darms模板文件路径，如图：选择完毕后点击【打开】，如图：如上图点击【保存】即可，系统弹出提示点击【是】开始，模板开始进行转出，系统弹出提示点击【确定

6、】即可。 在之前指定的darms文件存放路径找到刚才转出的模板，如图：2 主系统接收超越和darms数据流程超越系统或darms系统模板配置工具，配置各档案分类与主系统各分类的对应字段关系转换工具导出界面模板文件导出数据文件输出各分类对照关系文件主系统接收输出标准xml数据包3配置文件夹介绍在服务器上需要配置指定文件夹包括存放模板，数据和转换数据后数据包，如图：用户darms数据和超越数据，通过ftp传到的上图的Data数据文件夹下对应的全宗号文件夹里。指定配置的文件夹有三个，如图：3.1 Template该文件内存放的是单位模板和公共模板文件，点击进入后显示如图：以全宗号命名的是单位模板文件

7、夹，另外一个是公共模板文件夹。双击单位模板文件。档案模板文件分为三级，例如：002文件夹内包含子文件夹 DA的下面又分为两个子文件夹，根据档案产品工具类型不同，将模板数据存放在不同的文件夹内。树节点排列图：3.2 DataData文件夹内存放的是原始的数据文件，如图：以全宗号命名的文件夹用来存放各单位的原始数据记录，分为超越和darms,以“*.txt”形式存放，darms的数据必须是按导出的命名，jn.txt/aj.txt/zl.txt/wj.txt/fw.txt/sw.txt,如果导出卷内有多份数据文件，可以给txt数据文件加上级文件夹，以加区分，见下图：超越数据的存储如下：3.3 Bui

8、ldBuild文件夹内存放的是经由转换工具转换成功的标准数据包，以全宗号命名的文件夹，如下图：各个单位转换后的数据会分别存放到各单位的全宗号文件夹中，双击进入如图：转换后的数据包以全宗号-年月日时分秒-最后四位随机数命名。例如：002_1.ZIP这数据包就是全宗单位为002，2009年4月1日九点二十一分零一秒生成的，最后四位由系统随机生成。4接口工具使用4.1 模板工具使用双击模板工具文件夹显示内部如图：双击模板工具运行程序进入模板工具内部，如图：1. 模板源选择1）选择“darms”，如图：darms模板源是“*.txt”格式的，点击上图标注红圈的按钮，选择路径：点击【打开】即可，选择后的

9、路径如图：2）选择超越超越模板源是“*.dat”格式的，如图：点击确定后显示路径，如图：2. 连接数据库数据库类型分为以上三种，现在拿oracle数据举例，点击【数据库配置】按钮，进入如图：输入数据源，用户名和密码，输入完毕后，点击显示配置，如红色显示，点击【测试连接】看是否正确连接上数据库，显示这样的图标表示连接成功；点击【保存配置】保存该配置记录，免得下次使用还要重新配置；点击【确定】即可完成此次配置。如图：字符串那栏显示刚才保存的配置。3. 选择新旧系统选择新旧系统是为了更好的对应字段间的关系，现在拿新系统举例，如下面描述。4. 选择档案类型导入模板源后系统会自动获取档案类型，在业务模块

10、下拉框可以查看到：选择完业务模块后，在门类那栏下可以看到所有的门类类型，如图：5. 对应档案类型选择好档案类型后，必须要对应一样的档案类型，选择好对应的业务模块和门类，如图：选择完毕如图:点击【加载】按钮将文件中的字段读取出来，如图：6. 编辑字段在字段栏中选中需要编辑的字段，点击【编辑】按钮，如图：选中的字段编辑后，在右侧字段编辑区内中自动获取相应字段信息，如图：在字段编辑区内根据情况，来选择目标字段名等需更新的信息，如图：选择完毕后，点击【更新】即完成该次字段更新操作，可以在字段栏框中看到编辑过的字段改变状态，如图：7. 删除字段在字段栏中选中需要删除的单个字段，点击【删除】，如图：系统弹

11、出确认框点击【是】该字段删除成功，点击【否】取消删除操作，返回当前页面。8. 新加字段新加字段功能是提供给用户重新增加字段栏中原有的字段，前提是删除了原有字段后，想恢复该字段可以使用该功能进行操作。点击【新加】，在字段编辑栏中进行字段信息填写，如图：选择源字段名，后再选择目标字段名，如图：根据实际情况填写完毕后，点击下角的【添加】按钮，如图：如果不需要该字段了，点击上图的【取消】即可撤销这次操作。添加该字段成功后可以在字段栏的最后一列找到新增字段，如图：9. 选择模板路径和保存模板模板内的字段编辑完毕后，可以选择保存模板，事先选择好存放模板的位置，如图点击选择存放路径：选择指定文件夹Template，如果是单位模板，请选择以全宗号命名的文件夹，如果是公共模板，则选择“公共模板”文件夹存放，选择位置：如上图选择文件夹点击【确定】，选择后的路径显示如图：选择路径完毕后点击【保存模板】即可，保存后的模板显示在刚才所选择保存路径的指定文件夹内，如图：4.2转换工具使用双击转换工具文件夹显示如图：双击模板工具运行程序进入转换工具内部，如图：1. 配置路径点击选择路径，将上图各个路径选择好，如图：选择完毕后，点击【保存配置】保存好所有路径，以便下次重复使用。2. 处理类型本工具可以处理档案数据和文件数据，根据所需选择。3. 生成XML文件将数据放在原