在本文中，我们将向您展示如何配置 IBM Workplace Collaboration Services，如何部署从 IBM Workplace Managed Client 可访问的富客户机应用程序，以及如何创建和应用用户策略。

IBM Workplace Client Technology 基于 Eclipse 平台，而后者充当构建可定制和可扩展的应用程序的框架。使用 Workplace Client Technology，可以构建支持诸多特性的富客户机应用程序，比如以脱机方式工作的能力、数据同步、本地数据存储、认证，等等。此外，Workplace Client Technology 还提供以下能力：交付客户机应用程序、升级这些应用程序、为用户应用和管理策略，以及通过一个中央管理服务器完成所有这些工作。

本文解释如何：

• 对于示例应用程序使用 Eclipse 作为插件开发环境（Plug-in Development Environment，PDE），创建一个更新站点项目（update site project）。
• 向更新站点配置和安装示例特性/插件。
• 在 IBM WebSphere Portal 上配置和布局基于富客户机平台标记语言（Rich Client Platform Markup Language，RCPML）的 portlets 和页面。
• 使用 IBM WebSphere Application Server Administrative 控制台创建一个 IBM Workplace Managed Client 用户策略。
• 为 WebSphere Portal 上基于 RCPML 的 portlets 和页面分配用户策略。
• 向 Workplace Managed Client 添加 RCPML Page 参数。
• 通过遍历示例插件，从 IBM Workplace Collaboration Services 服务器供应（provision）和升级应用程序。

本文假设您是有经验的 Eclipse 插件应用程序开发人员，并且略懂 WebSphere Portal。还假设您有一个现有的 Eclipse 插件，针对您想要部署的应用程序具有一些示例 Eclipse 视图和一个 Eclipse 特性。在本文中，com.xyz.workplaceapp.sample 是指您的示例应用程序插件，com.xyz.workplaceapp.sample.feature 是指需要部署在 Workplace Collaboration Services 服务器上的示例应用程序特性。

使用 Eclipse 作为 PDE 创建更新站点项目

要在 Workplace Collaboration Services 上配置和安装 Eclipse 应用程序，必须首先使用 Eclipse 更新站点项目来创建 Eclipse 特性和插件可安装程序。为此，执行以下步骤。（正如前面所提到的，假设您已经创建了一个示例应用程序插件 com.xyz.workplaceapp.sample 和示例特性 com.xyz.workplaceapp.sample.feature。另外，假设示例插件和特性项目已经存在于 Eclipse 工作区中。）

1. 在 Eclipse 中，选择 Window - Open perspective - Other - Plug-in Development 并打开 Plug-in development 透视图。
2. 在 Plug-in development 透视图中，选择 File - New - Project - Plug-in Development - Update Site Project 并单击 Next。
3. 为更新站点项目指定您希望的任何名称并单击 Finish。
4. 在 site.xml 的 Features to Build 选项卡中选择 com.xyz.workplaceapp.sample.feature 特性项目。
5. 创建一个新的编目 WCT，名称与 site.xml 的 Features to Publish 选项卡中的名称相同。
6. 将 com.xyz.workplaceapp.sample.feature 特性从 Features to Build 选项卡拖到 Features to Publish 选项卡，并将它放在刚才创建的 WCT 编目下面。
7. 单击 Build All 按钮构建 Eclipse 更新站点项目，这将创建一个类似于图 1 所示的目录结构。
   
   
   图 1. Eclipse 更新站点项目的目录结构
   
   
   

回页首

配置和安装示例应用程序特性及插件

现在，在 Workplace Collaboration Services 更新站点上安装和更新 com.xyz.workplaceapp.sample 插件项目和 com.xyz.workplaceapp.sample.feature 特性项目。Workplace Collaboration Services 更新站点只是 IBM HTTP 服务器上的 “lwpupdate” 目录（HTTP 服务器已经作为 Workplace Collaboration Services 服务器安装的一部分安装好了）。为此，执行以下步骤。

1. 将 com.xyz.workplaceapp.sample 插件 JAR文件（这是设置 Eclipse 更新站点项目时创建的）复制到 <IHS_HOME>/ht_docs/en_US/lwpupdate/wct/plugins 目录。
   
   注意：示例应用程序插件 JAR 包含 sampleplugin.jar（示例应用程序的运行时库）、plugin.xml 文件、plugin.properties 文件（如果您的插件使用 Eclipse 国际化特性的话）、图标和一些其他目录（如果示例应用程序插件需要的话）。
   
   
