FuYi Li
高级软件工程师, IBM Lotus
2005 年 8 月 25 日

本文描述了 WebSphere Portal 5.l 中 Common Personal Information Management Portlet (CPP) 的功能和配置选项，并重点介绍了 Common Mail Portlet。CPP 包括 Common Mail Portlet 和 Common Calendar Portlet。CPP 提供了一个丰富的用户界面，充分利用了门户服务，并支持一系列 PIM 解决方案，其中包括 IBM Lotus Domino、Microsoft Exchange、Internet 消息访问协议（Internet Message Access Protocol，IMAP），以及邮局协议（Post Office Protocol，POP3）。

引言
IBM® WebSphere® Portal 5.1 中引入了 Common Personal Information Management (PIM) Portlet，它包括两个 Portlet，即 Common Mail 和 Common Calendar。CPP 提供了一个用户界面和访问一系列 PIM 解决方案的用户体验，其中包括 IBM® Lotus® Domino、Microsoft® Exchange、IMAP 以及 POP3。在 WebSphere Portal 5.1 中，Common Mail Portlet 支持 Domino、Exchange 2000、POP3 和 IMAP。Common Calendar Portlet 支持 Domino。

本文描述了 CPP 中的一些功能和配置选项。文章的最后一部分还介绍了如何自定义提供程序服务配置以支持 PIM 系统。本文是为系统工程师、门户开发人员和应用程序集成人员撰写的。

Common PIM Portlet 是在可扩展的体系结构上构建的。用户界面通过 Common Messaging API 与不同的后端进行交互。CPP 有一个支持各种后端系统的功能的用户界面。该用户界面随后端的功能的不同而改变。例如，客户机来自于一个这样的企业：该企业使用 CPP 访问内部 Domino 邮件系统，还允许使用 CPP 通过 POP3/IMAP 协议来访问外部 Internet 邮件。当 CPP 访问 Domino 邮件时，用户将看到文件夹管理、外部服务和启动（Notes 客户机等）功能。然而，当使用 CPP 访问外部 POP3 邮件服务器时，用户则看不到文件夹管理、外部服务和启动功能。POP3 协议不支持这些功能。有关详细的功能比较，请参阅附录 A。

对于一家拥有多个 PIM 系统（如 Exchange、Domino 和 POP3/IMAP 服务器）的企业来说，当访问不同的后端系统时，CPP 会向用户提供同样的用户体验。因此，CPP 是否能够在培训和技术支持方面降低总拥有成本 (TCO) 可能存在争议。本文后面的部分将重点介绍用户体验和高级功能，包括文档库 (Document Library) 集成、用于以 HTML 格式查看附件的文档转换、Address Finder，以及 Common Mail Portlet 中的 C2A。对于只希望使用 Portlet 连接到一个后端的企业来说，管理员或系统工程师可以通过配置文件轻松地删除其他适配器。本文后面的部分还会介绍如何删除适配器。

IBM Workplace Messaging Server 如图 1 所示，但是它在 WebSphere Portal 5.1 中不受支持。

图 1. Common PIM Portlet 体系结构

Common Mail Portlet 中的一些功能
这一部分描述了适用于所有邮件后端系统的 Common Mail Portlet 的功能。其中有一些功能是随 WebSphere Portal 一起提供的。因此，您可能还会在其他的 WebSphere Portal 应用程序中看到它们。Common Mail Portlet 与这些 WebSphere Portal 功能进行了很好的集成，并向用户提供了一组丰富的用户功能。

使用人员识别和人员链接菜单
人员识别 (People awareness) 是 WebSphere Portal 中内置的的一个功能。CPP 在有电子邮件地址的地方利用该功能。在收件箱 (Inbox) 和邮件 (Message) 视图页中，人员的姓名以超链接的形式出现，例如图 2 中的“wps admin”。当单击该链接时，可以看到包含一组操作的菜单：发送电子邮件 (Send E-mail)、开始聊天 (Start Chat)，以及显示人员记录 (Show Person Record)。

