連接 Jira

Notion 與 Jira 的連接讓您可以執行幾種不同的操作。您可以將 Jira 連結插入 Notion 頁面以快速存取或預覽，也可以將 Jira 專案與工作項目同步至 Notion 資料庫，以便在同一個地方追蹤所有工作。請繼續閱讀以深入了解不同連接形式及其設定方式。

Notion 提供兩種 Jira 連接：Jira 與 Jira Sync。您可以將它們視為輕量級與功能完整的選項。

如果您只需要將單一 Jira 專案與 Notion 資料庫同步一次，且不打算設定額外的同步、Jira 連結預覽、連結提及，以及透過 Jira 連接的 舊版同步資料庫，那麼這樣可能就足夠了。請記住：它使用的是使用者權杖 (user tokens)，可靠性通常不如 Jira Sync 所使用的管理員權杖 (admin tokens)。

若要跨多個專案與資料庫進行持續且靈活的同步，Jira Sync 是更新且功能更強大的選項。請注意：這需要 Jira 管理員才能設定。

舊版同步資料庫看起來像這樣。如果您確實有舊版同步資料庫，可以依照上述步驟，使用全新改良的 Jira Sync 在 Notion 中重新建立您的專案與議題資料庫。

若要預覽來自 Jira 的連結：

1. 前往 設定 → 連接。

2. 如果您使用的是 Jira Cloud，請找到 Jira 圖塊。如果您使用的是 Jira Data Center 或 Jira Server，請找到 Jira preview (Data center) 圖塊。您可能需要稍微向下捲動才能找到 Data Center 圖塊。接著，選取圖塊下方的 連接。

3. 在出現的視窗中，選取您的 Jira 版本。接著，輸入您的網站 URL、使用者名稱與密碼，並選取 驗證。

成功驗證後，您會在連接清單頂端看到 Jira 或 Jira preview (Data center)。任何貼入 Notion 的 Jira 連結都應自動顯示為連結預覽。

或者，您也可以直接從 Notion 頁面設定連結預覽。操作方式如下：

1. 在 Notion 頁面中，貼上 Jira 網址。

2. 在出現的視窗中，若系統提示，請選取您的 Jira 版本。輸入您的網站網址、使用者名稱和密碼，然後選取 驗證。

1. 將 Jira 連結貼入 Notion。

2. 在出現的選單中選取「提及」，即可輕鬆在文件中參照專案或問題。

   • 如果您尚未將 Jira 與 Notion 連接，當您將 Jira 連結貼入 Notion 時，系統會提示您進行連接。深入了解連結提及，請參閱 這篇文章 →

Jira Sync 連接會使用管理員 API 權杖 (而非使用者權杖) 將您的 Jira 專案連接至 Notion，提供更一致且集中的同步體驗。

為確保同步可靠，我們建議您選取 Create API token 來建立無範圍權限的權杖，而非 Create API token with scopes。

現在您可以充分利用 Notion 的功能，包括 自動化、匯總 和 Notion AI。使用 Notion AI 快速回答有關 Jira 專案的問題。

Jira Sync 會將您的 Jira 專案和工作項目顯示為 Notion 的專案和工作項目資料庫。此設定讓您能使用各種實用的 檢視、篩選和排序 來查看並追蹤多個專案。

您甚至可以使用身分對應將 Jira 身分連接至 Notion 個人檔案，以便在已同步的 Notion 資料庫中查看誰負責什麼工作。

在 Notion 的 企業版 中，Jira Sync 支援雙向同步，並會遵守 Notion 和 Jira 的權限，以確保存取與編輯的安全性。透過 Jira Sync，您可以充分利用 Notion 的功能，包括 關聯與匯總、僅限 Notion 的資料庫屬性，以及 Notion AI。使用 Notion AI 快速回答有關 Jira 專案的問題。

雖然任何成員都可以建立同步，但您需要成為 工作空間擁有者 才能進行 Jira Sync 的初始設定。

1. 前往側邊欄的 設定 → 匯入 → Jira Sync。

   • 您也可以貼上 Jira 資料庫連結，或使用斜槓命令 /jira sync。

   • 如果您先前已在 Notion 中建立過 Jira 同步資料庫，請開啟該資料庫並選取頂端的 優化您的 Jira Sync。

