Asana
將 LaunchCal 的發布關聯到它的 Asana 專案,發布就會跟隨它:狀態和進度,每天同步,也可隨時手動同步。
Asana 在 Taktoria 中的作用
在 LaunchCal 中,發布可以跟隨存放其工作的 Asana 專案。隨著專案中的任務完成,發布的狀態會隨之變更;發布會顯示有多少任務已完成,專案被標示為完成後,發布即完成。
Taktoria 只會從 Asana 讀取:它絕不會在那裡建立、變更或留言任何內容。任務、專案組合或目標在這裡沒有自己的狀態,因此指向它們的連結會作為一般連結保留。
連結 Asana
只有工作區擁有者或管理員才能連結 Asana。
- 開啟設定 → 整合。
- 在工單系統下,選擇連結 Asana。
- 登入 Asana 並允許。
Taktoria 只向 Asana 要求讀取專案、人員和工作區的權限,並以連結它的 Asana 帳號的身分,在該帳號所屬的每個 Asana 工作區中讀取。該帳號能看到的任何專案,都可以被任何能編輯發布的人關聯到發布上,其進度也會顯示在那裡。因此,請不要用你自己的帳號,而是用一個專供 Taktoria 使用、只能看到你的發布所追蹤專案的帳號來連結 Asana。用個人帳號建立的連結,在此人離職時也會停止同步。
將發布關聯到專案
任何能編輯發布的人都可以關聯、同步或取消關聯它。
- 開啟發布的詳細資料分頁。
- 在工單專案下,將專案或其某個檢視的網址貼到專案連結。
- 選擇關聯專案。
專案必須是連結所用帳號能看到的專案。關聯後會立即同步。在 Asana 連結之前貼上的連結會作為一般連結保留,連結後即開始同步。
連線到 LaunchCal 的 AI 助理和 REST API 也可以關聯、同步和取消關聯發布,規則相同。
同步什麼,何時同步
已關聯的發布在推出之前每天同步一次,有人選擇立即同步時也會同步。
- 狀態:在專案中有任務完成之前為範疇界定,之後為開發中(已處於設計或測試中的發布維持不變)。被標示為完成的專案即完成。
- 進度:專案中已完成任務所占的比例。
- 完成:專案被標示為完成後,發布會顯示已準備就緒,並通知其負責人。
專案的狀態更新不會同步過來:Asana 不允許像 Taktoria 這樣只讀取的應用程式讀取它們。你在 LaunchCal 中選擇的狀態會一直保留,直到專案的狀態再次變更。同步帶來的變更,在發布的歷史記錄、傳給負責人的訊息和稽核日誌中,都會顯示為來自 Asana。
它絕不會做的事
- 它絕不會發布任何東西。專案完成只會讓發布準備就緒;必要審查全部判定後,仍然需要有人選擇按下即可發布!。
- 它絕不會變更已經發布的發布。
- 它絕不會寫入 Asana。
- 除非專案的狀態再次變更,它絕不會撤銷你在 LaunchCal 中選擇的狀態。
取消關聯和中斷連結
發布詳細資料分頁上的取消關聯會停止該發布的同步;已同步過來的內容會保留。
設定 → 整合中的中斷連結會停止所有發布從 Asana 的同步,並撤銷 Taktoria 在那裡的存取權。發布會保留已關聯的內容,以及到那時為止同步的所有內容,並在 Asana 重新連結後繼續同步。
疑難排解
- 找不到專案:它已被刪除,或連結所用帳號看不到它。請讓該帳號能存取它,或關聯它目前的網址。
- Asana 拒絕了連結:由工作區擁有者或管理員在設定 → 整合中重新連結 Asana。連結它的帳號離職或失去存取權時就會發生這種情況。
- Asana 沒有回應上次同步:下次同步會再試一次,或稍後選擇立即同步。
- 沒有同步過來狀態更新:Asana 不允許只讀取的應用程式查看它們。發布改為跟隨專案的任務和完成情況。
- 被保留為一般連結:Asana 尚未連結,或者該網址是任務、專案組合或目標的網址,而不是專案的網址。