用户不需要使用 IBM Lotus Instant Messaging 服务器来获取人员链接 (Person link) 菜单。然而，当为 WebSphere Portal 配置了 IBM Lotus Instant Messaging 服务器时，人员链接菜单只显示人员的状态，例如，活动 (Active)、离开 (Away)、脱机 (Offline)，以及请勿打扰 (Do not disturb)。只有上下文中的人联机时才能显示“开始聊天”操作。有关详细信息，请参阅 WebSphere Portal Information Center。有关如何配置或启用该功能的详细信息，请参阅 Configuring WebSphere Portal and Lotus Domino for the Common PIM Portlets。

图 2. 人员识别页

使用文档库集成
WebSphere Portal 提供了一个允许用户存储和共享文档的文档库。通过将电子邮件系统和门户文档库系统相集成，向用户提供了一种将邮件附件或邮件内容下载到文档库或者将附件从文档库上传到邮件系统的简便方法。下一部分将介绍如何将邮件保存到文档库。这一部分向您展示如何从文档库中加载附件以及将附件保存到文档库。

1. 从文档库中加载附件：
   1. 转到撰写邮件 (Compose a Message) 页（请参见图 9）。
   2. 在“Compose”页上，单击 Browse Document Library。可以看到弹出一个文档选择器 (Document Picker) 对话框，如图 4 所示。可以浏览文档库并选择需要附加到电子邮件的文件。
   3. 选择该文件后，单击 OK。对话框关闭。可以看到撰写邮件页的附件列表框中列出了该文件，如图 3 所示。

      图 3. 撰写邮件页——附件部分
      

      图 4. 文档选择器——浏览文档库页
      

2. 将附件保存到文档库中：
   1. 打开带有附件的邮件。可以看到一个眼镜图标和一个文件图标，如图 5 所示。
   2. 单击文件图标。将出现“Save to Document Library”对话框，如图 7 所示。文件名称 (File name) 字段中预填写了附件的名称。
   3. 选择需要保存附件的文件夹，并单击 OK。

      图 5. 查看邮件页
      

将邮件保存到文件或文档库
客户往往需要将邮件的内容保存到文件系统或 WebSphere Portal 文档库。该功能使得在用户的邮件系统和外部的文件存储系统之间进行内容交换更加简单。

有两个地方可以调用该功能：

1. 从收件箱页：
   1. 选择一个或多个邮件。
   2. 单击 Actions 菜单。
   3. 选择 Save Message to File。将出现保存邮件 (Save message) 页，如图 6 所示。
   4. 单击链接，将出现一个新的包含邮件的浏览器窗口。

      图 6. 保存邮件页
      

2. 从查看邮件页：
   1. 打开一个邮件。
   2. 单击 Actions 菜单。
   3. 选择 Save Message To，并从子菜单中选择 File 或者 Document Library。
   4. 如果选择文件，则可以看到如图 6 所示的保存屏幕。接下来，可以单击链接。将出现一个新的包含邮件内容的浏览器窗口。可以通过单击浏览器“File”菜单中的“Save”命令来保存邮件。
   5. 如果选择文档库，则会看到弹出一个“Document Picker”对话框，如图 7 所示。可以浏览该文档库来将邮件保存到需要存储邮件的文件夹。

图 7. 文档选择器——保存到文档库页

查看附件
当用户在电子邮件中接收到附件时，即使没有安装创建文档的应用程序，Common Mail Portlet 也会使用 WebSphere Portal 附带的文档转换功能来将附件转换成 HTML 格式，并在弹出的窗口中显示它们。有关文档转换服务的详细信息，请参阅 WebSphere Portal Information Center。

通过打开带有附件的邮件，可以启动附件查看器 (Attachment Viewer)。在查看邮件页中，单击附件名称旁边的眼镜图标。将在弹出的窗口中显示附件的内容。

