公开 Heritage 人员服务

除实现业务流程定义（BPD）中的活动外，您在 IBM® Process Designer 中创建的 Heritage 人员服务也可用于定制 Process Admin Console 或者为 IBM Process Portal 创建定制仪表板。服务的公开设置取决于其计划用途。

开始之前

要执行此任务，您必须进入 IBM Process Designer 桌面编辑器中。

有关公开客户机端人员服务的信息，请参阅公开客户机端人员服务。

过程

打开 Process Designer 桌面编辑器。
打开要公开的 Heritage 人员服务，然后单击概述选项卡。
在公开部分，单击公开给旁边的选择以选择其成员可以查看并使用公开的服务的团队。要创建团队，请单击新建。要除去分配的团队，请单击新建旁边的 X 图标。

在公开为列表中，通过选择以下任一选项来指定公开类型。

表 1. 公开选项
选项	描述
不开放（BPD 中包含的服务）	针对实施 BPD 中活动的服务使用此缺省选项。选择此选项时，未使用公开给设置。
管理服务（Process Admin Console 中可用)	在 Process Admin Console 的“服务管理”功能中，使用该选项使传统人员服务可作为单独页面供所选团队的成员使用。将新类别添加到菜单，且该类别与包含服务的流程应用程序名称相同。新类别中单个页面的名称匹配服务名称。
可启动的服务（从 Process Portal 启动）	使用该选项使所选团队的成员能够从 Process Portal 中的“启动”侧边栏启动服务。
仪表板（Process Portal 仪表板菜单中可用）	使用该选项使 Process Portal 中的传统人员服务可供所选团队成员使用。团队成员可通过单击组织图标选项卡并从隐藏页面列表选择仪表板来选择仪表板。如果未指定仪表板名称的本地化资源，那么仪表板页面与公开服务同名。如果为仪表板名称定义了本地化资源，请单击标签字段旁边的选择并选择资源中的键。请参阅使仪表板名称全球化。如果 Heritage 人员服务位于 Toolkit，那么必须完成以下步骤：创建 Toolkit 的 snapshot。激活 Toolkit snapshot。请参阅激活 Snapshot 以便与 IBM Process Portal 配合使用将 Toolkit snapshot 作为依赖关系添加到流程应用程序。请参阅在 Designer 视图中创建、更改和删除工具包依赖关系。如果要在 Process Portal 外公开仪表板，请通过单击从仪表板创建 Portlet 来生成可部署到门户网站服务器的 portlet。
URL（仅通过 URL 获取）	使用该选项，可通过 URL 地址来使用服务。有关为已公开服务提供 URL 的 REST API 的信息，请参阅 BPD相关资源的 REST 界面 - 公开的项目资源。

结果

除向上表中所述的用户界面公开外，所有公开的 Heritage 人员服务都可作为 URL 进行调用。

该 URL 由安装了 IBM Process Center Server 或 Process Server 的主机名，在 IBM Business Process Manager 安装期间为服务器指定的端口，以及包含该服务的流程应用程序的首字母缩略词组成。例如，如果公开名为 MyService 的服务，那么可从以下 URL 对其进行访问：

http://host_name:port/contextRootPrefix/executeServiceByName?processApp=acronym&serviceName=MyService

contextRootPrefix 的缺省值是 teamworks。有关如何配置定制上下文根的更多信息，请参阅 BPMConfig 命令行实用程序主题中的 -update 参数部分。

切记：任何特定于浏览器的 URL 限制（例如 URL 长度和字符限制）均适用，并且在将 Heritage 人员服务作为 URL 进行调用时必须加以考虑。

URL 参数

URL 可以包含以下一个或多个参数：

processApp: 流程应用程序的名称
serviceName: Heritage 人员服务的名称
snapshot: Snapshot 的名称
com.lombardisoftware.errorPage: 错误页面的 URL

输入变量

在 URL 中，为服务定义的输入变量具有以下格式：

&tw.local.variableName=value

99Local.xml 文件中定义了缺省配置。有关更多信息，请参阅99Local.xml 和 100Custom.xml 配置文件。同时，以下示例也显示了如何定制 100Custom.xml 文件以启用 type-string-to-date 配置选项：

<common merge="mergeChildren">
				<type-string-to-date merge="replace">true</type-string-to-date>
</common>

对于 Heritage 人员服务，variableName 可以是系统定义的 SimpleType 或不基于 SimpleType 变量（属于类型 String、Integer、Decimal、Date、Time 和 Selection）的 BusinessObject。Date 或 Time 仅在启用 type-string-to-date 配置选项后才被允许。

限制： type-string-to-date 配置选项仅适用于 Heritage 人员服务。这不适用于客户机端人员服务。

<common merge="mergeChildren">
				<type-string-to-date merge="replace">true</type-string-to-date>
</common>

日期/时间语法

客户机端人员服务和 Heritage 人员服务的日期和时间格式不同。客户机端人员服务和 Heritage 人员服务的其他简单类型的语法（String、Integer、Decimal 和 Selection）相同。

注：有关人员服务中的日期和时间语法的信息，请参阅公开客户机端人员服务。

Heritage 人员服务的日期和时间格式如下：

Date 格式为 YYYY-MM-DD。
Time 格式为 HH:mm:ss。
时区：由于 Heritage 人员服务未提供时区的支持信息，因此，缺省时区设置为服务器的时区。

已调用的服务版本

如果未将特定快照名称传递至 URL，那么运行的服务的缺省版本取决于运行服务的环境。

表 2. 针对每个环境调用的 Heritage 人员服务版本
环境	Heritage 人员服务版本
Process Center	运行缺省跟踪提示中的已公开服务。
Process Server	运行缺省 Snapshot 中的已公开服务。
Process Portal	当在 Process Portal 中将 Heritage 人员服务作为仪表板启动时，所启动的版本是 Heritage 人员服务的当前工作版本（如果此版本已公开）。否则，如果存在其中公开 Heritage 人员服务的活动快照，那么会启动该快照版本。如果当前工作版本未公开，并且存在多个其中公开了 Heritage 人员服务的活动快照，那么会启动最新快照版本。
外部门户网站服务器中的 portlet	在生成仪表板的 portlet 时，只能导出一个有效 Snapshot。在 portlet 传回 IBM Business Process Manager 时，此 snapshot 必须是活动的。