2. 将设置 Eclipse 更新站点项目时创建的 com.xyz.workplaceapp.sample.feature 特性 JAR 文件复制到 <IHS_HOME >/ht_docs/en_US/lwpupdate/wct/features 目录。
   
   注意：示例应用程序特性 JAR 包含 feature.xml 和 feature.properties 文件，如果示例应用程序特性使用 Eclipse 国际化的话。
   
   
3. 如果有的话，将应用程序特定的图标（将显示为 Workplace 客户机页面切换图标）复制到 <IHS_HOME>/ht_docs/en_US/lwpupdate/images。
4. 从前面创建的更新站点项目找到并复制 site.xml 中的以下代码行：
   
   

   <feature id=" com.xyz.workplaceapp.sample.feature " url="features/ com.xyz.workplaceapp.sample.feature_1.0.0.jar" version="1.0.0"> <category name="WCT"/> </feature>

   
   
5. 将这些行粘贴到位于 <IHS_HOME>/ht_docs/en_US/lwpupdate/wct 处的 site.xml 的末尾。Workplace Collaboration Services 更新站点上 site.xml 的内容类似于下面所示：
   
   

   <feature url="features/ com.xyz.workplaceapp.sample.feature_1.0.0.jar id=" com.xyz.workplaceapp.sample.feature " version="1.0.0"> <category name="WCT" /> </feature> <category-def label="WCT" name="WCT"> <description>IBM Workplace Client Technology Application</description> </category-def>

   
   

最终的更新站点目录结构类似于图 2 所示。

回页首

在 WebSphere Portal 上创建和配置基于 RCPML 的 portlets

下一步是使用管理向导在 WebSphere Portal 上创建和配置基于 RCPML 的 portlets。每个 Eclipse 视图都映射到单个 RCPML portlet。执行以下步骤在 WebSphere Portal 上配置基于 RCPML 的 portlets。

1. 使用 URL http://<http_server>/lwp/myworkplace（其中 "<http_server>" 是指 IBM HTTP 服务器），作为管理员登录到 Workplace Collaboration Services 服务器，并单击 My Work 页面右上角的 Administration 链接。
2. 转到 Portlets 页面并单击 Manage Portlets 链接，以创建和配置示例应用程序 portlets。选择 Search for portlets 选项，并搜索 RCP Portlet - Generic。选择 portlet found 并单击 Copy 按钮复制该 portlet。
3. 选择新创建的 portlet 并单击 Modify Parameters 按钮。
4. 单击 "Set title for Selected Locale" 链接并将 portlet 名称修改为 Eclipse 视图的名称。（视图名称是在应用程序插件的 plugin.xml 文件中指定的。）
5. 确保 portlet 名称与您部署的示例应用程序的 plugin.xml 中指定的 Eclipse 视图名称相同（见图 3）。单击 OK。
   
   
   图 3. 示例插件的部分 plugin.xml 文件，定义了 Eclipse 视图扩展点
   
   
   
   
6. 现在为每个 portlet 配置以下参数：
   • rcpView。在 plugin.xml 中为每个应用程序特定的视图定义的 Eclipse 视图 ID。
   • ratio。每个视图可以在应用程序空间中覆盖的区域。
   • fixed。布尔值，指定视图是否是固定的（右上角没有 X 按钮的视图是固定的）。
   • visible。布尔值，指定视图是否应该总是在 Workplace Managed Client 启动时可见。
   有关所有 portlet 参数的详细列表，请参阅 developerWorks 文章 “在 IBM Workplace Managed Client 中使用应用程序布局”。
7. 单击 Save 返回到 Manage Portlets 窗格。
8. 对于其余基于 RCPML 的 portlets（Eclipse 视图），执行相同的步骤。

回页首

创建 Workplace Collaboration Services 用户策略

为每个 Workplace Collaboration Services 应用程序创建用户访问级别，以允许任何用户下载用户特定的应用程序。可以通过使用 WebSphere Application Server Administrative 控制台来创建用户策略，如下所示：