使用 View Printable Version
在查看邮件页中，可以使用“Actions”菜单下面的“View Printable Version”来显示只包含邮件内容的弹出窗口。可以使用浏览器打印功能来打印没有门户修饰的邮件。

查找地址
在撰写邮件页中：

1. 单击 To、cc、bcc 链接或 Find Addresses 按钮，显示 Directory Search 窗口。
2. 在“Directory Search”窗口中，在“Search for”字段中键入用户名/组名或者用户名/组名的前几个字符，然后单击 Search。“Search results”列表框中将列出门户目录（WebSphere Portal 使用的目录）中匹配的用户或组的列表。
3. 突出显示一个或多个用户/组，然后单击 To、cc 或 bcc 按钮。
4. 单击 OK 后，系统会将这些用户/组的电子邮件地址追加到 To、cc 或者 bcc 字段中。Find Addresses 是另一个 WebSphere Portal 共享组件。

图 8. 目录搜索

使用拼写检查
拼写检查是 WebSphere Portal 的另一个内置功能。当撰写邮件时，Common Mail Portlet 使用此门户功能对主题和邮件正文进行拼写检查。通过单击 Compose 页上的 Check Spelling 按钮，可以显示拼写检查窗口。

图 9. 撰写邮件页和拼写检查

使用签名页
如果希望发出的电子邮件始终包含一些信息（如联系信息），可以在使用偏好 (preferences) 页（编辑模式）中打开此功能。可以以多格式文本或纯文本创建或者编辑签名，如图 10 所示。

图 10. 编辑签名页

使用一点即动功能
一点即动（Click-to-Action，C2A）是 WebSphere Portal 的一个功能，通过一次单击，使您能够将数据从一个 Portlet 传送到另一个 Portlet，并触发跨 Portlet 交互。

例如，Common Mail Portlet 公开了三个 C2A 操作以显示撰写邮件页：

1. MailToType：显示不包含预填写的收件人电子邮件地址的撰写邮件页。
2. EmailAddrType：显示 To 字段中有一个电子邮件地址的撰写邮件页。电子邮件地址是 C2A 参数 value 的输入内容。该参数的类型是 String。
3. EmailAddrListType：显示 To 字段中有一个或多个电子邮件地址的撰写邮件页。电子邮件地址是 C2A 参数 value 的输入内容。该参数的类型是 String。如果字符串包含多个地址，地址之间用逗号分隔。

通过一次单击，同一页上的其他 Portlet 可以使用该 C2A 功能来显示撰写电子邮件页。可以通过 C2A 操作将电子邮件地址从生成操作的 Portlet 传送到 Common Mail Portlet。例如，您需要创建一个客户联系人列表 Portlet。该 Portlet 包括客户的姓名、电子邮件地址、电话号码以及联系信息。当用户单击客户联系人列表 Portlet 中客户的电子邮件地址时，可以允许他们撰写和发送电子邮件。可以将 C2A 用于客户的电子邮件地址。当用户单击客户电子邮件地址时，系统会显示一个撰写邮件页，用户可以通过该页面将电子邮件发送给客户。使用该功能，用户可以在没有显式转到 Mail Portlet 的情况下发送电子邮件，还可以在“To”字段中自动预填写收件人的电子邮件地址。

