Quire 公式字段参考 Permalink

✦
AI 翻译
· 查看英文版

本指南介绍 Quire 公式中所有字段引用，包括任务字段、项目字段、成员、时间记录及自定义字段扩展。编写 Quire 公式时可将本页作为参考。

任务字段参考

字段名 字段类型 描述 示例 备注
me 成员 当前用户 me in assignees  
low 优先级箭头 低优先级箭头 subtasks.priority > low  
medium 优先级箭头 中优先级箭头 subtasks.priority > medium  
high 优先级箭头 高优先级箭头 subtasks.priority > high  
urgent 优先级箭头 紧急优先级箭头 subtasks.priority > urgent  
priority 优先级箭头 任务的彩色优先级箭头 subtasks.priority 详细说明请参阅优先级。
id 数字 任务的唯一 ID 编号 subtasks.id  
name 文本 任务的名称 subtasks.name  
description 文本 任务的描述 subtask.description  
status 状态图标 任务状态的图标 subtasks.status 详细说明请参阅状态。
previousStatus 状态图标 任务上一个状态的图标 subtasks.previousStatus 详细说明请参阅 previousStatus。
start 日期和时间 任务的开始日和时间 subtasks.start  
due 日期和时间 任务的到期日和时间 parent.due  
duration 时长 到期日减去开始日的总时长 subtasks.duration  
peekaboo 复选框 任务是否已启用暂缓功能 subtasks.peekaboo  
archivedAt 日期和时间 任务被暂缓的日期和时间 parent.archivedAt  
archivedBy 成员 执行暂缓功能的成员 parent.archivedBy  
reshowAt 日期和时间 任务重新显示的日期和时间 parent.reshowAt  
assignees 成员 任务的负责人 COUNT(subtasks.assignees) 分配给任务的外部团队不包含在内。
assignors 成员 分配该任务的成员 subtasks.assignors 详细说明请参阅 assignors。
externalTeam 外部团队 分配给任务的外部团队 externalTeam.name 若外部团队已分配给主任务，该外部团队也会出现在子任务的同一字段中。
tags 标签 添加到任务的标签 subtasks.tags 详细说明请参阅标签。
level 数字 任务层级的编号 MAX(descendants. level)  
editedAt 日期和时间 任务被编辑的日期和时间 parent.editedAt  
toggledAt 日期和时间 任务状态发生变更的日期和时间 parent.toggledAt  
toggledBy 成员 修改任务状态的成员 toggledBy.name  
createdAt 日期和时间 任务被创建的日期和时间 parent.createdAt  
createdBy 成员 添加该任务的成员 createdBy.name  
completedAt 日期和时间 任务完成的日期和时间 parent.completedAt  
completedBy 成员 完成该任务的成员 parent.completedBy  
timelogs 时间记录数量 添加到任务的时间条目数量 timelogs.duration 详细说明请参阅时间记录。
timeSpent 时间 任务花费的总时间 subtasks.timeSpent  
billingTimelogs 时间记录数量 添加到任务的计费时间条目数量 billingTimelogs.duration 详细说明请参阅时间记录。
billingTimeSpent 时间 任务花费的总计费时间 subtasks.billingTimeSpent  
estimated 时间 任务的预估时间 SUM(subtasks.estimated)  
favorites 成员 收藏该任务的成员 favorites.name  
attachments 附件数量 添加到任务的附件数量 attachments.name 详细说明请参阅附件。
comments 评论数量 添加到任务的评论数量 comments.attachments 详细说明请参阅评论。
subtasks 任务列表 任务的所有第一级子任务列表 subtasks[0].{Cost}  
activeSubtasks 任务列表 任务的所有第一级活跃子任务列表 SUM(activeSubtasks.{Cost})  
completedSubtasks 任务列表 任务的所有第一级已完成子任务列表 SUM(completedSubtasks.{Cost})  
descendants 任务列表 任务各层级的所有子任务列表 SUM(descendants.{Cost})  
activeDescendants 任务列表 任务各层级的所有活跃子任务列表 SUM(activeDescendants.{Cost})  
completedDescendants 任务列表 任务各层级的所有已完成子任务列表 SUM(completedDescendants.{Cost})  
parent 任务 直接关联的主任务 parent.due  
section 任务 最近的祖先区段任务 section.name  
ancestors 任务列表 任务所有主任务的列表 ancestors.due  
project 项目 该任务所属的项目 project.name 详细说明请参阅项目。
organization 组织 该任务所属的组织 organization.name 详细说明请参阅组织。

点运算符字段扩展

使用点运算符（.）可从字段中获取特定属性。

示例：

  • priority → 返回优先级图标
  • priority.value → 返回优先级数值
  • priority.name → 返回文字标签


此方式适用于优先级、状态、成员、项目、标签及自定义字段等字段。

项目字段参考

