Skip to main content

保存过滤器与 TQL

Translation in progressThis guide is currently available in Simplified Chinese. A translated version will be added later.

保存 Filter 把 TQL、应用范围、可见性和显示列组合为一个可复用任务菜单。流程设计器也使用同一套 Filter 编辑器，避免维护两套 TQL 体验。

1. 创建 Filter​

  1. 在 Worklist 左侧点击 Manage Filters。
  2. 点击 New Filter。
  3. 填写 Filter Name。
  4. 选择 PRIVATE 或 SHARED。
  5. 按需要限定 App。
  6. 使用 TQL 或 Structured 模式配置条件。
  7. 选择显示列并保存。

Filter Key 由系统自动生成，不需要输入，也没有 Status 属性。

保存 Filter 编辑器展示名称、可见范围、应用、TQL/Structured 模式和显示列。images/runtime-saved-filter-editor-01.webp
截图待补充

2. TQL 示例​

开放采购申请：

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

当前用户待办：

taskType = "PURCHASEREQUEST" AND assignee = currentUser() ORDER BY updatedAt DESC

使用在线补齐和语义校验选择字段、操作符、函数和值。自定义 Amount 字段必须以当前编辑器的补齐结果为准。

3. Structured 模式​

Structured 模式适合简单条件：

  • 选择 Match All（AND）或 Match Any（OR）。
  • 添加 Field、Operator、Value。
  • 查看生成的 TQL 预览。

复杂括号、函数或排序建议使用 TQL 模式。切换模式前检查生成表达式是否保留原有语义。

4. 使用保存 Filter​

保存后，Filter 出现在左侧 Filters 分组。打开它时：

  • TQL 以只读方式显示。
  • 列表使用保存的查询条件。
  • 已保存 display columns 会应用到表格。
  • 用户仍只能看到权限允许的任务。
Filter 菜单与结果展示左侧保存 Filter、只读 TQL 和按保存列渲染的采购任务。images/runtime-saved-filter-result-02.webp
截图待补充

5. PRIVATE 与 SHARED​

  • PRIVATE 仅创建者使用。
  • SHARED 可供有访问权限的用户复用。
  • 只有拥有该 Filter 的用户或有相应管理权限的用户可以编辑、删除。

共享只改变 Filter 可见范围，不提升任务数据权限。

6. 与流程设计器和 TaskList 的关系​

流程设计器创建的 Filter 可作为设计资产供页面 TaskList 引用；工作台 Filter 更偏向用户的运行期组织方式。两者复用编辑器和 TQL 语言，但应根据实际保存范围选择正确入口。

7. 常见问题​

Filter 菜单出现但结果为空：检查 TQL、应用范围、环境、任务权限和 Task Type Key。

其他用户看不到 Filter：确认可见性为 SHARED，并检查应用和用户访问范围。

编辑器提示未知字段：重新从建议列表选择；该字段可能不支持搜索或未发布到当前环境。

下一步​

Last updated on