2. 在出現的視窗中，選取 開始使用。

3. 輸入您的 Jira 管理員電子郵件、Jira 網站 URL 和 API 權杖，然後選取 下一步。

1. 前往側邊欄的 設定 → 匯入 → Jira Sync。

   • 您也可以貼上 Jira 資料庫連結，或使用斜槓命令 /jira sync。

2. 在出現的視窗中，選取 開始使用。

3. 選取您要從中同步的 Jira 網站。

4. 選取 建立新同步，或在下拉式選單中選取您可能已有的任何現有同步。如果您選擇現有同步，您的專案將會新增至您現有的已同步專案與工作項目資料庫中。

5. 在開啟的資料庫中，您需要連接您的 Jira 帳號（除非您是設定該連接的工作空間擁有者）。在此處，選取您想要同步至 Notion 的資料。首先 選取要同步的專案，然後 選取要同步的屬性。

如果您想為其他網站、團隊協作區或工作空間設定另一個 Jira 同步，請重複上述步驟。註解和附件（每個議題最多五個檔案，且不超過 1MB）也會同步。

您可以對資料庫頁面 套用權限，讓您的協作者能夠存取已同步的資料庫。

同步資料庫將包含人員屬性！現在，您可以使用身分對應將第三方 JIRA 身分連接至您團隊的 Notion 個人檔案。若要執行此操作：

1. 確認您已啟用 Jira Cloud。

2. 確認您的姓名和電子郵件地址在 Notion 與 Jira 中皆相同。

3. 請依照 此處 的說明，將您的可見度設定為 任何人。

若要編輯已同步至 Notion 資料庫的 Jira 專案與議題屬性，請選取同步資料庫頂端的 ••• → 來源。

若要刪除 Jira 同步資料庫，請選取同步資料庫頂端的 ••• → 刪除表格。

在初始匯入後，您的 Jira 同步專案會透過以下兩種方式保持最新狀態：

• Webhook： 在 Jira 中所做的更新會透過 Webhook 即時傳送至 Notion。

  • 這些變更通常會在幾分鐘內顯示，但偶爾可能會因網路或系統問題而發生延遲或漏掉更新的情況。

  • Webhook 設定會在首次建立同步時自動完成。

• 重新同步： 如果 漏掉 了 Webhook 更新，我們的重新同步機制會再次將您的集合與 Jira 同步，以確保其為最新狀態：

  • 重新同步僅在集合被主動檢視時才會執行，且可能需要一些時間，對於大型集合尤其如此。

  • 它每天最多執行一次，並會以「同步進行中」標籤顯示。

    • 在此過程中，使用者無法修改同步設定（例如：新增/移除專案或屬性）。

雙向同步會同時遵守 Notion 和 Jira 的權限設定，以確保存取與編輯的安全性。

• 只有對已同步的 Jira 資料庫擁有編輯權限的使用者，才能啟用並使用雙向同步。

• 每位使用者都必須驗證其個人 Jira 帳號，才能啟用從 Notion 進行編輯的功能。如果您先前僅連接 Jira 以進行檢視，則需要重新驗證才能啟用編輯功能。

• 訪客或任何透過公開連結存取 Jira 同步資料庫的人員無法使用雙向同步。

您的 Jira 專案將會同步至 Notion 專案資料庫。您的專案將會智慧對應至 Notion 中相關且已同步的工作項目資料庫內的對應 Jira 工作項目。此資料庫將隨附預先填入的預設資料庫檢視畫面，協助您更快速上手：

• 「進行中」（/表格瀏覽模式）：此瀏覽模式會顯示您已同步且狀態為進行中的專案。換句話說，此瀏覽模式不會顯示已完成的專案。此外也預設了負責人和日期的篩選器，讓搜尋更輕鬆。

• 「時間軸」瀏覽模式：此瀏覽模式會顯示專案名稱、狀態、負責人和完成率。此外也預設了狀態、負責人和日期的篩選器，讓搜尋更輕鬆。

• 「/看板瀏覽模式」：此瀏覽模式會顯示依狀態分組的專案（規劃中、進行中）。您可以在••• 更多中自訂瀏覽模式中顯示的狀態。專案會依優先順序由高至低排序。

• 「全部」（/表格瀏覽模式）：此瀏覽模式會顯示您所有已同步的專案。此外也預設了狀態、負責人和日期的篩選器，讓搜尋更輕鬆。

