查看 Application Integration 支援的連接器。

Jira Cloud 觸發條件

Jira Cloud 觸發條件是一種連接器事件觸發條件，可讓您根據在 Jira Cloud 連線中訂閱的 Jira Cloud 事件，叫用整合作業。

事前準備

如果您打算為 Jira Cloud 觸發條件建立或設定新的連線，請確認您在專案中具備下列 IAM 角色：

  • 連接器管理員 (roles/connectors.admin)

    • 如要進一步瞭解如何授予角色，請參閱「管理存取權」。

將下列 IAM 角色授予要用於 Jira Cloud 觸發事件的服務帳戶：

  • Application Integration 叫用者 (roles/integrations.integrationInvoker)

    • 如要瞭解如何將角色授予服務帳戶，請參閱「管理服務帳戶的存取權」。

新增 Jira Cloud 觸發條件

如要在整合中新增 Jira Cloud 觸發條件，請執行下列步驟：

  1. 前往 Google Cloud 控制台的「Application Integration」頁面。

    前往「應用程式整合」

  2. 在導覽選單中，按一下「整合」

    系統隨即會顯示「Integrations List」頁面，列出 Google Cloud 專案中可用的所有整合項目。

  3. 選取現有的整合，或按一下「建立整合」來建立新的整合。

    如果您要建立新的整合功能：

    1. 在「Create Integration」窗格中輸入名稱和說明。
    2. 選取整合作業的區域。
    3. 選取要用於整合的服務帳戶。您隨時可以透過整合工具列的 「整合摘要」窗格，變更或更新整合作業的服務帳戶詳細資料。
    4. 按一下 [建立]。

    新建立的整合服務會在整合服務編輯器中開啟。

  4. 在整合服務編輯器的導覽列中，按一下「觸發條件」，即可查看可用的觸發條件清單。
  5. 在整合服務編輯器中，按一下並放置「Jira Cloud trigger」元素。

    6. 如要設定 Jira Cloud 觸發條件，您可以使用整合連接器中現有的 Jira Cloud 連線，也可以使用內嵌連線建立選項建立新的 Jira Cloud 連線。

使用現有連結設定 Jira Cloud 觸發條件

您可以使用整合連接器中的現有 Jira Cloud 連線，設定 Jira Cloud 觸發條件。請注意，Jira Cloud 觸發事件是連接器事件觸發事件，因此您只能使用已啟用事件訂閱的 Jira Cloud 連線來設定觸發事件。

如要瞭解如何使用新的 Jira Cloud 連線設定 Jira Cloud 觸發條件，請參閱「使用新的連線設定 Jira Cloud 觸發條件」

如要使用現有的 Jira Cloud 連線設定 Jira Cloud 觸發條件，請執行下列步驟：

  1. 按一下整合服務編輯器中的「Jira Cloud 觸發條件」元素，開啟觸發條件設定窗格。
  2. 按一下「設定觸發條件」。
  3. 在「連接器事件觸發條件編輯器」頁面中提供下列設定詳細資料：
    1. 區域：選取 Jira Cloud 連線的區域。
    2. 連線：選取要使用的 Jira Cloud 連線。

      「應用程式整合」只會顯示已啟用事件訂閱的有效 Jira Cloud 連線。

    3. 事件訂閱類型：選取觸發整合的事件訂閱類型。如要瞭解此觸發事件支援的事件訂閱類型，請參閱「支援的事件訂閱類型」。
    4. 服務帳戶：選取 Jira Cloud 觸發條件所需的IAM 角色的服務帳戶。
  4. 按一下「完成」即可完成觸發條件設定，並關閉頁面。

使用新連線設定 Jira Cloud 觸發條件