字段名 字段类型 描述 示例
id 文本 项目 ID project.id
name 文本 项目名称 project.name
start 日期 项目的开始日 project.start
due 日期 项目的到期日 project.due
color 颜色代码 项目的颜色 project.color
roots 任务列表 项目中所有第一级任务（根任务）的列表 project.roots
activeRoots 任务列表 项目中所有活跃的第一级任务（根任务）的列表 project.activeRoots
completedRoots 任务列表 项目中所有已完成的第一级任务（根任务）的列表 project.completedRoots
tasks 任务列表 项目中所有任务的列表 project.tasks
activeTasks 任务列表 项目中所有活跃任务的列表 project.activeTasks
completedTasks 任务列表 项目中所有已完成任务的列表 project.completedTasks
organization 组织 该项目所属的组织 project.organization

组织字段参考

字段名 字段类型 描述 示例
id 文本 组织 ID organization.id
name 文本 组织名称 organization.name
color 颜色代码 组织的颜色 organization.color

子清单字段参考

字段名 字段类型 描述 示例
id 文本 子清单 ID sublists.id
name 文本 子清单名称 sublists.name
start 日期 子清单的开始日 sublists.start
due 日期 子清单的到期日 sublists.due
color 颜色代码 子清单的颜色 sublists.color

注意： 必须在方括号 [ ] 内指定子清单名称或 ID。例如，sublists['Design'].due 将获取名为”Design”的子清单的到期日。

成员字段参考（assignees、assignors）

字段名 字段类型 描述 示例
id 文本 成员的用户名 ID assignees.id
name 文本 成员的姓名 assignees.name
email 文本 成员的邮箱 assignees.email
color 颜色代码 成员的颜色 assignees.color

附件字段参考

字段名 字段类型 描述 示例
name 文本 附件的名称 attachments.name
url 文本 附件的 URL attachments.url
size 数字 附件的大小 attachments.size
createdAt 日期和时间 附件添加的日期和时间 attachments.createdAt
createdBy 成员 添加附件的成员 attachments.createdBy

评论字段参考

字段名 字段类型 描述 示例
description 文本 任务中添加的所有评论 comments.description
attachments 附件数量 评论中附件的数量 comments.attachments
createdAt 日期和时间 评论添加的日期和时间 comments.createdAt
createdBy 成员 添加评论的成员 comments.createdBy

外部团队与标签字段参考

字段名 字段类型 描述 示例
name 文本 外部团队或标签的名称 externalTeam.name 或 tags.name
color 颜色代码 外部团队的颜色 externalTeam.color 或 tags.color

时间记录字段参考

字段名 字段类型 描述 示例
user 成员 在任务中添加时间条目的成员 timelogs.user
start 日期 时间记录添加的开始日期 timelogs.start
end 日期 时间记录添加的结束日期 timelogs.end
duration 时长 添加到任务的时间记录时长 timelogs.duration
billable 复选框 时间记录是否计费的 true/false 值 timelogs.billable
note 文本 任务时间记录的备注 timelogs.note

优先级与状态字段参考

字段名 字段类型 描述 示例
name 文本 优先级或状态的名称 priority.name 或 status.name
value 数字 优先级或状态的数值 priority.value 或 status.value
color 颜色代码 优先级或状态的颜色 priority.color 或 status.color

货币字段参考

字段名 字段类型 描述 示例
currency 文本 货币字段的货币符号 Cost.currency
value 数字 货币字段的货币数值 Cost.value

注意： 使用公式前，必须先创建一个数值类型的自定义字段（如 Cost）。

选项字段参考

字段名 字段类型 描述 示例
name 文本 所选选项的名称 Categories.name
color 颜色代码 所选选项的颜色 Categories.color

注意： 使用公式前，必须先创建一个数值类型的自定义字段（如 Cost）。

常见问题

在 Quire 公式中可以引用哪些任务字段？

内置任务字段包括 name、id、状态、优先级、start、due、duration、负责人、标签、timeSpent、estimated、createdBy、completedAt 等。完整列表请参阅任务字段参考。

在 Quire 公式中如何获取优先级或状态的数值或颜色？

使用点记法——priority.value 返回数值，priority.name 返回文字标签，priority.color 返回颜色代码。同样的方式适用于 status。

在 Quire 公式中如何区分引用子任务与所有后代任务？

使用 subtasks 仅引用第一级子任务，使用 descendants 引用所有层级。如需筛选，可使用 activeSubtasks、completedSubtasks、activeDescendants 或 completedDescendants。

在 Quire 公式中如何引用项目字段？

使用 project.fieldname——例如，project.name 返回项目名称，project.tasks 返回所有任务。使用 project.activeTasks 或 project.completedTasks 可获取筛选后的列表。

在 Quire 公式中如何引用成员信息（如负责人姓名或邮箱）？

对成员字段使用点记法——assignees.name 返回显示名称，assignees.email 返回邮箱，assignees.id 返回用户名 ID。

在 Quire 公式中如何引用时间记录数据？

使用 timelogs.fieldname——例如，timelogs.duration 返回时间条目时长，timelogs.billable 返回计费标志的 true/false 值。使用 billingTimelogs 可仅获取计费条目。

在 Quire 公式中如何引用子清单的到期日或名称？

使用 sublists['子清单名称'].fieldname——例如，sublists['Design'].due 可获取名为”Design”的子清单的到期日。

最后更新时间：

如需更多协助，请联系我们。