BryanDaniel
软件工程师,IBM
2005年7月

了解如何使用IBMWorkplaceCollaborationServicesAPIToolkit，来向IBMWorkplaceportlet添加到场提醒并帮助回答那个古老的问题：有人在吗？

IBMWorkplaceCollaborationServices是一个提供了立即可用的通信和协作服务的集成环境，这些服务使人们可以更有效地工作。WorkplaceCollaborationServices提供了诸如电子邮件、日程表和工作安排、在线培训、即时消息传递、Web会议和文档管理等功能。这些开箱即用的功能提供了一个完全协作的解决方案，该解决方案在许多情况下为您的用户提供了完成工作所需的一切。

此外，WorkplaceCollaborationServices还提供了IBMWorkplaceCollaborationServicesAPIToolkit。该工具箱允许您使用新的协作portlet、服务，或者二者都使用，来扩展WorkplaceCollaborationServices。您可以通过访问工具箱页面来下载IBMWorkplaceCollaborationServicesAPIToolkit。

本文是Workplace应用程序开发系列文章的第一篇。本文介绍了如何使用IBMWorkplaceCollaborationServicesAPIToolkit来向Workplaceportlet添加到场提醒。我们将以对该工具箱的简短概述开始，然后讨论向portlet添加到场提醒所涉及的步骤。本文假定您是一个有经验的Java开发人员，并熟悉IBMWorkplaceCollaborationServices。要了解更多信息，请访问developerWorks上的IBMWorkplace资源中心。

IBMWorkplaceCollaborationServicesAPIToolkit
IBMWorkplaceCollaborationServicesAPIToolkit使开发人员可以使用J2EE编程模型来构建业务组件和portlet。WorkplaceCollaborationServices2.5中的该工具箱提供了下面的公共应用程序编程接口(API)和服务提供者接口(SPI)。

IBMWorkplaceCollaborationServicesJSP标签
WorkplaceJSP标签使portlet开发人员能快速结合由Workplace产品为portlet提供的丰富的协作功能。这次提供的两个标签是人员标签（persontag）和在线中心标签（on-linecentertag）。人员标签提供了命名出现在portlet中的人员的即时协作功能。这提供了动态地表明一个人是否在线的方法，并提供了一个协作功能菜单，如电子邮件和聊天。在线中心标签已经被组合到了Workplace页面的页眉当中，但是您可以把它添加到任何由portlet生成的新窗口中。该标签允许您能够让用户控制他们的在线状态（活动、离开、请勿打扰）。

WorkplaceInstantMessagingSPI
WorkplaceInstantMessagingSPI使您能够在即时消息交付之前截获它们。您可以执行诸如文件过滤、阻塞和即时消息内容翻译等功能。您也可以通过该SPI存档或记录即时消息。您可以把该接口作为服务器上的servlet执行。每次Workplace即时消息传递服务器交付一个消息时它就会执行。

WorkplaceMailMessagingSPI
通过提供邮件处理程序和交付扩展，WorkplaceMailMessagingSPI扩展了Workplace消息传递服务。这两个接口都是作为可以从服务器上执行的类文件实现的。处理程序接口提供了到所有经过消息系统传递的邮件的低级访问。您可以使用多个处理程序来执行诸如病毒扫描和垃圾邮件过滤之类的功能。交付接口使您能够控制将消息交付到哪个文件夹，还可以使用它来更改消息的目的文件夹（如果它违反了一些预定义的业务规则）。

CollaborativeApplicationComponentInterfaces
CollaborativeApplicationComponentInterfaces使开发人员能够构建与现有的IBMWorkplace基础设施集成的业务组件。这些业务组件是作为无状态会话EnterpriseJavaBean(EJB)实现的，并用作表示业务概念、过程和服务的方法。诸如小组日程表、小组任务表、联系人列表和搜索等开箱即用的功能，都是作为业务组件实现的。在构建一个业务组件后，您可以使用WorkplaceBuilder把该组件组合到Workplace应用程序中去。

ComponentandApplicationInfrastructureServicesAPIs
该工具箱中新增的ComponentandApplicationInfrastructureServicesAPIs是由两组截然不同的API组成的：组件服务和应用程序基础设施。组件服务API允许您访问由现有的Workplace业务组件提供的服务。该API允许您执行诸如修改日程表条目、访问讨论主题、创建文档、发送邮件和安排Web会议等功能。这允许您将这些协作行为更深入地集成到自己的解决方案中。

应用程序基础设施API允许您管理Workplace应用程序和应用程序模板。包括创建应用程序和模板、访问应用程序和模板目录以及管理应用程序实例的能力。

IBMWorkplaceClientTechnologyplatformAPIs
该工具箱的另一个新增功能就是IBMWorkplaceClientTechnologyplatformAPIs，它允许您使用自己定制的应用程序来扩展IBMWorkplace客户机平台。您可以使用Web浏览器所不能提供的功能，包括访问操作系统特定用户控制权、使用脱机执行机制和与基于服务器的组件通信。

添加到场提醒
本文的其余部分将演示如何把IBMWorkplaceCollaborationServicesJSP标签结合到现有的portlet中去。我们的目标是要说明可以多快地将一个现有的portlet立即部署在WebSphere应用程序服务器上，并使它在WorkplaceCollaborationServices内运行。在我们的例子中，启用了一个带有上下文相关的菜单的PurchaseOrderportlet，这些菜单向工作场所内的用户提供协作功能。用户不仅能看到谁在进行订购，还可以看到这个人是否在线，通过即时消息传递、电子邮件或二者都用来联系此人，并从公司名录中检索相关信息。这个过程与其他portlet开发人员启动自己的portlet所需的步骤类似。

首先，在一个IDE（如IBMRationalApplicationDeveloper）中打开您的portlet项目。（本文的演示中使用的是RationalApplicationDeveloper。您可以从developerWorks:Rational上下载RationalApplicationDeveloperforWebSphereSoftwareV6.0的测试版。）当前PortalToolkit(V5.0.2.2)中包含的提醒类和标签库不包含与WorkplaceCollaborationServices中提供的同等级别的功能。（注意：IBMWorkplaceCollaborationServices使用了WebSpherePortalV5.0.2.2。）通过打开项目属性并选择Java-BuildPathLibraries-AddExternalJARs，从WorkplaceCollaborationServices服务器添加<install_dir>\WorkplaceServer\lwp_lib\lwp.peoplePersonTagTaglib.jar文件到类路径。重复相同的步骤，添加下列JAR文件：

<!--Displaypurchaseordercontactname--><TDnowrapalign="left"><=POItemBean.getContactPerson()></TD>

<!--Displaypurchaseordercontactname(withawareness)--><TDnowrapalign="left"><pa:personvalueType="EMAIL" value="<=POItemBean.getContactPersonEmail()>" displayName="<=POItemBean.getContactPerson()>"></pa:person></TD>