如要使用新的 Jira Cloud 連線設定 Jira Cloud 觸發條件，請執行下列步驟：

  1. 按一下整合服務編輯器中的「Jira Cloud trigger」元素，開啟觸發條件設定窗格。
  2. 按一下「設定觸發條件」。
  3. 略過「區域」欄位。
  4. 按一下「連線」，然後在下拉式選單中選取「建立連線」選項。
  5. 在「建立連線」窗格中完成下列步驟：
    1. 在「Location」(位置)步驟中，選擇新 Jira Cloud 連線的位置：
      1. 區域：從下拉式清單中選取區域。
      2. 點按「Next」。
    2. 在「連線詳細資料」步驟中，提供新 Jira Cloud 連線的詳細資料：
      1. 連接器版本：從下拉式清單中選擇可用的 Jira Cloud 連接器版本。
      2. 連線名稱：輸入 Jira Cloud 連線的名稱。
      3. (選用) 說明： 輸入連線的說明。
      4. (選用) 啟用 Cloud Logging：勾選這個核取方塊，即可儲存連線的所有記錄資料。
      5. 服務帳戶：選取具備 Jira Cloud 連線必要 IAM 角色的服務帳戶。
      6. 啟用事件訂閱：選取此選項，即可為 Jira Cloud 連線建立及啟用新的事件訂閱。您可以只啟用事件訂閱，也可以加入連線實體、作業和動作。
      7. (選用) 展開「進階設定」，設定連線節點設定。

        如要進一步瞭解 Jira Cloud 的連結節點設定，請參閱 Jira Cloud 連結說明文件。

      8. (選用) 按一下「+ 新增標籤」，以鍵/值組合的形式為連線新增標籤。
      9. 點按「Next」。
    3. 在「目的地」步驟中，提供 Jira Cloud 帳戶詳細資料：
      1. 目的地類型：選取「主機位址」。
      2. 主機：輸入 Jira Cloud 帳戶的主機名稱或 IP 位址。
      3. 點按「Next」。
    4. 在「驗證」步驟中，提供 Jira Cloud 帳戶的驗證詳細資料：
      1. 使用者名稱：輸入要用來存取所提供目的地地址的使用者名稱。
      2. API 權杖：選取包含與 Jira Cloud 使用者名稱相關聯的 API 權杖的 Secret Manager 密鑰。
      3. 密鑰版本：選取密鑰版本。

        4. 如要進一步瞭解如何設定驗證機制，請參閱「設定驗證」。

      4. 點按「Next」。
    5. 在「事件訂閱詳細資料」步驟中，提供 Jira Cloud 帳戶的詳細資料，系統會在該帳戶中建立事件訂閱項目。
      1. 目的地類型：選取「主機位址」。
      2. 主機：輸入 Jira Cloud 帳戶的註冊網址。系統會為此網址建立事件訂閱項目。
      3. 使用者名稱：輸入使用者名稱，即可存取提供的註冊網址。
      4. API 權杖：選取 Secret Manager 密鑰，內含與使用者名稱相關聯的 API 權杖。
      5. 密鑰版本：選取密鑰版本。
      6. 點按「Next」。
    6. 查看：查看提供的 Jira Cloud 連線詳細資料。
    7. 按一下「建立」，即可完成建立新的 Jira Cloud 連線。
  6. 事件訂閱類型：選取觸發整合的事件訂閱類型。如要瞭解此觸發事件支援的事件訂閱類型，請參閱「支援的事件訂閱類型」。
  7. 按一下「完成」關閉頁面。

觸發輸出

Jira Cloud 觸發事件需要幾分鐘才能完成事件訂閱設定。您可以在觸發事件設定窗格中的「事件訂閱詳細資料」下方，查看事件訂閱的狀態。

Jira Cloud 觸發條件會使用下列狀態表示事件訂閱的狀態：

  • Creating：表示觸發事件正在訂閱事件訂閱項目。
  • Active：表示觸發事件已成功訂閱事件訂閱項目。
  • Error：表示已設定的事件訂閱項目發生問題。

除了事件訂閱狀態之外，「事件訂閱詳細資料」部分還會顯示其他詳細資料，例如連線區域、連線名稱、事件訂閱名稱等。