1. 使用 URL http://<portal_server>:9091/admin（其中 "<portal_server>" 是指作为 Workplace Collaboration Services 服务器安装一部分安装的 WebSphere Portal 实例），登录到 WebSphere Application Server Administrative 控制台。
2. 在左侧的 navigation 窗格中，选择 IBM Workplace Software - Users - Manage User Policies 并单击 New 按钮创建一个新的用户策略。
3. 在创建新的用户策略的同时配置以下参数：
   • 要创建的用户策略名
   • 用户策略描述
   • 策略的独特名称范围（使用 LDAP 目录的 DN 语法）
   • 对用户允许的客户机（基于浏览器的、富客户机，或者两者）
   • 允许访问针对新用户的开箱即用特性。这些特性是邮件、日历、地址簿、文档库、IBM 生产率工具、团队空间、Web 会议、即时消息、学习，等等。您可以为新用户选择一些或所有这样的特性。
4. 单击 Apply 和 Save 保存该策略配置。

回页首

为示例应用程序 portlets 分配 Workplace Collaboration Services 用户策略

为 WebSphere Portal 上基于 RCPML 的 portlets 和页面分配用户访问级别，以允许用户下载和查看示例 Workplace Managed Client 应用程序。执行以下步骤为 portlets 设置用户访问级别：

1. 作为管理员登录到 Workplace Collaboration Services 服务器并单击页面右上角的 Administration 链接。
2. 选择 Access - Resource Permissions - Portlets（见图 4）。
3. 使用上面的步骤，在 WebSphere Portal 上搜索基于 RCPML 的 portlet，例如 SampleView1。
4. 单击 Assign Access（钥匙）图标，为 WebSphere Portal 上基于 RCPML 的 portlet 分配用户策略。
5. 选择 User - Edit Role，并选择 Add。
6. 选择 "all authenticated portal users" 选项。这是默认的 Workplace Collaboration Services 策略。（或者也可以选择用 WebSphere Application Server Administrative 控制台创建的新的 Workplace 用户策略。）
7. 单击 OK 和 Done（两次）应用这些更改。
   
   
   图 4. 向 portlet 分配 Workplace Collaboration Services 用户策略
   
   
   
   
8. 执行同样的步骤为其余示例应用程序 portlets 分配用户策略。

回页首

创建和配置示例应用程序页面（具有惟一的名称）

现在，使用管理向导在 WebSphere Portal 上创建和配置基于 RCPML 的页面。每个 RCPML 页面都映射到 Workplace Managed Client 的单个富客户机应用程序。执行以下步骤在 WebSphere Portal 上配置基于 RCPML 的页面。

1. 作为管理员登录到 Workplace Collaboration Services 服务器并单击右上角的 Administration 链接。
2. 选择 Portal User Interface 并单击 Manage Pages。
3. 搜索 WorkplaceRCPPages 以在 Workplace Collaboration Services 内容根下面添加示例应用程序页面。
4. 编辑右侧的铅笔图标，编辑页面布局。
5. 单击 Edit Properties 按钮，并在 Advanced options 部分的下面，确定 "This page supports..." 选项中是否启用了 HTML 和 RCPML 页面支持。如果未启用，则选择它们并单击 OK，再次单击 OK，然后单击 Done。示例应用程序在支持 HTML 的同时也支持 RCPML 布局。
6. 单击 WorkplaceRCPPages 编目下面的 New Page 选项，创建示例 Workplace 应用程序。将它命名为 SampleApplication（见图 5）。
7. 重复步骤 5，为这个新创建的页面设置 HTML 和 RCPML 支持。
   
   
   图 5. 为要部署的示例应用程序配置页面
   
   
   
   
8. 现在选择 Portal Settings - Custom Unique Names - Pages，并查看新创建的 SampleApplication 页面。
9. 单击铅笔图标，为该页面设置一个惟一的名称。
10. 在 Custom name 域键入任意惟一的名称；我们的例子中键入的是 wmc.sampleApp。单击 OK。

回页首

为示例应用程序页面分配 Workplace Collaboration Services 用户策略

为 WebSphere Portal 上基于 RCPML 的 portlets 和页面分配用户访问级别，以允许 Workplace Collaboration Services 用户下载和查看示例 Workplace Managed Client 应用程序。为此，执行以下步骤。

1. 选择 Access - Resource Permission - Pages。
2. 搜索 SampleApplication 页面。
3. 单击 Assign Access（钥匙）图标，为该页面分配 Workplace Collaboration Services 用户策略。
4. 选择 User - Edit Role，并选择 Add。
5. 选择 "all authenticated portal users" 选项。这是默认的 Workplace Collaboration Services 策略。（或者您也可以选择使用 WebSphere Application Services Administrative 控制台创建的新的 Workplace 用户策略。）
6. 单击 OK 和 Done（两次），应用这些更改。

