创建案例用户界面

为 Process Portal 中的案例实例创建用户可查看的用户界面。

要创建案例实例用户界面，请首先创建一个包含已生成 Coach 的客户机端人员服务。然后，您可以修改已生成的服务和 Coach 以创建自己的定制界面。

1. 打开要为其创建用户界面的案例类型。
2. 切换至“视图”页面。
3. 选择要创建的界面，例如，详细信息 UI 下的缺省。
4. 单击客户机端人员服务旁的新建，然后输入用户界面的名称。
5. 单击下一步。 在“新建客户机端人员服务”页面中，您会看到可以与客户机端人员服务来回传递的属性和变量列表。缺省情况下选择案例文件夹的共享业务对象和所有关联属性与变量。共享属性和变量通过引用进行传递。 局部属性和变量通过值进行传递。
   提示： 要保证运行时的数据完整性，请保持选择案例文件夹的共享业务对象。

   您无需在案例类型和人员服务之间映射变量。案例类型变量已映射到具有相同名称的人员服务变量。

6. 单击完成。
7. 这样会打开客户机端人员服务编辑器。切换至“变量”页面。 请注意，从案例类型映射的输入和输出变量已被锁定。您只能在案例类型编辑器中编辑这些变量。但是，您可以添加仅对人员服务可用的专用变量。

   如果要创建启动案例 UI，Process Designer 会生成一个布尔值类型的 cancelCase 变量。缺省值为 false。您只能查看该变量，不能对其执行更改或删除操作。变量的值由启动 UI 人员服务设置。用户在案例启动期间完成人员服务时，如果 cancelCase 的值为 true，那么取消启动。如果值为 false，那么将启动案例。

8. 切换至“图”页面。 已为您生成一个基本图。如果要创建详细信息 UI，该图将包含一个数据更改事件处理程序，用于管理运行时 UI 中的数据更改。这是即用型事件处理程序。但是，您可以通过双击数据更改节点来定制实施。有关更多信息，请参阅处理数据更改。
9. 完成人员服务图并定制 Coach。
   • 对于详细信息 UI，生成的人员服务具有两个 coach：
     • 视图实例详细信息 coach，其中包含以下 coach 控件：

       缺省实例详细信息模板

       在 IBM Process Portal 显示实例详细信息

       数据部分

       显示传递到人员服务中的变量的值。

     • 显示错误，如果找不到实例，将返回错误。
     人员服务从“仪表板”工具箱中的模板生成，该模板称为“实例详细信息 UI 服务模板”。有关更多信息，请参阅实例详细信息 UI 服务模板。
   • 对于启动 UI，已生成的人员服务有输入数据 coach，针对每个映射的案例类型变量和属性都具有一个控件。指定启动案例 UI 时，Process Designer 会生成一个布尔值类型的 cancelCase 变量。变量的值由启动 UI 人员服务设置。如果 cancelCase 的值在用户完成启动案例人员服务时为 true，那么取消启动。如果 cancelCase 的值为 false，那么启动案例。缺省值为 false。生成的“启动 UI”拥有一个具备以下两个按钮的 coach：确定和取消。 如果用户单击取消，cancelCase 变量设置为 true。
     如果要在 Enterprise Content Manager 服务器上使用 IBM BPM 内容库，您可以修改“启动 UI”以便用户能够查看或添加您在“文件夹”页面中指定的案例文件夹中的文档。 要执行此操作，请使用“内容管理”工具箱中提供的 coach 控件来查看和检索内容库中的文档。 例如，文档资源管理器控件。 “内容管理”工具箱中提供这些控件。有关更多信息，请参阅：

     • 如何使用 coach 视图来存储或查看文档
     • 文档资源管理器控件

     注： 如果案例启动已取消，那么会从 IBM BPM 内容库中移除该案例文件夹。如果文档在案例文件夹外部仍被使用，则这些文件会保留在内容库中。否则将移除这些文档。
10. 测试客户机端人员服务。
    • 对于“启动 UI”，单击运行 以测试客户机端人员服务和 Coach。
    • 对于“详细信息 UI”，执行以下某个操作：
      • 如果人员服务流未经定制，请在 Process Portal 中运行实例 UI。
      • 如果想逐步测试和构建定制 UI：
        1. 运行与定制 UI 关联的案例或流程的实例并记录实例标识。
        2. 人员服务具有一个用于在流程实例标识为空时显示错误的逻辑。通过将开始节点直接连接到客户机端 Init 数据节点来除去此逻辑。
        3. 在客户机端 Init 数据脚本中，修改第一行，如下所示：

           tw.local.selectedInstanceId ='6'; 

           其中，6 是您在第 a 步中记录的实例标识。
        4. 运行该人员服务。
        5. 服务按照预期工作之后，还原在第 b 和 c 步中所做的更改。然后，通过在 Process Portal 中运行实例 UI 再次进行测试。