下面是一个有关如何在另一个 Portlet 的 JSP 页中使用三个 C2A 操作的代码示例：

            <%@ page language="java" contentType="text/html;charset=utf-8"%>
            <%@ page session="false" %>
            <%@ taglib uri="/WEB-INF/tld/c2a.tld" prefix="C2A" %>
            <%@ taglib uri="/WEB-INF/tld/portlet.tld" prefix="portletAPI" %>
            <%
            String aEmailAddress = "wspadmin@us.ibm.com";
            String emailAddresses = "wspadmin@us.ibm.com,lwpdev,
            susanadams1@us.ibm.com";
            %>
            <portletAPI:init />
            Common Mail Portlet supports the following C2A actions:
            <br>
            1.Compose a new message:<C2A:encodeProperty name="method"
            namespace="http://www.ibm.com/wps/c2a/lwp/ComposeMessage"
            type="MailToType" value="new"/>
            <br>
            2.To one e-mail address:<C2A:encodeProperty name="emailAddress"
            namespace="http://www.ibm.com/wps/c2a/annapolis/PeopleFinder"
            type="EmailAddrType" value="<%=aEmailAddress%>"/>
            <br>
            3. To a multiple e-mail addresses: <C2A:encodeProperty name="emailAddressList"
            namespace="http://www.ibm.com/wps/c2a/lwp/ComposeMessage"
            type="EmailAddrListType" value="<%=emailAddresses%>" />
            <br>
            

图 11 显示了上面的编码示例的结果。有关 C2A 的详细信息，请参阅 WebSphere Portal Information Center。

图 11. C2A 示例

自定义 Common Mail Portlet
这一部分介绍了如何自定义 Portlet。如引言部分所述，CPP 是在可插入、可扩展的体系结构上构建的。可以轻松地将新的适配器添加到系统中，以将其与 Common PIM Portlet 一起使用。这一部分向您展示了如何删除适配器。例如，假设您所在的单位没有 Microsoft Exchange。将 Exchange 作为一个选项列出可能会使管理员感到混乱。在本例中，可以在名为 %WAS_HOME%/properties/cpp/config 的目录中修改 ProviderFactory.properties 和 ProviderFactoryNLS.properties 文件。

在两个文件中删除或注释掉 mail_exchange2k=xxxx。这两个文件如下：

            #
            # Licensed Materials - Property of IBM.
            # 5724-E47
            # (C) Copyright IBM Corp. 2002,2003,2004. All Rights Reserved
            # US Government Users Restricted Rights - Use, duplication or
            # disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
            #
            mail_pop3=com.ibm.workplace.mailbox.adapter.pop3.Pop3Mail
            ProviderConfig
            mail_domino = com.ibm.workplace.provider.domino.DominoMail
            ProviderConfig
            #mail_workplace = com.ibm.workplace.common.service.WorkPlaceMail
            ProviderConfig
            mail_imap=com.ibm.workplace.mailbox.adapter.imap.IMAPMailProviderConfig
            #mail_exchange2k=com.ibm.workplace.mailbox.adapter.exchange.Exchange2KMail
            ProviderConfig
            #mail_mymailservice = com.mycompany.mailbox.adapter.myadapter.MyMail
            ProviderConfig
            

            #
            # Licensed Materials - Property of IBM.
            # 5724-E47
            # (C) Copyright IBM Corp. 2002,2003,2004. All Rights Reserved
            # US Government Users Restricted Rights - Use, duplication or
            # disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
            #
            ## G11N DNT
            mail_pop3 = POP3
            mail_imap = IMAP4
            mail_workplace = Lotus Workplace Messaging
            mail_domino = IBM Lotus Domino
            #mail_exchange2k = Exchange 2000
            #mail_mymailservice = my mail service
            

删除 Exchange 适配器服务以后，将无法看到邮件来源中列出的 Exchange 服务，如图 12 所示。

图 12. 邮件配置页

