公开传统人员服务（不推荐）

在线编辑

除了在流程中实施活动外，您在 IBM® Process Designer 中创建的传统人员服务还可用于定制 Process Admin Console 或为 IBM Process Portal创建定制仪表板。 服务的公开设置取决于其计划用途。

准备工作

有关公开客户端人员服务的信息，请参阅 定义客户端人员服务的使用设置。

过程

  1. 在 Process Designer
  2. 打开要公开的传统人员服务，然后切换到 概述。
  3. 选择其成员可以查看和使用公开服务的团队。
    在 Process Designer中，在 使用情况下设置 公开以启动 选项。

    在桌面 Process Designer中，在 公开 部分下设置 公开到 选项。

  4. 指定希望的服务使用方式。 在 使用方式 或 公开方式 列表中，选择下列其中一个选项。
    表 1. 公开选项
    选项 描述
    任务（包含在流程中的服务）或不公开（BPD 或案例类型中包含的服务） 针对实施流程中活动的服务使用此缺省选项。 选择此选项时，未使用公开目标设置。
    管理服务（在 Process Admin 控制台中提供） 在 Process Admin Console 的“服务管理”功能中，使用该选项使传统人员服务可作为单独页面供所选团队的成员使用。 将新类别添加到菜单，且该类别与包含服务的流程应用程序名称相同。 新类别中单个页面的名称匹配服务名称。
    可启动服务 (从 Process Portal启动) 使用此选项使所选团队的成员能够从 Process Portal中的 "启动" 列表启动服务。
    仪表板 (在 Process Portal "仪表板" 菜单中可用)

    使用此选项使传统人员服务在 Process Portal 中可供所选团队的成员使用。 团队成员可以通过单击 组织选项卡 图标 组织选项卡并从隐藏页面列表中选择仪表板来访问仪表板。 如果未指定仪表板名称的本地化资源，那么仪表板页面与公开服务同名。

    如果为仪表板名称定义了本地化资源，请单击标签字段旁边的选择并选择资源中的键。 请参阅 全球化仪表板名称。

    如果传统人员服务位于 Toolkit，那么必须完成以下步骤：
    1. 创建 Toolkit 的 snapshot。
    2. 激活 Toolkit snapshot。 请参阅 激活 Snapshot 以用于 IBM Process Portal
    3. 将 Toolkit snapshot 作为依赖关系添加到流程应用程序。 请参阅 在 Designer 视图中创建，更改和删除 Toolkit 依赖关系。

    如果要在 Process Portal外部公开仪表板，请通过单击 从仪表板创建 Portlet来生成可部署到门户网站服务器的 Portlet。
    URL（仅通过 URL 获取） 使用该选项，可通过 URL 地址来使用服务。 有关为公开服务提供 URL 的REST API的信息，请参阅 BPD相关资源的REST接口——公开项目资源。
  5. 单击 保存 或 完成编辑。

结果

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

URL 由主机名称、 IBM Workflow Center 服务器或 Workflow Server ，安装过程中为服务器指定的端口，以及包含该服务的进程应用程序的缩写。 IBM Business Automation Workflow 安装过程中为服务器指定的端口，以及包含该服务的进程应用程序的首字母缩写。 例如，如果公开名为 MyService 的服务，那么可从以下 URL 对其进行访问：
http://host_name:port/contextRootPrefix/executeServiceByName?processApp=acronym&serviceName=MyService
contextRootPrefix 的缺省值是 teamworks。 有关如何配置定制上下文根的更多信息，请参阅 BPMConfig 命令行实用程序 主题中的 -update 参数部分。
请记住： URL 任何浏览器特定的 限制，例如 长度和字符限制，在拨打传统人工服务时适用，且必须予以考虑。 URL URL
URL 参数
URL 可以包含以下一个或多个参数：
processApp
流程应用程序的名称
serviceName
传统人员服务的名称
Snapshot
Snapshot 的名称
com.lombardisoftware.errorPage
错误页面的 URL
输入变量
在 URL 中，为服务定义的输入变量具有以下格式：
&tw.local.variableName=value
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>
对于传统人员服务， variableName 可以是系统定义的 SimpleType 或基于 SimpleType 变量 (类型为 String， Integer， Decimal， Date， Time， Selection) 的 BusinessObject 。 仅在启用 type-string-to-date 配置选项后才允许 Date 或 Time 。
限制: type-string-to-date 配置选项仅适用于传统人员服务。 这不适用于客户机端人员服务。
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 人员服务的日期和时间格式不同。 客户端人员服务和 heritage 人员服务的其他简单类型的语法（String、Integer、Decimal 和 Selection）相同。
注: 有关人员服务中的日期和时间语法的信息，请参阅 定义客户端人员服务的使用设置。
传统人员服务的日期和时间格式如下：
  • Date 格式为 YYYY-MM-DD。
  • Time 格式为 HH:mm:ss。
  • 时区：由于传统人员服务未提供时区的支持信息，因此，缺省时区设置为服务器的时区。
已调用的服务版本
如果未将特定 Snapshot 名称传递至 URL，那么运行的服务的缺省版本取决于运行服务的环境。
表 2. 针对每个环境调用的传统人员服务版本
环境 传统人员服务版本
Workflow Center 运行缺省跟踪提示中的已公开服务。
Workflow Server 运行缺省 Snapshot 中的已公开服务。
Process Portal 在 Process Portal中作为仪表板启动传统人员服务时，启动的版本是传统人员服务的当前工作版本 (如果该版本已公开)。 否则，如果存在其中公开传统人员服务的活动 Snapshot，那么会启动该 Snapshot 版本。 如果当前工作版本未公开，并且存在多个其中公开了传统人员服务的活动 Snapshot，那么会启动最新 Snapshot 版本。
外部门户网站服务器中的 portlet 在生成仪表板的 portlet 时，只能导出一个有效 Snapshot。 当 Portlet 与 IBM Business Automation Workflow通信时，该 Snapshot 必须处于活动状态。