Jira

在 LaunchCal 中，發布可以跟隨記錄其工作的 Jira 長篇故事或任意問題。問題的狀態變更時，發布的狀態會隨之變更；發布會顯示長篇故事下有多少子問題已完成，問題的留言也會出現在發布上。

整個 Jira 專案沒有自己的狀態，因此指向它的連結會作為一般連結保留：若要跟隨它，請關聯其中的某個長篇故事或問題。

Taktoria 只會從 Jira 讀取（問題及其狀態、子問題和留言，以及撰寫者的名字）：它絕不會在那裡建立、變更或留言任何內容。

只有工作區擁有者或管理員才能連結 Jira。

1. 開啟設定 → 整合。
2. 在工單系統下，選擇連結 Jira。
3. 登入 Atlassian，選擇要連結的 Jira 網站，然後核准。

Taktoria 以連結 Jira 的那個 Atlassian 帳號的身分讀取 Jira。該帳號能看到的任何問題，都可以被任何能編輯發布的人關聯到發布上，其留言也會顯示在那裡，即使此人在 Jira 中打不開這個問題。因此，請不要用你自己的帳號，而是用一個專供 Taktoria 使用、只能看到你的發布所追蹤專案的帳號來連結 Jira。用個人帳號建立的連結，在此人離職或失去存取權時也會停止同步。

任何能編輯發布的人都可以關聯、同步或取消關聯它。

1. 開啟發布的詳細資料分頁。
2. 在工單專案下，將長篇故事或問題的網址貼到專案連結：可以是它本身的頁面，也可以是開著它的看板或清單。
3. 選擇關聯專案。

問題必須位於已連結的 Jira 網站上，而且是連結所用帳號能看到的問題。關聯後會立即同步。在 Jira 連結之前貼上的連結會作為一般連結保留，連結後即開始同步。

連線到 LaunchCal 的 AI 助理和 REST API 也可以關聯、同步和取消關聯發布，規則相同。

已關聯的發布在推出之前每天同步一次，有人選擇立即同步時也會同步。

• 狀態：問題的狀態變更時，發布的狀態會隨之變更：待處理對應範疇界定，進行中對應開發中（已處於設計或測試中的發布維持不變），以「不會處理」或重複為結果完成的問題對應暫停。你在 LaunchCal 中選擇的狀態會一直保留，直到問題的狀態再次變更。
• 進度：長篇故事下已完成子問題所占的比例。
• 留言：問題的每則留言都會成為發布動態分頁上的一則留言，標有來自 Jira並附上指向原文的連結。在 Jira 中僅限部分人查看的留言絕不會被帶入。在 Jira 中修改後，下次同步會帶來修改。
• 完成：問題完成後，發布會顯示已準備就緒，並通知其負責人。

同步帶來的變更，在發布的歷史記錄、傳給負責人的訊息和稽核日誌中，都會顯示為來自 Jira。稽核日誌只記錄有留言進來或被修改，絕不記錄留言的內容或其中提到的人。

• 它絕不會發布任何東西。問題完成只會讓發布準備就緒；必要審查全部判定後，仍然需要有人選擇按下即可發布！。
• 它絕不會變更已經發布的發布。
• 它絕不會寫入 Jira。
• 它絕不會帶入僅限部分人查看的留言。
• 除非問題的狀態再次變更，它絕不會撤銷你在 LaunchCal 中選擇的狀態。

發布詳細資料分頁上的取消關聯會停止該發布的同步；已同步過來的內容會保留。

設定 → 整合中的中斷連結會停止所有發布從 Jira 的同步。發布會保留已關聯的內容，以及到那時為止同步的所有內容，並在 Jira 重新連結後繼續同步。依照 Atlassian 的要求，中斷 Jira 的連結也會從已帶入的留言中移除 Jira 使用者的名字：留言保留內容，但不保留作者的名字，提及會顯示為 @someone。當 Atlassian 告知某人的帳號已關閉時，此人的名字也會這樣處理。

Atlassian 沒有提供讓 Taktoria 自行撤銷其 Jira 存取權的方式：若要完全移除，請一併從你 Atlassian 帳號的已連結應用程式中移除 Taktoria。

• 找不到問題：它已被刪除、移動，或位於連結所用帳號看不到的地方。請讓該帳號能存取其專案，或關聯它目前的網址。
• Jira 拒絕了連結：由工作區擁有者或管理員在設定 → 整合中重新連結 Jira。連結它的帳號離職或失去存取權時就會發生這種情況。
• Jira 沒有回應上次同步：下次同步會再試一次，或稍後選擇立即同步。
• 整個專案沒有同步：它沒有自己的狀態。請改為關聯其中的某個長篇故事或問題。
• 缺少某則留言：在 Jira 中僅限部分人查看的留言絕不會被帶入。