您的 Jira 工作項目（里程碑、錯誤、任務、子任務、故事）將會同步至 Notion 工作項目資料庫，這相當於 Notion 的任務資料庫。如同已同步的專案資料庫，系統會為您建立預設的資料庫瀏覽模式，協助您更快速上手：

• 「依專案」（/表格瀏覽模式）：此瀏覽模式會顯示所有任務，並依專案分組。此外也預設了狀態、負責人、日期和專案的篩選器，讓搜尋更輕鬆。

• 「依里程碑」（表格瀏覽模式）：此瀏覽模式會顯示依里程碑分組的 Jira 故事、任務和錯誤。

• 「/看板瀏覽模式」：此瀏覽模式依狀態分組，並依優先順序由高至低排序。將會顯示的預設屬性為負責人、專案、優先順序和子任務。

• 「所有任務」（/表格瀏覽模式）：此瀏覽模式會顯示您所有已同步的任務。將會顯示的預設屬性為任務名稱、狀態、負責人、日期、優先順序、標記和專案。

• 「我的任務」（/表格瀏覽模式）：此瀏覽模式經過篩選，僅顯示指派給您的任務。此外也預設了狀態、日期和專案的篩選器。

Jira Sync 支援大多數的 Jira 屬性，但並非全部。以下是不支援的 Jira 屬性清單：

• 目前，Jira Sync 僅適用於 Jira Cloud。不支援 Jira Data Center 和 Jira Server。

• 初始同步完成只需幾分鐘，但根據您的 Jira 專案和工作項目大小，這可能需要長達幾個小時。

• 某些問題欄位或屬性可能無法同步，例如屬性中的富文本以及嵌套的多選欄位。

• 雖然您可以編輯狀態、負責人、優先順序、附件和留言，但某些問題欄位或屬性無法編輯。這些包括描述、標題、/日期、自訂欄位以及其他選取或多選欄位（優先順序和狀態除外）。

• 在 Notion 中發表的留言將會新增至 Jira，但之後您將無法編輯或刪除它們。

• 附件大小上限為 1MB。每個 Jira 問題最多可有五個附件。如果您嘗試上傳超過大小限制的附件，上傳將會失敗。

  • 您無法將附件拖放至問題中。請使用附件圖示來新增附件。

• 只有已在同步的 Jira 工作項目中使用過的優先順序值才會出現在 Notion 中 — Jira 中存在但尚未使用的選項將無法選取。若要使其可選取，請將這些值指派給至少一個已同步至 Notion 的 Jira 問題。

• 為了獲得最佳效能，超過 1,000 個值的 Jira 屬性將不會匯入。

• 一旦設定好初始同步，屬性的更新應會即時反映在 Notion 中。如果您建立新的屬性，這些變更可能需要長達 12 小時才能同步。

• 您無法手動將 Jira 與 Notion 同步 — 同步是根據 Jira 中所做的更新而自動進行的。

• 您可以將滑鼠游標懸停在資料庫最上方的 藍色 徽章上，查看 Notion 上次與 Jira 同步 的時間。如果您看到的是 黃色 的 同步失敗 或 同步已停止，您可能需要依照 下列步驟 重新連線 Jira。

• 觀察者 屬性可能需要長達 12 小時才能正確同步。

• 雙向同步無法在行動裝置上使用（但單向同步可以）。

如果您的 webhook 註冊失敗，或是專案同步失敗，您會在資料庫上方看到 同步失敗。若要解決此問題，請嘗試使用不同的專案集再次同步。您也可以確保您的專案在 Jira 中沒有任何問題。

如果您的 Jira 權杖已失效，或是有人將 Jira 與 Notion 中斷連線，您會在資料庫上方看到 同步已停止。若要解決此問題，請在 同步已停止 旁選取 重新驗證。您必須是工作空間擁有者才能完成此程序。

一旦您的 Jira 執行個體與 Notion 重新連線，您的專案和工作項目資料庫將不會被重新建立；相反地，您將繼續使用您之前擁有的專案和工作項目資料庫。

如果您想要完全解除 Jira 與 Notion 的連線：

1. 前往側邊欄中的 設定 → 匯入。

2. 選取 Jira 旁邊的 ••• → 移除。