转载

IBM iNotes Control 控件功能介绍及应用实践

IBM iNotes Control 控件功能简介

什么是 IBM iNotes Control 控件

IBM iNotes 做为一款基于 Web 浏览器访问 Domino 邮件数据库的应用程序，支持市面上多款主流浏览器，比如 IE，Firefox，Chrome，Safari。为了能够给用户提供在 IE 浏览器上更好地使用附件功能的用户体验，以及将 IBM iNotes 设置为缺省邮件客户端，提高浏览器缓存管理安全性，IBM iNotes 开发出专门针对 IE 的 ActiveX 控件，来处理 IBM iNotes 中和附件相关的功能。

IBM iNotes Control 控件实现原理

ActiveX 控件技术是国际上通用的基于 Windows 平台的软件技术。ActiveX 控件以前也叫做 OLE 控件或 OCX 控件，它是一些自包含代码的软件组件或对象，可以将其插入到 Web 网页或其它应用程序中。所以简单的说，ActiveX 控件就是 IE 浏览器的插件。ActiveX 控件的特点是：一般软件需要用户单独下载然后执行安装，而 ActiveX 控件是当用户浏览到特定的网页时，IE 浏览器即可自动下载并提示用户安装。

IBM iNotes 将 IE 浏览器上邮件附件处理部分的代码封装成 ActiveX 控件，当用户通过 IE 浏览器使用 IBM iNotes 访问邮件数据库时，就会自动从 Domino 服务器上下载并安装 ActiveX 控件，从而使用 ActiveX 提供的丰富的附件处理功能，设置 IBM iNotes 为缺省邮件客户端，进一步安装浏览器缓存管理控件等功能。

回页首

IBM iNotes Control 控件的安装及升级

IBM iNotes Control 控件的安装方式

在线安装方式

所谓在线安装方式，即终端用户通过 web 的方式登录其 iNotes 邮箱并安装此 IBM iNotes Control 控件的方式。由于该控件是通过 ActiveX 实现的，所以只支持 IE 浏览器，目前支持的 IE 浏览器包括 IE8,IE9,IE10 和 IE11。

当用户通过 IE 浏览器登录其 iNotes 邮箱，访问以下功能时会触发 IBM iNotes Control 控件的下载和安装：

打开一封带有附件的邮件，并点击展开附件区域会触发该控件的下载和安装，如图 1 所示；
创建一封新邮件，点击展开附件区域会触发该控件的下载和安装；
打开用户设置页面时会触发该控件的下载和安装。

图 1. 点击展开附件区域

当用户通过上述方法触发了 IBM iNotes Control 控件的下载和安装后，由于浏览器安全设置的原因，IE 浏览器通常会阻止该控件的下载，并弹出如图 2 所示的提示框 , 进而 IBM iNotes 弹出如图 3 所示的对话框“IBM iNotes 控件的安装已被阻止或拒绝”。如果用户想继续下载安装该控件，则需要用户点击图 3 中的“Install”按钮以及图 4 中“OK”按钮，从而使浏览器记住了用户的选择。当用户再次通过上述 3 种方式触发控件下载安装时，不会再弹出图 2 和图 3 的对话框而直接成功下载。

图 2. 浏览器阻止窗口

图 3. IBM iNotes 弹出安装失败窗口

IBM iNotes Control 控件下载成功后会自动安装。但是同样地，由于浏览器安全设置的原因，浏览器会弹出该控件安装的警告对话框，如图 4 所示。用户需要点击该对话框的“Install”按钮来安装 IBM iNotes Control 控件。

图 4. 浏览器弹出的控件安装警告对话框

IBM iNotes Control 控件安装完成后，用户可以通过浏览器的控件管理器来查看管理该控件，管理方法与其他插件类似，这里不再赘述。

预安装方式

此外，IBM iNotes 还提供了一个独立的安装文件（如：IBM_iNotes_ActiveX_Installer_9.exe），该文件可以从 IBM Domino 服务器 data/domino/html 路径下获得。终端用户只需在其客户端双击该安装文件按照其向导完成安装即可，方法如同安装其它应用程序一样。安装完成后，IBM iNotes 用户登录其邮箱操作附件时就可以使用 IBM iNotes Control 控件的功能了。

IBM iNotes Control 控件的升级方式

在线升级方式

在线升级方式即终端用户通过 web 的方式登录其 iNotes 邮箱并升级 IBM iNotes Control 控件的方式。用户升级 ( 即安装新版本 )IBM iNotes Control 控件有如下 2 种情况：

