專案管理

專案管理整合把始於 Alforse 的工作連結到 Linear 或 Jira 中的議題。品質團隊用它們把的行動任務與變更通知交給工程部門，而不必重新輸入；狀態、負責人與備註隨後雙向保持同步。

​

連結如何運作

每個整合都在設定 → 整合下依公司啟用，兩者都出現在專案管理類別中。連線之後，你把行動任務或變更通知連結到議題，Alforse 會讓兩筆記錄保持一致。 變更朝兩個方向傳遞，每個方向有各自的連線： Webhook URL 專屬於你的公司，顯示在整合的設定說明中，可直接複製：/api/webhook/linear/<your company id> 或 /api/webhook/jira/<your company id>。

​

連接 Linear

Linear 以 API 金鑰驗證，金鑰必須以 lin_api 開頭。

​

連接 Jira

Jira 透過 OAuth 連線，因此沒有金鑰需要貼上。唯一的設定是選用的 webhook 密鑰。

​

保護 webhook

兩種密鑰都是選用的，這樣在簽署功能出現之前就設定好的整合才能繼續運作。這種相容性是有代價的：沒有儲存的密鑰，Alforse 就無法區分真正的 Linear 或 Jira 請求，與送到同一個 URL 的偽造請求。

​

疑難排解

​

”Linear API Key must start with ‘lin_api’“（Linear API 金鑰必須以 ‘lin_api’ 開頭）

原因：在 API 金鑰中的值不是 Linear 個人 API 金鑰，或貼上時缺少字元。解決方法：在 Linear 的 Security and access 下產生新的金鑰，並完整貼上。

​

在 Jira 做的變更沒有出現在 Alforse

原因：沒有 Jira webhook，或它沒有訂閱正確的事件。解決方法：在 System → WebHooks 下以 Alforse 設定說明中的 URL 建立 webhook，並訂閱 Issue updated 與 Issue deleted。

​

加入密鑰後 webhook 請求被拒絕

原因：Alforse 中儲存的密鑰與追蹤工具中的不符，因此簽章無法驗證。解決方法：從 Linear 的 webhook 詳細頁面，或 Jira webhook 的 Secret 欄位複製密鑰，並在 Alforse 中重新儲存。

​

相關內容