传统: 监管服务流 (不推荐)

传统:
"系统监管" Toolkit 提供模板和服务流，您可以在 IBM® Process Designer 中使用这些模板和服务流来创建或定制监管流程。

简介

在 IBM Business Automation Workflow 安装期间，系统监管 Toolkit (TWSYSG) 将导入到 Process Center 存储库中。您创建的每个监管流程都必须包含与“系统监管”Toolkit 的依赖关系。该 Toolkit 提供构建监管流程所需的工具。该 Toolkit 提供用于安装流程应用程序 Snapshot 和设置 Snapshot 状态的服务流。

您不能编辑或更改“系统监管”Toolkit 中的工件，但是可以打开该 Toolkit 并查看其中的工件。

模板

“系统监管”工具箱提供两种模板：安装请求的模板以及 Snapshot 状态更改模板。每个此类模板都是可用于满足特定组织需求的监管流程。每个此类模板都与相应的监管事件相关。必须根据其中一个模板来构建 Process Center 中的监管流程，以利用监管服务流。

“已请求安装”模板: 基于该模板创建定制监管流程，用于替换缺省“已请求安装”监管流程，该流程仅从 Toolkit 调用相应的安装服务流。 “已请求安装”模板包含 ProcessAppInstallationRequest 变量（类型为 ProcessAppInstallation）。
Snapshot 状态更改模板: 基于该模板创建定制监管流程，用于替换缺省 Snapshot 状态更改监管流程，该流程不包含任何活动。 Snapshot 状态更改模板包含 SnapshotStatusRequest 变量（类型为 SnapshotStatus）。

安装服务流

"系统监管" Toolkit 为安装监管提供以下服务流，所有这些服务流都仅在 Process Center上本地运行。如果要使用这些服务流来安装 Snapshot ，取消安装或设置安装状态，那么必须在 Process Center中启动安装请求。请参阅以下部分以获取更多详细信息。

安装 Snapshot: 将 Snapshot 安装到指定的 Workflow Server 上。
取消 Snapshot 安装: 取消正在处理的安装请求（即，等待批准）。开始安装后，取消请求将被忽略。
获取所有 Process Server: 返回向 Process Center注册的 Workflow Server 的数组。
设置安装状态: 设置长时间运行的安装期间的安装状态。定义要在监管流程中使用的安装状态消息。
获取安装状态: 获取长时间运行的安装期间的安装状态。

如果安装尝试失败，请调用 "取消 Snapshot 安装" 服务流以清除 Process Center中的状态。避免失败的唯一方式是将流程应用程序的监管流程重置为系统缺省流程。调用了“安装 Snapshot”服务流的监管流程应已具有从失败获取的所有数据，并且可以在电子邮件中发送这些信息或者记录这些信息。对于因流程应用程序出错而出现的失败，您可能想要将该状态保持为失败，以便无人尝试再次安装该版本。

安装 Snapshot

输入：processAppInstallation
输入：processAppInstallationRequest 用于缺省的“已请求安装”监管流程。
输出：installResponse，用于确定安装是否成功以及故障是否可恢复。
实施：调用 Java API 以进行安装。

此服务流可能因为许多原因而无法安装 Snapshot。安装请求会产生返回值，用于指示是否发生了错误以及该错误是否可恢复。

取消 Snapshot 安装

输入：installRequest (processAppInstallation)
实施：调用 Java API 以进行安装。

此服务流在以下情况下可能失败：

“取消 Snapshot 安装”服务流采用 processAppInstallation 对象作为输入，并使用处理期间在 processAppInstallation 上设置的多个标识。这些标识不得为空或其长度不得为零，并且必须是在发出 Snapshot 安装请求时由 processAppInstallation 对象接收到的相同标识。
如果在安装启动后调用了取消，那么会忽略取消请求。
如果针对同一安装请求多次调用了取消，那么会忽略第一次调用后的所有调用，因为已取消安装请求。
如果针对未启用监管的流程应用程序调用了取消，那么会忽略取消请求。
如果不存在针对 Snapshot 和 Workflow Server 组合的活动安装请求，那么取消请求将失败。
如果未正确标识 Snapshot 或 Workflow Server ，那么无法在 Process Center中找到该 Snapshot 或 Workflow Server。

获取所有 Process Server

输出：processServers (processServers) 提供了可用 Workflow Server 的列表。
实施：调用 Java API 以获取列表。

设置安装状态

使用此服务流可在安装请求等待核准时更新安装状态。调用此服务流时，状态会立即更新，而不等待当前状态或安装完成。

此服务流采用以下输入：

processServerID (String)
snapshotID (String)
status (String) 必须为 1 到 64 个字符。
description (String) 可选；长度必须为 0 到 250 个字符。

实施：调用 Java API 以设置安装状态。

此服务流在以下情况下可能失败：

如果未启用监管，那么无法使用此服务流。
如果不存在针对该 Snapshot 和 Workflow Server 组合的安装请求，那么无法提供任何状态。即，安装请求必须打开并处于活动状态。
在完成“安装 Snapshot”服务流之后，将无法调用“设置安装状态”服务流。 “安装 Snapshot”请求会更改状态，当安装完成时，所有状态值都会消失。
如果在调用此服务流之前安装失败，那么不提供任何状态。
如果未正确标识 Snapshot 或 Workflow Server ，那么无法在 Process Center中找到该 Snapshot 或 Workflow Server。

获取安装状态

输入：processServerID (String)
输入：snapshotID (String)
输出：如果未通过“设置安装状态”提供定制消息，那么 status (String) 会提供预定义的状态消息。
实施：调用 Java API 以设置安装状态。

Snapshot 状态服务流

"系统监管" Toolkit 提供了以下用于跟踪 Snapshot 状态的服务流，所有这些服务流都仅在 Process Center本地运行。您可以将以下三种服务流与流程应用程序和 Toolkit 结合使用。您可以将 Snapshot 状态服务流与监管流程结合使用，或独立于监管流程加以使用。 Snapshot 状态事件始终处于活动状态，无论其是否正在使用中都是如此。

获取 Snapshot 状态: 返回 Snapshot 的状态。
获取 Snapshot 状态: 返回包含 Snapshot 所用状态的字符串的列表。该列表包含产品中定义的缺省值以及已通过监管流程添加并且当前正在 Snapshot 中使用的任何定制值。
设置 Snapshot 状态: 将 Snapshot 设为指定的状态。如果指定的状态字符串尚不存在，那么 API 会使用该字符串创建一个新状态值。

获取一个 Snapshot 状态

输入：snapshotID (String)
输出：status (String)
实施：调用 Java API 以获取状态。

获取多个 Snapshot 状态

输出：statuses (String) (List)
实施：调用 Java API 以获取状态列表。

设置 Snapshot 状态

输入：status (String) 字符串扩展。长度必须介于 1 到 50 个字符之间。
输入：snapshotID (String)
实施：调用 Java API 以设置状态。