連接 Jira
將 Jira 與 Notion 連接，享受流暢體驗，讓您與團隊隨時掌握最新進度 🔗
Notion 與 Jira 的連接讓您可以執行幾種不同的操作。您可以將 Jira 連結插入 Notion 頁面以快速存取或預覽，也可以將 Jira 專案與工作項目同步至 Notion 資料庫，以便在同一個地方追蹤所有工作。請繼續閱讀以深入了解不同連接形式及其設定方式。
Notion 提供兩種 Jira 連接：Jira 與 Jira Sync。您可以將它們視為輕量級與功能完整的選項。
如果您只需要將單一 Jira 專案與 Notion 資料庫同步一次，且不打算設定額外的同步、Jira 連結預覽、連結提及，以及透過 Jira 連接的 舊版同步資料庫，那麼這樣可能就足夠了。請記住：它使用的是使用者權杖 (user tokens)，可靠性通常不如 Jira Sync 所使用的管理員權杖 (admin tokens)。
若要跨多個專案與資料庫進行持續且靈活的同步，Jira Sync 是更新且功能更強大的選項。請注意：這需要 Jira 管理員才能設定。
Note: There’s no one-click migration from the legacy Jira connection to Jira Sync. They are separate connections, so setting up the new Jira Sync will require a full reinstallation.
Jira | Jira 同步 | |
|---|---|---|
用途 | • 連結預覽 | • [全新改良] 同步資料庫 |
設定 | 個人使用者連接 | 工作空間擁有者與 Jira 管理員 |
設定位置 |
|
|
更新舊版同步資料庫
舊版同步資料庫看起來像這樣。如果您確實有舊版同步資料庫，可以依照上述步驟，使用全新改良的 Jira Sync 在 Notion 中重新建立您的專案與議題資料庫。
建立連結預覽
Note: Link previews work with all Jira Software deployment models (Jira Cloud, Jira Data Center, and Jira Server).
若要預覽來自 Jira 的連結：
前往
設定→連接。如果您使用的是 Jira Cloud，請找到
Jira圖塊。如果您使用的是 Jira Data Center 或 Jira Server，請找到Jira preview (Data center)圖塊。您可能需要稍微向下捲動才能找到 Data Center 圖塊。接著，選取圖塊下方的連接。在出現的視窗中，選取您的 Jira 版本。接著，輸入您的網站 URL、使用者名稱與密碼，並選取
驗證。
成功驗證後，您會在連接清單頂端看到 Jira 或 Jira preview (Data center)。任何貼入 Notion 的 Jira 連結都應自動顯示為連結預覽。
或者，您也可以直接從 Notion 頁面設定連結預覽。操作方式如下：
在 Notion 頁面中，貼上 Jira 網址。
在出現的視窗中，若系統提示，請選取您的 Jira 版本。輸入您的網站網址、使用者名稱和密碼，然後選取
驗證。
建立連結提及
Note: Link mentions work with all Jira Cloud products.
將 Jira 連結貼入 Notion。
在出現的選單中選取「提及」，即可輕鬆在文件中參照專案或問題。
如果您尚未將 Jira 與 Notion 連接，當您將 Jira 連結貼入 Notion 時，系統會提示您進行連接。深入了解連結提及，請參閱 這篇文章 →
Jira Sync 連接會使用管理員 API 權杖 (而非使用者權杖) 將您的 Jira 專案連接至 Notion，提供更一致且集中的同步體驗。
為確保同步可靠，我們建議您選取 Create API token 來建立無範圍權限的權杖，而非 Create API token with scopes。
Jira Sync 會將您的 Jira 專案和工作項目顯示為 Notion 的專案和工作項目資料庫。此設定讓您能使用各種實用的 檢視、篩選和排序 來查看並追蹤多個專案。
您甚至可以使用身分對應將 Jira 身分連接至 Notion 個人檔案，以便在已同步的 Notion 資料庫中查看誰負責什麼工作。
在 Notion 的 企業版 中，Jira Sync 支援雙向同步，並會遵守 Notion 和 Jira 的權限，以確保存取與編輯的安全性。透過 Jira Sync，您可以充分利用 Notion 的功能，包括 關聯與匯總、僅限 Notion 的資料庫屬性，以及 Notion AI。使用 Notion AI 快速回答有關 Jira 專案的問題。
The Jira Sync connection connects your Jira projects to Notion using an Admin API token (rather than a user token), providing a more consistent and centralized syncing experience. To ensure reliable syncing, we recommend creating a scopeless token by selecting Create API token, not Create API token with scopes.
Note:
A workspace owner must set up Jira Sync first using a Jira Admin token. After that, any member can utilize the connection.
You can create a Jira service account to set up Jira Sync — just make sure the service account has access to any projects you want to sync into Notion beforehand.
Synced databases work with Jira Cloud products (Jira Software, Jira Product Discovery, Jira Work Management, and Jira Service Management), with support for Jira Server coming soon!
設定 Jira Sync
Note: If you’ve already set up a Jira Sync and you’re on Notion’s Enterprise Plan, you can update your Jira synced database to the new two-way sync functionality by clicking the Synced badge at the top of the database and toggling on 2-way sync. You’ll be prompted to re-authenticate. Once you’re authenticated, you can click into a Notion database cell and update any supported field in the work items synced database or add comments and attachments to the Jira synced database.
雖然任何成員都可以建立同步，但您需要成為 工作空間擁有者 才能進行 Jira Sync 的初始設定。
前往側邊欄的
設定→匯入→Jira Sync。您也可以貼上 Jira 資料庫連結，或使用斜槓命令
/jira sync。如果您先前已在 Notion 中建立過 Jira 同步資料庫，請開啟該資料庫並選取頂端的
優化您的 Jira Sync。
在出現的視窗中，選取
開始使用。輸入您的 Jira 管理員電子郵件、Jira 網站 URL 和 API 權杖，然後選取
下一步。
Tip: When creating an admin token for Jira Sync, we strongly recommend setting the expiration date as far in the future as possible.
Jira Sync relies on this token to maintain a stable connection. If it expires, the sync can break and updates may be missed.
新增同步作業
Note: Members need to authenticate their Jira to add or remove projects. They can only add projects they have access to in Jira.
前往側邊欄的
設定→匯入→Jira Sync。您也可以貼上 Jira 資料庫連結，或使用斜槓命令
/jira sync。
在出現的視窗中，選取
開始使用。選取您要從中同步的 Jira 網站。
選取
建立新同步，或在下拉式選單中選取您可能已有的任何現有同步。如果您選擇現有同步，您的專案將會新增至您現有的已同步專案與工作項目資料庫中。在開啟的資料庫中，您需要連接您的 Jira 帳號（除非您是設定該連接的工作空間擁有者）。在此處，選取您想要同步至 Notion 的資料。首先
選取要同步的專案，然後選取要同步的屬性。
如果您想為其他網站、團隊協作區或工作空間設定另一個 Jira 同步，請重複上述步驟。註解和附件（每個議題最多五個檔案，且不超過 1MB）也會同步。
您可以對資料庫頁面 套用權限，讓您的協作者能夠存取已同步的資料庫。
Note: Jira synced databases will inherit Notion permissions. Members can access synced databases on any pages they have permission to view.
If a member adds a private Jira project to a Notion page, anyone with Notion page access will see it.
您已同步資料庫中的人員屬性
同步資料庫將包含人員屬性！現在，您可以使用身分對應將第三方 JIRA 身分連接至您團隊的 Notion 個人檔案。若要執行此操作：
確認您已啟用 Jira Cloud。
確認您的姓名和電子郵件地址在 Notion 與 Jira 中皆相同。
請依照 此處 的說明，將您的可見度設定為
任何人。
編輯或刪除您的同步資料庫
若要編輯已同步至 Notion 資料庫的 Jira 專案與議題屬性，請選取同步資料庫頂端的 ••• → 來源。
若要刪除 Jira 同步資料庫，請選取同步資料庫頂端的 ••• → 刪除表格。
在初始匯入後，您的 Jira 同步專案會透過以下兩種方式保持最新狀態：
Webhook： 在 Jira 中所做的更新會透過 Webhook 即時傳送至 Notion。
這些變更通常會在幾分鐘內顯示，但偶爾可能會因網路或系統問題而發生延遲或漏掉更新的情況。
Webhook 設定會在首次建立同步時自動完成。
重新同步： 如果 漏掉 了 Webhook 更新，我們的重新同步機制會再次將您的集合與 Jira 同步，以確保其為最新狀態：
重新同步僅在集合被主動檢視時才會執行，且可能需要一些時間，對於大型集合尤其如此。
它每天最多執行一次，並會以「同步進行中」標籤顯示。
在此過程中，使用者無法修改同步設定（例如：新增/移除專案或屬性）。
Note: If a Jira property is a custom "text" field, it will be parsed as a text string and appear distorted—even if the input in Jira is a date, number, etc.
As an example, the field type in Jira must be set as a date field for the data to translate correctly in Notion and display as a date.
權限與驗證
雙向同步會同時遵守 Notion 和 Jira 的權限設定，以確保存取與編輯的安全性。
只有對已同步的 Jira 資料庫擁有編輯權限的使用者，才能啟用並使用雙向同步。
每位使用者都必須驗證其個人 Jira 帳號，才能啟用從 Notion 進行編輯的功能。如果您先前僅連接 Jira 以進行檢視，則需要重新驗證才能啟用編輯功能。
訪客或任何透過公開連結存取 Jira 同步資料庫的人員無法使用雙向同步。
專案資料庫
您的 Jira 專案將會同步至 Notion 專案資料庫。您的專案將會智慧對應至 Notion 中相關且已同步的工作項目資料庫內的對應 Jira 工作項目。此資料庫將隨附預先填入的預設資料庫檢視畫面，協助您更快速上手：
「進行中」（/表格瀏覽模式）：此瀏覽模式會顯示您已同步且狀態為進行中的專案。換句話說，此瀏覽模式不會顯示已完成的專案。此外也預設了負責人和日期的篩選器，讓搜尋更輕鬆。
「時間軸」瀏覽模式：此瀏覽模式會顯示專案名稱、狀態、負責人和完成率。此外也預設了狀態、負責人和日期的篩選器，讓搜尋更輕鬆。
「/看板瀏覽模式」：此瀏覽模式會顯示依狀態分組的專案（
規劃中、進行中）。您可以在••• 更多中自訂瀏覽模式中顯示的狀態。專案會依優先順序由高至低排序。「全部」（/表格瀏覽模式）：此瀏覽模式會顯示您所有已同步的專案。此外也預設了狀態、負責人和日期的篩選器，讓搜尋更輕鬆。
工作項目（議題）資料庫
您的 Jira 工作項目（里程碑、錯誤、任務、子任務、故事）將會同步至 Notion 工作項目資料庫，這相當於 Notion 的任務資料庫。如同已同步的專案資料庫，系統會為您建立預設的資料庫瀏覽模式，協助您更快速上手：
「依專案」（/表格瀏覽模式）：此瀏覽模式會顯示所有任務，並依專案分組。此外也預設了狀態、負責人、日期和專案的篩選器，讓搜尋更輕鬆。
「依里程碑」（表格瀏覽模式）：此瀏覽模式會顯示依里程碑分組的 Jira 故事、任務和錯誤。
「/看板瀏覽模式」：此瀏覽模式依狀態分組，並依優先順序由高至低排序。將會顯示的預設屬性為負責人、專案、優先順序和子任務。
「所有任務」（/表格瀏覽模式）：此瀏覽模式會顯示您所有已同步的任務。將會顯示的預設屬性為任務名稱、狀態、負責人、日期、優先順序、標記和專案。
「我的任務」（/表格瀏覽模式）：此瀏覽模式經過篩選，僅顯示指派給您的任務。此外也預設了狀態、日期和專案的篩選器。
Jira Sync 支援大多數的 Jira 屬性，但並非全部。以下是不支援的 Jira 屬性清單：
時間追蹤 | 解決結果 |
安全性層級 | Σ 進度 |
進度 | 限制為 |
StatusCategory | 排名 |
Note: While Notion doesn't support certain Jira custom properties, it does support all Jira primitive custom properties, such as string, number, select, person, and date.
Experiencing an issue with Jira Sync? See how you can troubleshoot common errors here →
目前，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 小時才能正確同步。雙向同步無法在行動裝置上使用（但單向同步可以）。
Note: If you delete a property in Jira, the associated database item in your synced database will be deleted too.
如果您的 webhook 註冊失敗，或是專案同步失敗，您會在資料庫上方看到 同步失敗。若要解決此問題，請嘗試使用不同的專案集再次同步。您也可以確保您的專案在 Jira 中沒有任何問題。
如果您的 Jira 權杖已失效，或是有人將 Jira 與 Notion 中斷連線，您會在資料庫上方看到 同步已停止。若要解決此問題，請在 同步已停止 旁選取 重新驗證。您必須是工作空間擁有者才能完成此程序。
一旦您的 Jira 執行個體與 Notion 重新連線，您的專案和工作項目資料庫將不會被重新建立；相反地，您將繼續使用您之前擁有的專案和工作項目資料庫。
如果您想要完全解除 Jira 與 Notion 的連線：
前往側邊欄中的
設定→匯入。選取 Jira 旁邊的
•••→移除。
