用 LotusScript 实现 Excel 报表的自动生成和操作

用 LotusScript 实现 Excel 报表的自动生成和操作级别: 初级胡 睿 (ruihu@), 软件工程师, IBM2006 年 10 月 19 日Lotus Notes 是 Windows® 和 Macintosh® 计算机上功能强大且用途广泛的软件，在企业内部用领域，扮演了十分重要的角色。

而 Excel® 表格也是企业办公领域的流行工具之一，经常作据的报表使用。

Lotus Domino Designer 当中的 LotusScript 语言提供了丰富的编程功能，可以数据库当中实现对 Excel 文件的自动生成、操作和发送等等功能。

本文结合本人在开发过程当经验，以一个具体的应用模块为例，介绍在 Lotus 平台下，用 LotusScript 语言实现 Excel 报能的原理、方法和一些实用技巧。

Lotus Notes 应用开发概念简介Lotus Notes 是大型企业内部办公协作的首选工具之一，除了众所周知的电子邮件收发功能以外，No 大的应用程序运行平台，可以通过运行各种 Notes 应用来实现各种各样的功能。

Notes 客户端上运行的应用被称为 Notes 数据库，如同网页浏览器（如Firefox）通过打开不同的 U 的网络应用（网页）一样，Notes 客户端的强大功能，正在于通过打开不同的 Notes 数据库，从而实务功能。

从物理上看，Notes 数据库很简单，就是一个后缀名为“nsf”的文件，Notes 客户端只要打服务器上的 nsf 文件，就可以访问这个 Notes 数据库了。

从逻辑上看，Notes 数据库文件将数据库的集中在一起，便于访问和维护。

要理解 Notes 数据库的逻辑结构，就要理解 Notes 数据库独特的数据库类型－“文档数据库”。

一库”，人们都会想起通用的关系型数据库，其实，很多其他形式的数据库，如“文档数据库”也非常实现某些特定的功能。

文档数据库的概念很简单，就是在数据库当中没有关系型数据库那样复杂的结定，数据按照简单的“文档”形式来存储，一个“文档”当中包含很多内容字段，文档之间的关联不数据存储以外，Notes 数据库当中还储存了一些操作数据的应用程序，包括脚本程序、图形界面设计等等。

有了这些设计，Notes 数据库就不仅仅具有简单的数据存储功能，还可以实现丰富的应用逻辑数据库虽然很通用，可以存储任何结构的数据，但是在存储结构不是很复杂，数据间关联不是很紧密数据库的形式就更加容易设计和修改；而这种将数据和设计放在一个文件当中的形式，也更加便于部一个很容易想到的文档数据库的例子就是电子邮件信箱：在邮箱里，每一封邮件都可以被认为是一个着类似的结构和字段，而且相互之间关联程度不大。

如果用关系型数据库来记录邮件内容，在开发过多的限制和约束，而且对于归类、排序、自动设置属性等等邮件文档的常用功能，必须按照关系型数比较复杂的应用程序来实现。

有了文档数据库，事情就变得简单了，由于文档的共同特性，文档数据的归类、排序等功能，几乎不用写代码，就可以实现这些常规的操作功能。

而且，当我们要迁移邮箱要拷贝邮箱的 nsf 文件就可以了，不会像关系数据库那样需要复杂的导入导出和配置过程。

所以，L 应用最为广泛的，就是邮件数据库，它充分体现了文档数据库的特点，另外，个人通讯录、日程安排的文档管理系统等等企业办公协作应用，也可以用文档数据库很好的实现。

用 Domino Designer 开发简单脚本程序开发一个 Notes 数据库应用，有专门的工具，那就是 Domino Designer。

Domino Designer 是一种件，一般可以跟 Lotus Notes 客户端一起安装。

应用程序开发人员和 Web 站点设计人员通过它可以够通过 Lotus Notes 或 Web 浏览器访问的协作应用程序。

开发人员很容易使用表单、视图、网页、即时消息、XML、Java、JavaScript 等来创建核心业务解决方案。

除开这些功能以外，Domino Designer 还提供了一种简单易用的脚本语言－“LotusScript”来实现一能。

这种语言语法类似于 Basic 语言，可以调用 Domino 提供的丰富的函数库实现很多文档操作和处使用 Domino Designer 开发文档数据库的方法很简单，只要运行 Domino Designer，创建或者打开件就可以开始开发了，如下图所示。

图1. Domino Designer 开发项目导航图中可见，Domino Designer 提供了丰富的开发功能，在这里我们重点介绍脚本程序的开发。

脚本程图中的“共享代码”项目当中的“代理”和“Script 库”当中实现。

“代理”就是一个个独立的脚本LotusScript 来实现，可以定时触发，也可以用一定的事件触发；“Script 库”是一个用户自定义的脚LotusScript 等方式写好的共享脚本就放在这里，由代理来调用。

另外，脚本编程还常常用到视图。

视一个“搜索器”，每一个视图规定了一定的搜索条件，返回一个文档的集合。

脚本程序当中，经常掉定条件的文档，进而进行处理，就如同关系型数据库应用当中频繁使用 “select”语句得到数据集一点击“代理”导航项，弹出了如下图所示的新建代理设置界面。

