Atlassian Jira cloud Microsoft Graph 連接器

Atlassian Jira cloud Microsoft Graph 連接器可讓您的組織從 Jira 雲端實例為問題編製索引。 設定連接器之後,終端使用者可以在 Microsoft Copilot 和任何Microsoft搜尋用戶端中,從 Jira 搜尋這些問題。

本文適用於Microsoft 365 位系統管理員或設定、執行及監視 Jira cloud Graph 連接器的任何人。

功能

  • 從 Jira 雲端) (或票證的索引問題
  • 讓終端使用者在 Copilot 中詢問與專案追蹤、支持查詢或工作執行相關的問題。
    • 找出行動應用程式未載入的問題。
    • 尋找 John 所報告的 Jira 工作,以更新 API 移轉的相關文件。
    • 摘要 CP-1234。
  • Copilot 中使用語意搜尋 ,讓用戶能夠根據關鍵詞、個人喜好設定和社交連線來尋找相關內容。

限制

  • 連接器不支援「任何登入的使用者」應用程式角色,以將問題的存取權授與使用者。
  • 連接器不會為附件編製索引。

必要條件

  • 您必須是組織Microsoft 365 租使用者的 搜尋管理員

  • Jira 雲端實例 URL:若要連線到您的 Jira 數據,您需要組織的 Jira 實例 URL。 您組織的 Jira 實體 URL 通常看起來像 。https://<your-organization-domain>.atlassian.net 如果您還沒有實例,請參閱 頁面 以建立測試實例。

  • 服務帳戶:若要連線到 Jira 並允許 Microsoft Graph 連接器定期更新問題,您需要具有下列許可權的服務帳戶。

    許可權名稱 許可權類型 的必要專案
    瀏覽專案 項目許可權 編目 Jira 問題。 此許可權是需要編製索引之專案的 必要 許可權。
    問題層級安全性許可權 問題層級安全性 編目不同的問題類型。 此許可權是 選擇性的
    瀏覽使用者和群組 通用權限 根據搜尋結果的訪問許可權調整安全性。 此許可權是 選擇性的 ,必須選 Only people with access to this data source 取下列步驟 4 中的選項。
    管理 Jira 通用權限 根據搜尋結果的訪問許可權調整安全性。 此許可權是 選擇性的 ,必須選 Only people with access to this data source 取下列步驟 4 中的選項。

開始使用

顯示適用於 Jira 雲端的 Graph 連接器Microsoft連線建立畫面的螢幕快照。

1.顯示名稱

顯示名稱可用來識別 Copilot 中的每個引文,協助使用者輕鬆辨識相關聯的檔案或專案。 顯示名稱也代表受信任的內容。 顯示名稱也會當做 內容來源篩選條件使用。 此欄位有預設值,但您可以將它自定義為組織中用戶可辨識的名稱。

2.Jira 雲端 URL

若要連線到 Jira 雲端數據,您需要組織的 Jira 實例 URL。 您組織的 Jira 實體 URL 通常看起來像 。https://<your-organization-domain>.atlassian.net

3.驗證類型

若要從 Jira 驗證和同步處理問題,請選擇 兩個支援的方法之一

a. 基本驗證
輸入您帳戶的使用者名稱 (通常是電子郵件標識碼) 和 API 令牌,以使用基本身份驗證進行驗證。請參閱 Atlassian 關於如何 管理 Atlassian 帳戶之 API 令牌 的檔,以深入瞭解如何產生 API 令牌。

b. Atlassian Jira OAuth 2.0 (建議)

若要使用 Jira OAuth 進行驗證,請遵循下列步驟。

在 Atlassian Jira 中註冊應用程式,讓Microsoft搜尋應用程式可以存取實例。 若要深入瞭解,請參閱 Atlassian 支援檔,以瞭解如何 啟用 OAuth 2.0

下列步驟提供如何註冊應用程式的指引:

  1. 使用 Atlassian Jira 系統管理員帳戶登入 Atlassian Developer 控制台

  2. 選取 [開啟 Create ],然後選取 OAuth 2.0 integration

  3. 為應用程式提供適當的名稱,並建立新的應用程式。

  4. 從左方的瀏覽窗格巡覽至 Permissions 。 針對 選 AddJira API ,然後按下 Configure。 在 [細微許可權] 標頭下,新增下列範圍。

    # 範圍名稱 代碼
    1 檢視欄位 read:field:jira
    2 檢視虛擬人偶 read:avatar:jira
    3 檢視項目類別 read:project-category:jira
    4 檢視專案 read:project:jira
    5 讀取欄位組態 read:field-configuration:jira
    6 檢視問題類型 read:issue-type:jira
    7 檢視項目屬性 read:project.property:jira
    8 檢視使用者 read:user:jira
    9 檢視應用程式角色 read:application-role:jira
    10 檢視群組 read:group:jira
    11 讀取問題類型階層 read:issue-type-hierarchy:jira
    12 檢視專案版本 read:project-version:jira
    13 檢視專案元件 read:project.component:jira
    14 檢視問題詳細數據 read:issue-details:jira
    15 檢視稽核記錄 read:audit-log:jira
    16 檢視問題中繼 read:issue-meta:jira
    17 檢視專案角色 read:project-role:jira
    18 檢視問題安全性層級 read:issue-security-level:jira
    19 檢視問題安全性配置 read:issue-security-scheme:jira
    20 檢視許可權配置 read:permission-scheme:jira
    21 檢視許可權 read:permission:jira
  5. 從左方的瀏覽窗格巡覽至 Authorization 。 針對 M365 Government 新增 M365 Enterprisehttps://gcs.office.com/v1.0/admin/oauth/callback的回呼 URL:https://gcsgcc.office.com/v1.0/admin/oauth/callback,並儲存變更。

  6. Settings從左方的瀏覽窗格巡覽至 ,以從此頁面取得 Client IDSecret

使用 用戶端識別 碼和 秘密完成連線設定步驟。

注意

  • 若要深入瞭解 Jira 許可權,請參閱 OAuth 2.0 應用程式 的範圍清單
  • Jira 雲端的原始 (傳統) OAuth 許可權已被取代。 若要深入瞭解,請參閱 changelog 公告

4.向有限的物件推出

如果您想要先在 Copilot 和其他搜尋介面中驗證此連線,再將推出擴充至更廣泛的物件,請將此連線部署至有限的使用者基底。 若要深入瞭解有限的推出,請參閱 分段推出

此時,您已準備好建立 Jira 雲端的連線。 您可以按下 [建立] 按鈕,從 Jira 帳戶發佈連線和索引問題。

對於其他設定,例如訪問許可權、數據包含規則、架構、編目頻率等,我們會根據最適合 Jira 資料的設定來設定預設值。 您可以在下方看到預設值:

使用者 描述
訪問許可權 只有具有數據源中內容存取權的人員。
對應身分識別 使用 Microsoft Entra標識碼對應的數據源身分識別。
內容 描述
網站專案 所有項目都會編製索引。
篩選數據 所有問題都會編製索引。 不會套用時間篩選或 JQL 準則。
管理屬性 若要檢查預設屬性及其架構,請參閱 內容
同步處理 描述
累加編目 頻率:每 15 分鐘
完整編目 頻率:每天

如果您想要編輯其中任何一個值,您必須選擇 [自訂安裝] 選項。

自訂安裝程式

自訂設定適用於想要編輯上表所列設定之預設值的系統管理員。 按兩下 [自定義安裝] 選項之後,您會看到另外三個索引標籤 - [使用者]、[內容] 和 [同步]。

使用者

顯示 [使用者] 索引標籤標的螢幕快照,您可以在其中設定訪問許可權和使用者對應規則。

訪問許可權

Atlassian Jira 連接器支援 所有人只有具有此數據源存取權的人員可以看見的搜尋許可權。 如果您選擇 [ 所有人],已編製索引的數據會出現在所有使用者的搜尋結果中。 如果您選擇 [僅限可存取此數據源的人員],則只有具有此數據源存取權的使用者,索引數據才會出現在搜尋結果中。 在 Atlassian Jira 中,安全性許可權是使用包含網站層級群組和專案角色的專案許可權配置來定義。 問題層級安全性也可以使用問題層級許可權配置來定義。

重要

Jira cloud Graph 連接器必須能夠讀取 Jira 中使用者的電子郵件識別碼,才能在Microsoft搜尋中適當地指派安全性許可權。 這需要您確保下列其中一項:

  • 所有屬於受管理帳戶的使用者,都必須在配置檔可見性設定中選取受管理的帳戶設定。

    所有使用者都應該已針對其配置檔可見性設定選取 [任何人] 選項。 若要深入瞭解配置檔可見性設定,請參閱 Atlassian 的檔

  • 不屬於受管理帳戶 (與編目帳戶) 相同的使用者,必須在其配置檔可見性設定中選取 [任何人]。

    對於使用「受控帳戶」的組織 (所有具有已驗證網域電子郵件位址的 Atlassian 帳戶都會變成受控帳戶。如需) 的詳細資訊,請參閱 本檔

此外,在聯機設定期間使用的編目帳戶必須具有受控帳戶網域。

對應身分識別

將數據源身分識別與 Microsoft Entra ID 對應的預設方法是檢查 Jira 使用者的 Email 標識碼是否與 UPN) (UserPrincipalName 或 Microsoft Entra 中使用者的 Mail 相同。 如果您認為預設對應不適用於您的組織,您可以提供自定義對應公式。 若要深入了解對應非 Microsoft Entra ID 身分識別,請參閱對應您的非 Azure AD 身分識別

若要識別哪個選項適合您的組織:

  1. 如果 Jira 使用者的 Email 識別碼與 Microsoft Entra ID 中使用者的 USERPrincipalName (UPN) 相同,請選擇 [Microsoft Entra ID] 選項。
  2. 如果 Jira 使用者的 Email 識別符不同於 UserPrincipalName (UPN) 和 Microsoft Entra ID 中使用者的 Email,請選擇 [非 Microsoft Entra ID] 選項。

注意

匯報 管理訪問許可權的群組只會在完整編目中同步處理。 累加編目不支援處理許可權的更新。

內容

選擇項目和篩選數據

  1. 網站專案

    您可以選擇連線,只為整個 Jira 網站或特定項目編製索引。

    • 如果您選擇為整個 Jira 網站編製索引,則會為站臺中所有專案中的 Jira 問題編制索引。 新項目和問題會在建立後於下一個編目期間編製索引。

    • 如果您選擇個別專案,則只會編製所選專案中的 Jira 問題索引。

    注意

    當您將 [瀏覽專案 ] 許可權授與 Jira 專案時,該專案會列在項目選取範圍中,而且可以進行編目。 如果專案遺失,請檢查您帳戶的許可權。

  2. 篩選數據

    您可以進一步選擇篩選以兩種方式編製索引的 Jira 問題。

    • 指定 問題修改時間週期。 此選項只會根據目前的編目,在以 滾動為基礎 選取的期間內建立或修改的 Jira 問題編製索引。

    • 指定 JQL。 此選項只會根據提供的 Jira 查詢語言 (JQL) ,為篩選後傳回的 Jira 問題編製索引。 若要深入瞭解如何使用 JQL,請參閱 Atlassian 支援檔,以瞭解如何 搭配 Jira 查詢語言使用進階搜尋

    提示

    您可以使用 JQL 篩選器,只使用 「issueType in (Bug,Improvement) 」 為特定 Jira 問題類型編製索引

管理屬性

在這裡,您可以從 Jira 數據源新增或移除可用的屬性、將架構指派給屬性, (定義屬性是否可搜尋、可查詢、可擷取或可精簡) 、變更語意卷標,並將別名新增至 屬性。 以下列出預設選取的屬性。

Source 屬性 標籤 描述 Schema
Authors Authors 為數據源中參與/共同作業專案的所有人員命名 取回
已建立 建立日期時間 在數據源中建立項目的數據和時間 查詢、擷取
IssueDescription 內容 問題的描述 搜尋
IssueIconURL IconUrl 代表問題類型的圖示 URL。 取回
IssueId
IssueKey
IssueLink URL 數據源中項目的目標 URL 查詢、擷取
IssueStatus 查詢
IssueSummary
ProjectName 查詢
ReporterEmailId 建立者 取回
ReporterName 查詢、擷取
標題 標題 您想要在 Copilot 和其他搜尋體驗中顯示的項目標題 搜尋、查詢、擷取
已更新 上次修改日期時間 上次在數據源中修改專案的日期和時間。 查詢、擷取

注意

  • Atlassian Jira 連接器可以為預設問題欄位和自定義建立的問題欄位編製索引。
  • 如果某些 Jira 問題類型 (的) 中沒有選取的自定義建立欄位,欄位將會內嵌為 NULL (空白) 。

您在此處選取的屬性清單,可能會影響您在 Copilot 中篩選、搜尋及檢視結果的方式,Microsoft 365。

預覽數據

使用 [預覽結果] 按鈕來驗證所選屬性和查詢篩選的範例值。

同步處理

顯示 [同步] 索引標籤的螢幕快照,您可以在其中設定編目頻率。

重新整理間隔會決定數據源與 Graph 連接器索引之間同步處理資料的頻率。 重新整理間隔有兩種類型 : 完整編目和累加編目。 如需詳細資訊,請參閱 重新整理設定

您可以視需要從這裏變更重新整理間隔的預設值。

設定搜尋結果頁面

建立連線之後,您必須使用垂直和結果類型來自定義搜尋結果頁面。 若要瞭解如何自定義搜尋結果,請檢閱如何 管理垂直結果類型。 您也可以使用 Jira 連接器的 範例結果配置 。 複製並貼上結果配置 JSON,以在檢閱具有範例版面配置所需架構的連線架構之後開始使用。

疑難排解

發佈連線之後,您可以在系統管理中心的 [數據源] 索引卷標下檢閱狀態。 若要瞭解如何進行更新和刪除,請參閱 管理您的連接器。 您可以在 Atlassian Jira Cloud Microsoft Graph 連接器的疑難解答指南中找到常見問題的疑難解答步驟。

如果您有任何其他問題或想要提供意見反應,請在 Microsoft Graph 支援中與我們連絡。