第一种情况，即已安装的 iNotes Control 控件与预安装的 iNotes Control 控件的大版本号一致，如已安装的控件版本号是 90.1.9.0，预安装的控件版本号是 90.2.7.0，则大版本号 90 是相同；
第二种情况，即已安装与预安装的 iNotes Control 控件的大版本号不一致，如已安装的控件版本号是 85.3.6.0，预安装的控件版本号是 90.2.7.0，则大版本号 85 和 90 是不同的。

终端用户登录到 iNotes 邮箱访问附件区域时，IBM iNotes 会自动检测是否有新版本的 IBM iNotes Control 控件，如果没有，继续使用已安装的 iNotes Control 控件。如果有：

在上述第一种情况下，则会升级安装新版本的控件，步骤与全新安装一致。安装完成后，从 IE 浏览器的控件管理器中可以查看到 IBM iNotes Control 控件信息已经更新到新版本的信息；
在上述第二种情况下，则会全新安装一个新版本的 IBM iNotes Control 控件，并保留已安装的控件，从 IE 浏览器的控件管理器中可以查看到 2 个 iNotes Control 控件，如图 5 所示。当用户邮箱使用的是低版本的 iNotes 模板时会使用相匹配的低版本 iNotes Control 控件，当用户邮箱使用的是高版本的 iNotes 模板时会使用高版本的 iNotes Control 控件。如 : 用户邮箱使用的模板是 8.5.3 Fixpack 6 的模板，则用户安装的 Control 控件版本号会是 85.3.6.0。当 Domino 服务器升级到 9.0.1 Fixpack 2 后，新创建的用户或者邮箱模板替换成 9.0.1 Fixpack 2 模板的老用户登录其邮箱则会提示其安装新版本的 iNotes Control 控件，版本号是 90.1.9.0，从 IE 的控件查看器里面可以查看到 2 个 iNotes Control 控件。此时在用户的客户端，如果访问的邮箱模板是 8.5.3 Fixpack 6 的模板，则会使用相匹配的低版本 85.3.6.0 控件，如果访问的邮箱模板是 9.0.1 Fixpack 2 的模板，则会使用相匹配的高版本 90.1.9.0 的 IBM iNotes Control 控件。

图 5. IE 控件管理器中 2 个 IBM iNotes Control 控件

预升级方式

如果是上述第一种情况，则会升级老版本的 IBM iNotes Control 控件到新版本，安装方法与上述预安装控件方法一样。安装完成后，从 IE 浏览器的控件管理器以及操作系统的控制面板里面都可以查看到 IBM iNotes Control 控件的新版本号等信息。

如果是上述第二钟情况，则会全新安装一个 IBM iNotes Control 控件，不会覆盖老版本的控件，新老版本控件并存。同样地，安装方法与上述预安装方法一样，安装完成后，从 IE 浏览器的控件管理器以及操作系统的控制面板里面可以查看到这 2 个 IBM iNotes Control 控件的版本号、安装目录等信息。

自定义升级方式

通常地，IBM iNotes Control 控件的升级是在 Domino 服务器升级后进行的。IBM iNotes 还提供了一种在未升级 Domino 服务器的情况下升级安装高版本 IBM iNoes Control 控件的方法，方法如下：

覆盖 Domino 服务器端 data/domino/html 路径下的 iNotes Control 控件的安装文件，如：覆盖替换 dwwo ka85W.cab 为 dwa9W.cab 以及覆盖替换 dwa85res_en.dll 为 dwa9res_en.dll；
覆盖 Domino 服务器端 data/iNotes 路径下的 Forms 文件，如：覆盖替换 Forms85.nsf 为 Forms9.nsf；
解压步骤 1 中的 cab 文件，打开 *.inf（如：dwa9W.inf）文件获得该 iNotes Control 控件的版本以及安装信息，如下图 6 为 9.0.1 Fixpack 2 的 dwa9W.cab 文件解压后，dwa9W.inf 的文件内容；
在 Domino 服务器端的 notes.ini 中添加参数 iNotes_WA_UploadOverride，样式为：

iNotes_WA_UploadOverride=clsid:clsid 标识 dll 文件名 | Control 控件版本号。这些参数值可以步骤 3 中的 *.inf（如：dwa9W.inf）文件中获得。如下为 9.0.1 Fixpack 2 的 Control 控件自定义升级的 notes.ini 中的参数设置：

iNotes_WA_UploadOverride=clsid:1788C32A-D79D-4B64-A410-8C554B126889|dwa9W.cab|90,1,9,0

图 6. 一个 dwa9W.inf 文件中的控件版本及安装信息

IBM iNotes Control 控件支持脱机模式