图2. 代理开发简要示意图如图，在 1 附近位置可以确定代理的名称，这里定为“AgentTest”。

然后，我们在 2 附近的位置可的方式，在“按事件”和“按日程安排”当中选择，这里，我们选择按照事件来触发，而且指定是在个菜单项来触发。

随后，我们在 3 附近的位置指定脚本语言，这里，我们使用 LotusScript。

选定了就可以看到图中 4 附近的位置出现了 LotusScript 语言的基本结构，其中在（Options）当中可以指性，例如是否允许使用未定义的变量等；在（Declarations）里面，我们可以指定一些引用脚本，定量，这里相当于 C 语言的头文件；在 Initialize 函数当中，是这个脚本的主要执行逻辑，这个函数相main 函数，是执行的入口点；在 Terminate 函数当中，我们可以指定一些脚本执行完毕以后的资源外，如同 C 语言一样，这里也可以定义局部函数。

例如，我们在 Initialize 函数里面写下如下简单的语句：Sub Initialize'定义界面工作空间Dim workspace As New NotesUIWorkspace'弹出一个确认对话框Call workspace.Prompt(PROMPT_OK, "Say Hello", "Hello")End Sub然后，保存这个代理，用 Notes 打开这个数据库，由于我们刚才选择了用“操作”菜单来触发这个代发现在这个数据库的“操作”菜单下面有一个菜单项就是用这个代理的名称来命名的。

我们点击这个项目以后，就会看到代理运行的结果了。

如下图。

图3. 简单代理运行用 LotusScript 访问 ExcelLotusScript 除开可以访问 Notes 数据库当中的资源以外，还可以访问某些外部的文件资源。

Excel?当中一个重要成员，在数据记录和统计领域十分常用，其本身也是一款数据库软件。

在 LotusScript 些 OLE 接口来访问和操作 Excel，从而可以在 Notes 数据库当中实现对 Excel 文件的操作和访问。

在 LotusScript 当中，提供了访问 Excel 文件，以及其他外部资源的方法，开发人员只需要简单的调数，就可以方便的实现自动操作 Excel 的功能。

下面，本文结合一个实例，一步一步的介绍用 Lotu 作 Excel 的方法。

例子描述现在我们考虑一个简单的应用实例：有一个存放普通文档的数据库，不断会有人更新和添加一些文档要给这个数据库添加一个代理程序，让它定期自动运行，例如一个礼拜运行一次，将这个礼拜当中新要内容取出来放到一个 Excel 文件里面，然后对这个报表进行单元格的自动对齐等操作，最后将这个电子邮件附件的形式发送到特定的若干地址当中去。

打开一个 Excel 对象运行这样的程序，必须在机器上安装 Excel，这样 LotusScript 才可以操作 Excel。

这里，Notes 数台机器（服务器）上运行即可，也就是说，只需要在服务器上面装上 Excel 程序就可以了。

要打开一个 Excel 对象，需要用到 LotusScript 里面的 CreateObject 方法，这个方法打开一个 OL 以在方法调用的时候指定对象类型：xlApp As Variant'创建一个新的 Excel 应用实例，对应一个 Excel 文件Set xlApp = CreateObject("Excel.application")'在这个 Excel 文件当中添加一个 SheetxlApp.Workbooks.AddxlApp.Visible = TrueLotusScript 是一种语法比较松散的脚本语言，类似于 VB，为了避免代码的逻辑混乱，我们可以利用面的面向对象的特性，将处理 Excel 操作的代码统一写到一个类里面，这样既便于维护，也可以最大冗余，提高代码的重用性。

一般的，我们用 Script 库共享代码的方式来实现一个类：在 Domino Designer 的 “Script 库” 里面LotusScript 库”就可以新建一个空的共享脚本，我们定名字为 “ExcelUtil ”，希望在里面存放所有作代码；然后，我们在（Declarations ）方法里面写下全局的类定义如下：我们可以用类似 Java 的语言思想来看待这段类定义的代码：这个类的名称叫做 ExcelReport ，意为应于一个 Excel 文件，其中私有的变量 xlApp 对应 Excel 文件，构造函数 new() 则实现了 Excel 对初始化。

我们以后更多的操作方法可以追加在后面，实现更多的功能。

有了这个共享的类，我们就可以考虑实现业务逻辑了。

在 Domino Designer 的“代理”里面，按照本方式，我们创建一个简单的代理 “ReportGenerator ”，然后，在（Options ）方法里面，我们引入那这样就可以在这个代理里面使用共享的 ExcelReport 类了。

随后，我们在 Initialize 方法里面通过 E 定义并初始化一个 Excel 对象：操作 Excel 对象 对 Excel 对象的简单操作主要是通过调用上述 ExcelReport 类当中的 xlApp 变量的特定方法来实现我们都知道，Excel 文件的基本数据单元就是一个个的“单元格”，由于所有单元格默认都是为空且单元格没有“添加”和“删除”操作（要删除一个单元格的内容，只要写入一个空字符串即可）。