メインコンテンツまでスキップ

页面设计器集成

翻訳準備中このガイドは現在、簡体字中国語版のみ提供しています。翻訳版は今後追加されます。

流程设计器定义任务资产，页面设计器负责把这些资产组合成业务页面。任务场景使用 Task Form、TaskList 和 Worklist；DataList 只用于 Business Object，不能代替任务列表。

1. 三个任务控件​

控件适用场景数据来源
Task Form创建、查看或办理一个任务Task Type / Task Form 和任务上下文
TaskList页面中的特定任务列表流程设计器保存的 Filter / TQL
Worklist通用个人任务工作区My Pending、My Created、My Processed 内置视图

TaskList 适合“开放采购申请”“部门采购待审批”等固定业务页面。Worklist 适合让用户在一个控件中切换自己的待办、创建和已处理任务。

页面设计器 Task 分组展示 Task Form、TaskList 和 Worklist 三个控件。images/pd-page-designer-task-palette-01.webp
截图待补充

2. 使用 Task Form​

  1. 在 Page Designer 左侧展开 Task 分组。
  2. 将 Task Form 拖入页面容器。
  3. 选择已经配置的 Task Type 和任务表单。
  4. 配置创建或详情场景所需的页面上下文。
  5. 保存并在与流程资产相同的版本/环境中预览。

Task Form 必须关联流程设计器中实际存在的表单。普通 Data Form 面向 Business Object，不会自动提交任务或执行工作流操作。

3. 使用 TaskList​

先在 Process Designer → Data & Permission → Filters 保存 Filter，例如：

taskType = "PURCHASE" AND status = "OPEN" ORDER BY updatedAt DESC

然后：

  1. 将 TaskList 拖入页面。
  2. 在属性中选择保存的 Filter。
  3. 配置需要展示的列、筛选栏和任务打开方式。
  4. 保存并验证分页、权限和空状态。
TaskList 绑定 Filter展示 TaskList 选择 Process Designer Filter，以及列和筛选栏属性。images/pd-page-designer-task-list-filter-02.webp
截图待补充

Filter Key 是稳定引用，由系统自动生成。修改 Filter 名称不会要求用户重新输入 Key；删除 Filter 前应检查页面引用。

4. 使用 Worklist​

Worklist 提供三个典型视图：

  • My Pending：当前用户需要办理的任务。
  • My Created：当前用户创建的任务。
  • My Processed：当前用户已经处理过的任务。

配置默认视图、是否显示 Filter Bar，以及需要展示的列或任务详情行为。运行时切换 Tab 不应绕过权限方案。

页面内嵌的 Worklist 控件用于组合业务页面；Spark Runtime 的独立任务工作台则提供完整的个人任务入口、创建工作区、保存 Filter、模板、标签、Dashboard、SLA 和通知。详细用法见 任务工作台总体介绍。

Worklist 运行态展示 My Pending、My Created、My Processed 三个 Tab、筛选区和任务列表。images/pd-page-designer-worklist-03.webp
截图待补充

5. 版本一致性​

页面和任务资产必须在目标环境中引用兼容版本：

  • DEV 预览使用当前开发配置时，确认 Task Type、Form 和 Filter 已保存。
  • TEST/PROD 运行前，发布同时包含页面与流程资产的版本。
  • 页面显示空列表时，先检查环境、Filter、权限和实际任务数据。

6. 交互建议​

  • 点击 TaskList 行时打开任务详情或绑定 Task Form 的页面。
  • 创建按钮进入使用 purchaseCreate 的任务创建页。
  • 办理操作应由 Task Form/任务详情调用流程操作，不使用普通 Button 模拟状态更新。
  • 页面参数只负责传递任务 Key 等上下文，不把权限信息作为可信输入。

7. 常见问题​

Task Form 找不到已配置表单：确认选择的是 Task Form 而不是 Data Form，流程资产已保存，并且页面与流程使用同一应用版本。

TaskList 绑定 Filter 后为空：检查 Filter Key、TQL、当前环境、任务权限和 Task Type Key。

Worklist 的三个视图数量不符合预期：My Pending、My Created、My Processed 的身份关系不同；确认当前用户是 Assignee、Reporter 还是历史 Participant。

下一步​

に最終更新