所谓 IBM iNotes Control 控件支持脱机模式，即在 IBM iNotes 的脱机模式下（IBM iNotes 脱机功能的相关知识可以参考 DW 上的另一篇文章《 IBM iNotes 脱机功能及应用实践》），iNotes Control 控件可以使用在线模式下已经安装的控件。如果 iNotes 在线模式下没有安装该控件，也可以在脱机模式下安装该 IBM iNotes Control 控件，同样地，脱机模式下安装的 iNotes Control 控件在在线模式下同样可以使用。安装方法与上述的在线安装方法一样。

IBM iNotes Control 控件安装需要注意的其他事项

IBM iNotes Control 控件的在线安装方式，在 9.0.1 版本之前只支持系统管理员 Administrator 的在线安装，安装目录为 C:/Windows/Downloaded Program Files。从 9.0.1 开始支持操作系统普通用户以及具有 Administrator 权限的普通用户的在线安装方式。具有 Administrator 权限的普通用户的在线安装方式即普通用户鼠标右键单击 IE 浏览器，以 Administrator 权限运行 IE 浏览器，然后在线安装 IBM iNotes Control 控件的方式。这两种方式的安装目录分别为 C:/Users/ 普通用户名 /AppData/Local/Microsoft/Internet Explorer/Downloaded Program Files 以及 C:/Windows/Downloaded Program Files；
IBM iNotes Control 控件的预安装方式，支持操作系统的系统管理员以及普通用户的安装；
目前 IBM iNotes Control 控件只有 32bit 的版本，目前只可以工作在 32bit 的 IE 上。

回页首

IBM iNotes Control 控件的基本应用

IBM iNotes Control 控件安装完成后，创建新邮件的附件域显示如图 7 所示，图中的 5 个图标依次为：选择文件、删除选择文件、大图标、列表以及详细信息。

图 7. 安装 iNotes Control 控件安装后邮件附件区域显示图

IBM iNotes Control 控件提供的基本功能包括：

点击图 7 中图标可以从本地文件夹中选择多个附件同时上传到附件域；
点击图 7 中图标可以删除从附件域中选择的多个附件；
点击图 7 中后 3 个图标可以分别按照大图标、列表以及详细信息等种方式显示附件，默认按照附件文件名升序排列；
如果按照详细信息方式显示排列附件，除了可以按照文件名排列附件，还可以按照附件大小，附件修改时间排列附件。图 8 为按照附件大小降序排列。
通过进度条显示附件上传进度，这对于大附件上传来说很有帮助；
支持通过拖拽的方式将本地文件上传到附件域，相反，也支持通过拖拽的方式将附件域中的附件下载到本地。

图 8. 按照附件大小排列附件

IBM iNotes 除了具有上述的基本应用，还具有如下即将详细介绍的高级应用，即将 IBM iNotes 设置成缺省的邮件客户端以及支持安装浏览器缓存管理控件，从而当用户退出 iNotes 时，浏览器缓存管理控件可以根据安全设置等级清除本地文件夹中储存的用户相关信息。

回页首

IBM iNotes Control 控件的高级应用

设置缺省的邮件客户端

安装了 IBM iNotes Control 控件之后，当使用 IE 访问 IBM iNotes 时，在用户首选项的基本配置页面可以将 IBM iNotes 设置成缺省邮件客户端，如图 9 所示。

图 9. 设置缺省邮件客户端

点击上图中的‘设置为缺省值’按钮，然后保存首选项设置，再次打开首选项页面，可以看到 IBM iNotes 已成功设置为缺省的邮件客户端，如图 10 所示，此时‘设置为缺省值’按钮显示为灰色不可点击状态。

图 10. IBM iNotes 已设置为缺省邮件客户端

此时查看操作系统的缺省程序设置页面，如图 11 所示，可以看到系统 mailto 协议以及 MAPI 邮件编写应用程序接口已将默认程序设置为 IBM iNotes。

图 11. 系统缺省程序设置

如果用户想取消 IBM iNotes 为系统缺省邮件客户端，只需要在上述窗口中取消 mailto 和 MAPI 勾选即可。此时，IBM iNotes 的用户首选项配置页面的‘设置为缺省值’按钮又会恢复为可点击状态。

IBM iNotes 一旦被设置成系统缺省邮件客户端之后，具备以下能力：

任何网页或文档中如果包含由 mailto 协议定义的邮件地址，点击该地址，即可通过 IE 浏览器自动启动 IBM iNotes 访问用户邮箱，打开写邮件的页面，并该邮件地址被自动填充到收件人域，用户可以很方便地向该邮件地址发送邮件；
Windows 系统给本地文件提供了 send to 功能用于快捷发送文件，通过邮件缺省客户端的设置，利用 MAPI 接口，send to 功能可以通过 IE 浏览器自动启动 IBM iNotes 访问用户邮箱，打开写邮件页面，并将该本地文件自动上传至附件域。如图 12 所示。利用 MAPI 接口，还可以将 IBM iNotes 与其他文档处理应用程序关联起来，例如 Microsoft Office，Adobe Reader 等，快捷地将文档以邮件附件形式发送给他人。