下圖為 Jira Cloud 觸發條件設定窗格範例版面配置：

顯示 Jira Cloud 觸發條件設定窗格的圖片 顯示 Jira Cloud 觸發條件設定窗格的圖片

觸發輸出變數

對於每個事件，Jira Cloud 觸發條件都會產生 ConnectorEventPayload 輸出變數，可用於後續工作。輸出變數採用 JSON 格式，內含 Jira Cloud 輸出酬載結構定義。

查看事件訂閱項目

如要在 Integration Connectors 中查看及管理與連線相關聯的所有事件訂閱，請按照下列步驟操作：

  1. 前往「Integration Connectors」>「Connections」頁面。

    前往「連線」頁面

  2. 按一下要查看訂閱項目的連線。
  3. 按一下「事件訂閱」分頁標籤。

    這會顯示連線的所有事件訂閱項目。

編輯 Jira Cloud 觸發條件

您可以編輯 Jira Cloud 觸發條件，變更或更新連線設定和事件訂閱詳細資料。

如要編輯 Jira Cloud 觸發條件，請執行下列步驟：

  1. 按一下整合服務編輯器中的「Jira Cloud trigger」元素，開啟觸發條件設定窗格。
  2. 按一下「設定 Jira Cloud 觸發條件」。
  3. 在「Connector Event Trigger Editor」頁面中執行下列操作：
    1. 如要保留先前設定的事件訂閱項目，請按一下「保留」，否則請按一下「刪除」。
    2. 視需要更新連線設定和事件訂閱詳細資料。
    3. 按一下 [完成]。

    4. 您可以在「事件訂閱詳細資料」下方的觸發事件設定窗格中，查看更新後的連線和事件訂閱詳細資料。

支援的事件訂閱類型

您可以使用 Jira Cloud 觸發條件，針對下列事件訂閱類型叫用整合：

事件訂閱類型 說明
attachment_created 為 Jira 支援單建立附件。
attachment_deleted 系統會刪除與 Jira 案件相關聯的附件。
board_created 系統會建立新的 Jira 看板。
board_deleted 刪除 Jira 看板。
comment_created 在 Jira 案件中新增註解。
comment_deleted Jira 案件中的留言已刪除。
comment_updated Jira 支援單中現有的註解已更新。
filter_created 系統會建立新的 Jira 篩選器。
filter_deleted 刪除 Jira 篩選器。
filter_updated 更新現有的 Jira 篩選器。
issue_created 系統會建立新的 Jira 問題。
issue_deleted Jira 問題已刪除。
issue_updated 更新現有的 Jira 問題。
issuelink_created 系統會為 Jira 例項建立新的問題連結。
issuelink_deleted 刪除 Jira 執行個體的問題連結。
option_issuelinks_changed 變更或更新 Jira 例項的現有問題連結。
option_subtasks_changed 問題的子工作已更新或變更。
option_voting_changed Jira 問題的投票次數已變更。
option_watching_changed 已變更觀察員或已加入觀察 Jira 問題的使用者名單。
project_created 系統會建立新專案。
project_deleted 刪除專案。
project_restored_deleted 已刪除的專案已還原。
project_soft_deleted 刪除專案後，任何使用者都無法查看該專案，包括使用產品介面或 API 的管理員。
project_updated 專案詳細資料已更新。
sprint_closed 衝刺期間已結束。
sprint_created 建立衝刺週。
sprint_deleted 刪除衝刺期。
sprint_updated 變更或更新衝刺期的詳細資料。
user_created 已建立使用者。
user_updated 使用者的詳細資料已變更或更新。
worklog_created 新增工作記錄項目。
worklog_deleted 工作記錄項目已刪除。
worklog_updated 工作日誌項目已變更或更新。

配額與限制

如要進一步瞭解配額和限制，請參閱「配額與限制」。

後續步驟