Quire 公式指南 Permalink
公式讓您在 Quire 中根據既有的任務或專案資料自動計算出新的數值。您可以參照內建欄位或自訂欄位、套用運算子或函式，並在自訂欄位中顯示數值或文字形式的結果。
撰寫公式
在 Free 訂閲方案中，您可以為每個專案的自訂欄位新增一個公式。升級訂閲方案即可新增更多公式，更多資訊請參考我們的價格頁面。
若要撰寫公式，您必須先建立一個公式自訂欄位。建立完成後，即可輸入參照既有數值並回傳計算結果的公式。
舉例來說，若您想將任務的已花費時間除以 2：
timeSpent/2
Quire 會自動為每個任務計算數值，並將結果顯示在自訂欄位中。
了解如何建立自訂欄位以新增您的公式。
使用公式執行計算
算術運算子
您可以使用下列運算子執行常見的算術計算：
- 加法：
+ - 減法：
- - 乘法：
* - 除法：
/
舉例來說，若要透過從到期日減去開始日來計算任務工期：
due - start
提示： 使用括號 ( ) 可控制計算順序。例如，若輸入 (due - start) *2，則會先計算到期日與開始日的相減，再進行乘以 2 的運算。
函式
函式提供一種更快速的方式來執行更進階的計算。
舉例來說，若要計算已花費時間與預估時間的總和：
SUM(timeSpent, estimated)
您也可以使用比較運算子來回傳邏輯結果。
priority >= high
這會檢查任務的優先級是否高於或等於 High。
了解所有可在 Quire 公式中使用的運算子與函式。
公式撰寫最佳實踐
點運算子
點運算子 . 可讓您從相關物件中取得特定的數值。
舉例來說，若您想列出所有子任務的名稱：
subtasks.name
另一個範例，若您想取得主任務的優先級：
parent.priority
提示： 我們已列出您可以指定的所有不同欄位。
含有空格的欄位名稱
為自訂欄位命名時，請避免使用下列字元：引號（"）、反斜線（\）以及大括號（}）。
在公式中參照自訂欄位時：
- 不含空格的欄位名稱可直接使用
- 含有空格或特殊字元（包含
@、#、&等）的欄位名稱必須以大括號{ }包起來
舉例來說，若您新增了一個名為 Cost 的欄位：
Cost *2
{Cost} *2
若欄位名稱含有空格，則必須以大括號 { } 包起來：
{Schedule Variance} *2
備註： 不區分大小寫，因此輸入 cost 或 Cost 代表相同的意思。
結果中的文字
若要在公式結果中包含文字，請務必將文字字串以引號包起來。
舉例來說，若您新增了兩個自訂欄位，一個用於品項 ID，另一個用於品項名稱：
id + ":" + name
這會顯示以冒號分隔的 ID 與名稱。
成員、任務與標籤的識別碼
您可以使用識別碼來參照特定的實體：
- 成員：
@member_username - 任務：
#task_id - 標籤：
#tag_name - 專案：
#{project_id}
舉例來說，若您想取得任務 ID 23 的到期日：
#23.due
備註： # 與 ID 之間不可有空格。
再舉一個例子，若您想知道整個專案總共花費了多少時間，可以在組織概覽的描述中輸入類似下列的內容：
SUM(#{project_id}.tasks.timeSpent)
備註：
- 專案識別碼
#{project_id}只能在組織概覽的描述區域中使用，無法在任務或專案的描述中使用。 - 專案 ID 必須以大括號包起來（例如
#{project_id}），專案識別碼才能正確運作。 - 若使用者的 username ID 含有
.、-或_，您必須將其以大括號包起來，識別碼才能正確運作。 - 若標籤名稱含有任何空格或特殊字元，包括點（
.）、井字號（#）或數字等，您必須將標籤名稱以引號包起來，標籤識別碼才能正確運作。例如，若標籤名稱為 depending on，則需以引號包起來，如#"depending on"。
Quire 公式中的字面值
字面值是在計算過程中不會改變的固定值。Quire 支援多種字面值格式：
- 數字：
123、-1.23 - 文字：
"text"、'text' - 清單：
[1,2,3] - 布林值：
true、false - 時間長度：
12:01、123:12:23、2h 30m、2d 5s、30m - 日期與時間：
<2022/12/25>、<12/23>、<23>、<2022/01/23 13:10:00>、<2023/12/25 16:00>、<15:15>、<now> - 日：
<today>、<today-1>、<tomorrow+3 13:10:05>、<+5>
備註：
- 文字字串可以串接：’first’ “second”，與
'first second'相同。 - 日期會依語言而異（例如德文中的
<Morgen>）。 - 對於日期，
<+5>等同於<today+5>。 - 對於時間長度，小時範圍只能是 0-23，語法為
hh:mm:ss或mm:ss。
格式化公式結果
Format 分頁
建立或編輯公式欄位時，您可以透過 Format 分頁來設定公式結果的顯示方式。
- 開啟公式自訂欄位。
- 點擊 Format 分頁。
- 選擇顯示格式。
條件式顏色
條件式格式化有助於以視覺方式凸顯重要的數值。
- 點擊 Add a new condition。
- 定義條件並選擇顏色。
- 點擊 Save。
備註： 條件會由上而下套用。拖曳六點圖示即可重新排序。
常見問題
如何在 Quire 中使用公式？
建立一個公式自訂欄位，然後輸入參照任務欄位並回傳計算結果的公式。Free 方案允許每個專案使用一個公式欄位。
我可以在 Quire 公式中執行哪些計算？
Quire 支援 +、-、* 與 /。使用括號可控制計算順序——例如 (due - start) * 2。若要進行更進階的計算，請使用內建函式，例如 SUM(timeSpent, estimated)。
我可以在 Quire 公式中使用哪些字面值？
支援的字面值包括數字（123、-1.23）、文字（"text"）、布林值（true/false）、清單（[1,2,3]）、時間長度（2h 30m），以及日期（<2022/12/25>、<today>、<today+5>）。
如何在 Quire 公式中參照含有空格的自訂欄位？
將欄位名稱以大括號包起來——例如 {Schedule Variance} * 2。不含空格的欄位名稱可直接使用。欄位名稱不區分大小寫。
如何在 Quire 公式結果中包含文字？
將文字字串以引號包起來——例如 id + ":" + name 會顯示以冒號分隔的 ID 與名稱。
如何在 Quire 公式中參照特定的任務、成員或標籤？
使用 #task_id（例如 #23.due）、@member_username，以及 #tag_name。對於含有空格或特殊字元的標籤名稱，請使用 #"depending on"。
如何在 Quire 中格式化公式結果或為其加上顏色標記？
開啟公式欄位並點擊 Format 分頁以選擇顯示格式。若要使用條件式顏色，請點擊 Add a new condition、定義規則並儲存。