回页首

布局示例应用程序页面

现在您必须向新创建的 portlet 页面应用一个布局。对 WebSphere Portal 上基于 RCPML 的页面进行布局意味着用户可以确定视图在示例应用程序中的位置。执行以下步骤创建一个页面布局。

1. 作为管理员登录到 Workplace Collaboration Services 服务器，并单击页面右上角的 Administration 链接。
2. 选择 Portal User Interface - Manage Pages。搜索新创建的 SampleApplication 页面。
3. 单击铅笔图标编辑页面布局。
4. 选择一个布局。
5. 在每个布局面板中，单击 Add portlets 按钮。搜索新创建的 portlet 并将它添加到布局面板。单击 OK。
6. 为您创建的所所有 portlets 重复这些步骤。参阅 developerWorks 文章 “在 IBM Workplace Managed Client 中使用应用程序布局”，了解有关布局的更多信息。

回页首

为示例应用程序配置 RCPML 页面参数

需要为在 WebSphere Portal 上创建的基于 RCPML 的示例页面配置额外的参数（activities、default_folder 和 iconpath）。这些参数分别对应用程序支持默认的 Eclipse 活动、支持默认的文件夹以显示视图，以及指定图标路径。执行该配置的惟一方式是使用 WebSphere Portal XMLAccess 界面，步骤如下。

1. 在 Workplace Collaboration Services 服务器桌面上创建一个临时文件夹 (C:\XYZ)。
2. 在临时文件夹中创建一个名为 page_config.xml 的 XML 文件，并将以下内容复制到这个 XML 脚本：
   
   

   <?xml version="1.0" encoding="UTF-8"?> <request xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="PortalConfig_1.2.xsd" type="export"> <portal action="locate"> <content-node action="export" uniquename=" wmc.sampleApp"/> </portal> </request>

   
   其中 uniquename 是指分配给 WebSphere Portal 上您创建的基于 RCPML 的页面的惟一名称。
   
3. 从命令提示符，转到 <Workplace_Server_Home>/PortalServer /bin 目录，并运行下面这个命令：
   
   xmlaccess -in c:\XYZ\page_config.xml -out c:\XYZ\page_config_out.xml -user <Admin_User> -pwd <Admin_pwd> -url 127.0.0.1:9081/lwp/config
   
   
4. 编辑前面创建的 C:\XYZ\page_config_out.xml 文件，并在您创建的示例应用程序页面下搜索以下文本：
   
   <parameter name="bookmarkable" type="string" update="set">Yes</parameter>
   
   
5. 在紧接着搜索到的文本下面，添加下面这个参数列表，并验证您的 XML 文件：
   
   

   <parameter name="activities" type="string" update="set"> com.xyz.workplaceapp.sample..activity</parameter> <parameter name="default_folder" type="string" update="set">main</parameter> <parameter name="iconpath" type="string" update="set">/lwpupdate/images/sample.png</parameter>

   
   
6. 从命令提示符，转到 <Workplace_Server_Home>/ PortalServer /bin 目录并运行下面这个命令：
   
   xmlaccess -in c:\XYZ\ page_config_out .xml -out c:\XYZ\result.xml -user <Admin_User> -pwd <Admin_pwd> -url 127.0.0.1:9081/lwp/config

回页首

从 Workplace Application Services 服务器供应和升级应用程序

要供应 the Workplace Managed 客户机，使用链接 http://<http_server>/lwp/myworkplace 登录到 Workplace Collaboration Services 服务器并单击右侧的 IBM Workplace Rich Client 链接。单击 Start download 链接，自动开始为登录的用户下载客户机。图 6 展示了从 Workplace Collaboration Services 服务器供应的示例应用程序的一部分。

如果您想要修改插件或特性，或者想要添加额外的插件，那么通过指定以下 portlet 参数为更新站点修改特性 id，当部署新的或经过更新的插件时：

id.<feature_version> version.<feature_version> match.<feature_version>

当以在线模式启动 Workplace Managed Client 时，您被要求下载新的更新。当您接受下载时，就下载了新的或经过更新的特性。

回页首

结束语

本文中学习了如何在 Workplace Collaboration Services 服务器上手动地配置、部署和供应示例应用程序，以及如何从服务器供应和升级应用程序。