Metadata and Custom Fields zh TW

Metadata and Custom Fields

English · 繁體中文

Workflow metadata

taiga metadata list issue-status
taiga metadata view issue-status Review
taiga metadata create issue-status --name Review --color '#4A90E2'
taiga metadata edit issue-status Review --closed=true
taiga metadata delete issue-status Review --move-to New --yes

支援八類 metadata：

kind	說明
epic-status	Epic 狀態
story-status	User Story 狀態
task-status	Task 狀態
issue-status	Issue 狀態
points	Story point 值
priority	Issue 優先度
severity	Issue 嚴重度
issue-type	Issue 類型

各 kind 都接受常見的單複數與別名寫法（例如 issue-statuses、us-status、types）。

刪除必須提供同 kind 的 --move-to。Taiga 會先把關聯的工作項目與專案預設值搬到目標，再刪除該 metadata。刪除後 CLI 會回讀確認它真的不存在，否則回報 ambiguous_commit。

Custom field

taiga custom-field create issue --name Environment --type dropdown --option staging --option production
taiga custom-field list issue
taiga custom-field set issue 42 --value Environment='"staging"' --value Attempts=3
taiga custom-field values issue 42
taiga custom-field set issue 42 --unset Environment
taiga custom-field delete issue Environment --yes

Custom field 定義適用於 epic、story、task 與 issue。

值的型別

--value 的右側會先嘗試以 JSON 解析：

--value Attempts=3                 # number
--value Enabled=true               # boolean
--value Notes=null                 # null
--value Environment='"staging"'    # string（JSON 引號）
--value Environment=staging        # 無法解析為 JSON，視為普通字串

更新方式

設定值之前，CLI 會先 GET 目前所有 custom value 並在本機 merge，再以 custom-values 的 version 執行 樂觀鎖 PATCH，因此不會覆寫其他欄位的值。

當 --unset 清除最後一個值時，CLI 會送出 Taiga 接受的 null，避免空 object 被 server 端 validator 判定為 blank 而拒絕。

Due-date preset

taiga due-date list story
taiga due-date create story --name "One week" --days 7 --color '#4A90E2'
taiga due-date edit story "One week" --days 5
taiga due-date delete story "One week" --yes

Swimlane

taiga swimlane list
taiga swimlane create --name Backend --order 2
taiga swimlane wip Backend "In progress" --limit 3
taiga swimlane delete Backend --move-to Default --yes

swimlane wip 設定的是「該 swimlane 的某個狀態欄」的 WIP 上限。

Tag

taiga tag list
taiga tag create backend --color '#4A90E2'
taiga tag edit backend --name platform
taiga tag mix platform --from api --from database
taiga tag delete platform --yes

tag mix 把來源 tag 合併進目標 tag：所有使用來源 tag 的工作項目改用目標 tag，來源 tag 隨後消失。