Notes Gateway手册.doc

Notes Gateway手册 TRS信息技术有限公司 1、总体框架 2 1. 1工具和数据库 2 1.2总体框架 2 2、数据导出模块 3 2. 1界面 3 2.2新建任务 3 2.3浏览 6 2.4废纸篓 7 3、数据导入模块 7 3.1如何创建一个新的TRS库 7 3. 2字段匹配 7 3.3增量更新 7 Notes Gateway 是TRS信息技术公司的众多产品中的一个产品，它主要的功能是将Notes数据库中的数据迁移到TRS数据库中，以便充分地利用TRS数据库优异的全文检索功能，实现自动化。 注：下面为了方便，把Notes Gatewy简称为产品。 1、总体框架 1工具和数据库 由于是基于Lotus的产品，显然开发工具是必定采用Lotus Script，它的数据库采用Lotus Domino Server。由于TRS提供的API是C API，因此也采用了VC++6.0开发工具，它的数据库采用TRS Server。 注：API –Application Programme Interface 1.2总体框架 从前面已经知道，在使用Lotus Domino Server时采用了Lotus Script这种内嵌式的开发语言，这种工具开发出来的应用产品只能依附在Lutos的产品之中，也就是notes中，而不能独立存在，也就是无法编译形成机器语言。但是TRS方面提供C API使得基于其上的产品能够独立存在，另一方面，Lotus Script却由无法调用和理解TRS C API。因此不难想象出本产品必须分成两部分：一部分基于notes的、采用Lotus Script开发的模块；另一部分是基于TRS的、采用VC++开发的模块。同时这两个模块之间为了能够进行数据交换，必须找到一种中间通讯的协议，很显然，这个协议就是TRS提供的TRS格式文件协议。到此不难得出本产品的总体框架，如下图示： 其中由虚曲线包括起来部分就是整个Gateway。 2、数据导出模块 1界面 数据导出模块或称为文档导出模块是内嵌到Notes之中的，具体的方法就是，把我们提供的.nsf文件拷贝到notes安装目录下的data目录中。 导航大纲中存在三个功能按钮：新建任务、浏览、废纸篓。下面分别介绍。 2.2新建任务 选择新建任务之后，会进入如下的界面。 任务名称---标识你新建的任务名称，使得可以区分别的任务。 运行频率---在定时的情况下，指定任务多长的时间间隔来运行一次。 当你点击按钮时，将会弹出一个对话框，按着对话框的提示，将会依次进行：数据库选择-》表单选择-》域选择 ，这三个步骤。如果服务器是远程服务器，则要填上服务器的名称。 如果文档中存在http的超连接，并且要导出来，选择“是”，将要填写http服务器的地址。 如果文档中存在附件，并且要导出来，则选择“是”，将要填写这些附件存放的路径。 最后要填写存放TRS格式文件的路径。如下图示： 方案解决： 1、TRS格式文件是一个标注文件，它如同html文件一般，标记数据存放的位置和方式，并不存在文件类型的转换。 2、一个域中存在多个附件的处理方案。这个处理存在两个问题，其一是否涉及文件格式转换的问题；其二TRS Server的Document类型的数据不允许多值。通过Lotus Script提供的内部功能，可以很直接地把任何能够存放在Notes中的文件原样的导出来指定的目录中，TRS格式文件只标记它的文件名和路径即可，并不存在文件格式转换的问题。由于TRS Server的Document类型的数据不允许多值，我们将采用把每一个附件的文本抽取出来存放到附件这个字段中，而原来的文件作为BIT类型的多值存放在原格式文件这个字段中。 3、增量更新：按照一定的时间间隔去检查notes库中是否存在增加或修改过的记录，存在的话，将把数据导出。但是目前实现删除的增量非常困难。 2.3浏览 这个界面中看到是用户已经创建的并且已经保存的任务。可以直接双击任务名称，进入详细状态。如图示： 2.4废纸篓 废纸篓是存放用户删除的任务。如果用户真实想把任务删除，则进入废纸篓后，选择清空或指定删除即可。 3、数据导入模块 数据导入模块是通过TRS C API的调用，把TRS格式文件中指定（或说标注）的数据导入到TRS数据库中。它需要解决的问题主要集中在如下三个方面，其一、如何创建一个新的TRS库（表）；其二、如何产生字段匹配的问题；其三、如何增量更新的问题 3.1如何创建一个新的TRS库 要创建一个新的TRS库，就必须存在一个TRS格式文件，通过自动检索分析TRS格式文件中一个域，取出其中的信息，形成一个模板，即可获得创建TRS库的字段信息，然后创建一个TRS数据库。 2字段匹配 同样，字段的匹配的信息也来自TRS