图 12. MAPI 接口关联邮件发送附件

支持浏览器缓存管理控件的安装

作为基于 Web 的应用程序，IBM iNotes 利用 Web 浏览器缓存机制，在访问邮件数据库时，将一些常用的服务器资源，用户信息缓存到本地，这样当客户端再次向服务器发送相同请求时，可以从本地缓存中响应请求，从而达到减少网络带宽消耗，降低服务器压力，减少网络延迟，加快页面打开速度的目的。

虽然浏览器缓存可以提高响应速度，但是将某些用户信息，或数据库资源缓存到本地也带来安全隐患，为了降低风险，IBM iNotes 提供了浏览器缓存管理功能，这一功能也是通过 IE 的 ActiveX 控件实现的。当用户退出邮箱时，浏览器缓存管理控件可以根据安全等级设定，清除缓存到本地的文件。

需要指出，只有安装了 IBM iNotes Control 控件之后，才能安装浏览器缓存管理控件。如果未安装 IBM iNotes Control 控件，在用户首选项左侧大纲中是看不到注销选项的。

若安装了 IBM iNotes Control 控件，在首选项注销页面，点击‘安装’按钮即可安装浏览器缓存管理控件，如图 13 所示。安装成功后，关闭浏览器下次登录 IBM iNotes 时，浏览器缓存管理控件即可生效。

图 13. 安装浏览器缓存管理控件

浏览器缓存管理控件安装成功之后，会显示在 IE 浏览器的 Add-on 列表中，如图 14 所示：

图 14. IE add-on 列表

有了浏览器缓存管理控件，当用户从 IBM iNotes 注销时，该控件会根据安全等级设置清除缓存在本地的文件，如图 15 所示：

图 15. 注销时清除浏览器缓存页面

Domino 服务器管理员可以从服务器配置文档，IBM iNotes 页面对浏览器缓存管理控件进行设置，包括是否启用该功能，是否自动安装浏览器缓存管理控件，以及设定缓存清除等级（安全等级从 0 到 5，0 最低，5 最高，等级越高缓存文件清除得越彻底），如图 16 所示：

图 16. 浏览器缓存管理配置页面

用户可以从 IBM iNotes 首选项注销页卸载该控件，如图 17 所示。需要注意，只有在安装了 IBM iNotes Control 控件的情况下，才可以卸载浏览器缓存控件，因此在卸载 IBM iNotes Control 控件时，请先在 IE 的 Add-on 列表中查看是否有浏览器缓存控件，如果有，请先卸载浏览器缓存管理控件，否则卸载了 IBM iNotes Control 控件之后会导致浏览器缓存管理控件无法卸载。

图 17. 卸载浏览器缓存管理控件

回页首

IBM iNotes Control 控件的卸载

对于不同的安装方式，IBM iNotes Control 控件有其对应的卸载方式。

通过 IE 浏览器端卸载控件

通过 IE 浏览器端在线安装的 IBM iNotes Control 控件，作为 IE 浏览器端的插件存在，用户可以通过浏览器端的管理插件页面将其移除。

iNotes 用户需要退出其 iNotes 邮箱，保证 IBM iNotes Control 控件当前没有被使用；
从 IE 浏览器的管理插件页面中选中 IBM iNotes Control 控件，并选择左下方的“更多信息”，或者右键单击 IBM iNotes Control 控件，选择“更多信息”，则会弹出“更多信息”对话框 ;
在弹出的“更多信息”对话框中，用户通过单击“移除所有站点”及“移除”按钮如图 18 所示即可移除 IBM iNotes Control 控件。

图 18. 删除 IBM iNotes Control 控件

用户如果想彻底地清除 IBM iNotes Control 控件，则需要从注册表中删除与该控件的 clsid（参看图 6 中显示的 clsid）相关的所有条目。

通过添加 / 删除程序卸载

通过预安装方式安装的 IBM iNotes Control 控件 , 用户需要通过控件面板中添加 / 删除程序的方式进行卸载 , 卸载方法与其他应用程序的卸载方式一样，比较简单，这里不再赘述。需要用户注意两点，第一，预安装方式安装的 IBM iNotes Control 控件不可以通过浏览器的方式进行卸载；第二，卸载前用户需要退出其 iNotes 邮箱，保证该控件当前没有被使用。

回页首