页面设计器集成
流程设计器定义任务资产,页面设计器负责把这些资产组合成业务页面。任务场景使用 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 适合让用户在一个控件中切换自己的待办、创建和已处理任务。
images/pd-page-designer-task-palette-01.webp2. 使用 Task Form
- 在 Page Designer 左侧展开 Task 分组。
- 将 Task Form 拖入页面容器。
- 选择已经配置的 Task Type 和任务表单。
- 配置创建或详情场景所需的页面上下文。
- 保存并在与流程资产相同的版本/环境中预览。
Task Form 必须关联流程设计器中实际存在的表单。普通 Data Form 面向 Business Object,不会自动提交任务或执行工作流操作。
3. 使用 TaskList
先在 Process Designer → Data & Permission → Filters 保存 Filter,例如:
taskType = "PURCHASE" AND status = "OPEN" ORDER BY updatedAt DESC
然后:
- 将 TaskList 拖入页面。
- 在属性中选择保存的 Filter。
- 配置需要展示的列、筛选栏和任务打开方式。
- 保存并验证分页、权限和空状态。
images/pd-page-designer-task-list-filter-02.webpFilter Key 是稳定引用,由系统自动生成。修改 Filter 名称不会要求用户重新输入 Key;删除 Filter 前应检查页面引用。
4. 使用 Worklist
Worklist 提供三个典型视图:
- My Pending:当前用户需要办理的任务。
- My Created:当前用户创建的任务。
- My Processed:当前用户已经处理过的任务。
配置默认视图、是否显示 Filter Bar,以及需要展示的列或任务详情行为。运行时切换 Tab 不应绕过权限方案。
页面内嵌的 Worklist 控件用于组合业务页面;Spark Runtime 的独立任务工作台则提供完整的个人任务入口、创建工作区、保存 Filter、模板、标签、Dashboard、SLA 和通知。详细用法见 任务工作台总体介绍。
images/pd-page-designer-worklist-03.webp5. 版本一致性
页面和任务资产必须在目标环境中引用兼容版本:
- 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。