Jira
把 Jira 連接到 MeDo 應用程式:瀏覽專案、看板與 Sprint,用 JQL 或篩選條件查找問題,並建立、編輯、轉換、指派或留言經確認的問題。
Jira 是一個連接器:它把 MeDo 應用程式連接到一個 Jira Cloud 站點,讓應用程式可以讀取專案、看板、Sprint、問題與留言,並在該站點上建立或變更問題。應用程式只處理已連接帳戶能觸及的專案與問題。
可以建立什麼
- 私人 Sprint 儀表板。 列出某個專案的未結問題,以及它們的狀態、經辦人與到期日。
- 錯誤回報頁面。 把訪客提交的內容變成指定專案中的 Jira 問題,並把回報者電子郵件寫進描述。
- 發佈說明工具。 選擇一個版本,列出該 Sprint 修好的問題,並把摘要以留言形式貼回每個問題。
- 分流看板。 顯示未指派的問題,並在確認變更後把其中一個指派給同事。
當工作已經以 Jira 問題追蹤,而應用程式要加上專注的檢視或結構化的輸入方式時,Jira 就很合適。它不是報表產品:問題清單是分頁的,詳見限制。
建立範例
把以下其中一段複製到提示框中。第一段是最小可用的起點,只讀取資料。
準備與連接
你需要一個 Jira Cloud 站點,以及一個已經能看到目標專案的帳戶。過程中不需要 API Token,也不需要註冊 Atlassian 應用程式。
- 在側邊欄打開 Skills & Connectors,搜尋 Jira。
- 打開 Jira 卡片並點 Connect。
- 輸入站點的子網域,也就是
.atlassian.net前面的部分;例如acme.atlassian.net就填acme。 - 登入 Atlassian,並同意 MeDo 要求的存取權限。
- 按鈕變成 Connected。
如果在連接之前就開始建立,MeDo 會在回覆下方顯示 Jira 連接按鈕,你也可以在那裡連接。
如果你的 Atlassian 帳戶可以存取多個站點,連接後請確認應用程式用的是哪一個:請應用程式列出連接能看到的所有站點;若選錯了,用正確的子網域重新連接。
在應用程式中使用
- 應用程式使用你連接的站點,而不是每位訪客自己的 Atlassian 登入。 訪客不需要 Jira 帳戶。請把內部問題檢視放在應用程式自己的登入之後,並限制給預期的人。
- 在提示中指定專案,或讓應用程式提供選擇器。 兩種方式都應該針對你選定的專案運作,而不是訪客臨時選的那一個。
- 問題清單是分頁,不是總數。 每頁 50 個問題。請讓應用程式顯示一頁並提供清楚的載入更多方式,不要把一頁當成整個待辦清單。
- 問題類型與狀態按 ID 解析。 其他語言的站點會顯示自己的類型與狀態名稱,因此應用程式會從站點的清單中選取,而不是使用固定的英文名稱。
- 狀態變更依專案工作流程。 應用程式只提供該問題當下可用的轉換,並使用轉換的 ID。
- 指派使用 account ID。 顯示名稱與電子郵件只是備援,因為站點可能隱藏成員電子郵件。
- 寫入前先確認。 MeDo 會在儲存前預覽新問題,或預覽要改的欄位與新值。涵蓋建立與編輯問題、轉換狀態、指派、留言,以及關聯兩個問題。
- 留言與描述接受 Markdown。 應用程式會把 Markdown 轉成 Jira 的文件格式。
- 內部備註屬於應用程式。 Jira 沒有對應欄位的備註與跟進狀態,放在應用程式自己的資料表中,並以真實問題為鍵。
限制與排障
應用程式出現「Connection required」。 請應用程式擁有者打開連接器卡片並點 Connect,然後重新載入。
建立問題時類型被拒絕。 在本地化站點上,請用站點類型清單中的數字 ID,而不是 "Task" 這類英文名稱。
指派看起來沒有反應。 指派成功會回傳空內容。請把問題讀回來確認經辦人。
轉換被拒絕。 該問題的工作流程當下不提供這個轉換。請列出該問題可用的轉換,並使用其中一個 ID。
問題沒有被更新。 寫入不會自動重試。請在 Jira 中打開該問題,確認實際結果後再重複操作。
相關內容
- 連接器目錄 — 其他連接器與它們的用途。
- Skills & Connectors — Skill 的呼叫方式、計費與限制。
- 管理存取與角色 — 限制誰能讀取與變更已連接的資料。