公式欄位參考 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['SublistName'].fieldname——例如，sublists['Design'].due 可取得名為「Design」的子清單的到期日期。

最後更新時間：

如需更多協助，請聯繫我們。