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 請參閱 priority 取得更多資訊。
id 數字 任務的唯一 id 編號 subtasks.id  
name 文字 任務的名稱 subtasks.name  
description 文字 任務的描述 subtask.description  
status 狀態圖示 任務狀態的圖示 subtasks.status 請參閱 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 請參閱 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 請參閱 time logs 取得更多資訊。
timeSpent 時間 花費在任務上的總時間 subtasks.timeSpent  
billingTimelogs 時間紀錄數量 加在任務上的計費時間紀錄筆數 billingTimelogs.duration 請參閱 time logs 取得更多資訊。
billingTimeSpent 時間 花費在任務上的總計費時間 subtasks.billingTimeSpent  
estimated 時間 任務的預估時間 SUM(subtasks.estimated)  
favorites 成員 將任務加入最愛的成員 favorites.name  
attachments 附件數量 加在任務上的附件數量 attachments.name 請參閱 attachments 取得更多資訊。
comments 留言數量 加在任務上的留言數量 comments.attachments 請參閱 comments 取得更多資訊。
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 請參閱 project 取得更多資訊。
organization 組織 任務所屬的組織 organization.name 請參閱 organizations 取得更多資訊。

使用點運算子的欄位延伸

您可以使用點運算子（.）從欄位中取得特定屬性。

範例：

  • priority → 回傳優先級圖示
  • priority.value → 回傳優先級的數值
  • priority.name → 回傳文字標籤


此方法適用於 priority、status、members、projects、tags 與 custom fields 等欄位。

專案欄位參考

欄位名稱 欄位類型 說明 範例
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 文字 附件的網址 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 核取方塊 時間紀錄是否計費的真／假值 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、status、priority、start、due、duration、assignees、tags、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 會回傳是否計費的真／假值。若僅需計費的紀錄，請使用 billingTimelogs。

在 Quire 公式中如何參考子清單的到期日或名稱？

使用 sublists['SublistName'].fieldname — 例如，sublists['Design'].due 會取得名稱為「Design」的子清單到期日。

最後更新時間：

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