引入 Common PIM Portlet

petutor

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

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

MailToType：显示不包含预填写的收件人电子邮件地址的撰写邮件页。
EmailAddrType：显示 To 字段中有一个电子邮件地址的撰写邮件页。电子邮件地址是 C2A 参数 value 的输入内容。该参数的类型是 String。
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 示例

petutor

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

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

ProviderFactory.properties： # # 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
ProviderFactoryNLS.properties： # # 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. 邮件配置页

petutor

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

DominoMailProviderConfig.properties： # # 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 编辑模式下，在邮件来源页上会显示文件路径字段。

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

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


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

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

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

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

图 13. 功能比较