与删除提供程序服务类似，可以通过在 ProviderFactory.properties 文件中添加服务配置文件来添加服务。在 ProviderFactoryNLS.properties 文件中添加服务的显示名称。将服务配置文件与提供程序服务一起打包。例如，Domino 服务配置文件如下所示：

            #
            # Licensed Materials - Property of IBM.
            # 5724-E47
            # (C) Copyright IBM Corp. 2002,2003,2004. All Rights Reserved
            # US Government Users Restricted Rights - Use, duplication or
            # disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
            #
            Mail_Delegate = com.ibm.workplace.mailbox.provider.domino.DominoMailbox
            Delegate
            Calendar_Delegate = com.ibm.workplace.calsched.provider.domino.Domino
            CalSchedDelegate
            mailProviderHostName = true
            mailProviderHostPort = true
            mailProviderHostSecure = true
            mailProviderHostSecurePort = true
            mailProxyServerName = true
            mailProxyServerPort = true
            mailUserId = true
            mailPassword = true
            mailFilePath = true
            mailFileId = true
            authenticationModel = true
            basic = true
            sso = true
            ltpaToken = true
            auto_provision = false
            mailSource=true
            validate_email_address = false
            

添加新的适配器
为 PIM 提供程序添加新的适配器（例如，为 Domino 添加地址簿适配器）后，可以在该配置文件中轻松地定义适配器类，并使用提供程序服务来加载新的适配器。例如，在此版本中，当 CPP 与 Domino 后端交互时，只支持邮件 (Mail) 和日历 (Calendar)，因此只能看到 Domino Mail 适配器 (com.ibm.workplace.mailbox.provider.domino.DominoMailboxDelegate) 和 Domino Calendar 适配器 (com.ibm.workplace.calsched.provider.domino.DominoCalSchedDelegate)。它们都是在 Domino 提供程序属性文件中定义的。

更改配置文件
在提供程序服务配置文件中，还可以为提供程序设置配置参数。例如，如果不需要支持代理服务器，可以设置 mailProxyServerName = false。因此在编辑模式下，邮件和日历配置页中不会显示该代理服务器。

总而言之，ProviderFactory.properties 文件包含实现公共接口的所有提供程序。通过向 ProviderFactory.properties 文件中添加提供程序配置属性文件名，可以将新的提供程序添加到所支持的提供程序列表中。

更改转换的属性文件
ProviderFactoryNLS.properties 文件包含可更改为转换语言的提供程序显示名称。转换的属性文件有一个语言扩展名。例如，ProviderFactoryNLS_de.properties 包含德语的提供程序名称。

提供配置属性文件
每一个提供程序都需要提供一个配置属性文件。其名称必须与包含在 ProviderFactory.properties 文件中的属性文件名相匹配。该提供程序配置属性文件包含实现类。提供程序还可以在配置属性文件中提供特定的后端配置数据。例如，如果提供程序需要文件路径的信息来连接到用户的邮箱，可以将文件路径的设置添加到属性文件中。在 CPP 编辑模式下，在邮件来源页上会显示文件路径字段。

作为一个新的提供程序，该提供程序只需：

1. 提供实现公共接口的适配器。
2. 创建一个属性文件，使其包含实现类和配置数据。
3. 将上面创建的属性文件添加到 ProviderFactory.properties 文件中。

然后，可以使用 CPP 连接到新的提供程序，该程序的用户界面与 CPP 为其他 PIM 解决方案提供的用户界面相同。

注意：修改属性文件以后，请重新启动门户服务器以查看更改。

结束语
本文介绍了 CPP 如何利用 WebSphere Portal 的内置功能来增强用户的电子邮件体验。对于 CPP 支持的所有 PIM 解决方案来说，这些功能是相同的。本文中没有详细描述的功能（例如，邮件标志、邮件发送选项以及文件夹操作）可能随着使用的后端的不同而改变。本文还展示了如何添加或删除适配器，以及如何在提供程序属性文件中更改适配器的配置。另外，您还可以在 Portlet 配置和编辑模式下自定义用户体验。

附录 A. 所支持的 PIM 提供程序的功能比较
引言部分曾提到过，将 CPP 配置为不同的后端时，它支持不同的功能。图 13 显示了不同的邮件提供程序之间的一些区别。

图 13. 功能比较

致谢
作者真诚地感谢 Luciano Resende 提供图 13 所示的功能比较表。