Webhook と統合する
URL エンドポイントには、Web から URL にアクセスできる限り、任意のプラットフォーム、Web サーバーなどを指定できます。Webhook データには、アラート アクティビティ (作成、承認など) とアラート フィールドのサブセット (アラート ID、ユーザー名、エイリアス、エンティティ、ユーザー ID) が、HTTP リクエスト ペイロード (JSON) の一部として含まれます。カスタム ヘッダーを定義して Webhook 呼び出しを追加することもできます。関連するチェックボックスをオンにするだけで、アラートの説明と詳細を送信できます。
Webhook 統合によって送信されるアラート アクション データでは、[Description (説明)] フィールドと [Details (詳細)] フィールドは 1000 文字に切り捨てられます。
Webhook の統合を追加する
The following capabilities are available in Jira Service Management Premium and Enterprise:
双方向の統合
Outgoing integrations at the team level
Integrations at a site level through Settings (icon) > Products (under Jira settings) > Operations
To access Jira Service Management Premium features, you must subscribe to a Service Collection Premium or Enterprise plan.
Adding an integration from your team’s operations page makes your team the owner of the integration. This means Jira Service Management only assigns the alerts received through this integration to your team.
Webhook は送信統合であるため、使用できるのは Premium プランと Enterprise プランのみです。Jira Service Management で Webhook 統合を追加するには、次の手順を実行します。
Next to Operations in the sidebar, select More actions (), then General configuration.
Select Integrations and then Add integration.
検索を実行して「Webhook」を選択します。
次の画面で、統合の名前を入力します。
オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。
[Continue] を選択します。
この時点で、統合が保存されます。統合設定ページの [Edit (編集)] に移動します。
[Edit integration settings (統合設定を編集)] ダイアログが開きます。[Authenticate with a Webhook account (Webhook アカウントで認証)] を選択します。
Webhook URL を [Webhook URL] に貼り付けます。
Webhook 呼び出し用に追加の HTTP ヘッダーを設定します。
必要に応じて、[Add alert description to payload (ペイロードにアラートの説明を追加)] と [Add alert details to payload (ペイロードにアラートの詳細を追加)] を選択します。
[保存] を選択します。
[統合をオンにする] を選択します。
統合のために作成したルールは、統合をオンにした場合にのみ機能します。
[Add alert description to payload (ペイロードにアラートの説明を追加)] と [Add alert details to payload (ペイロードにアラートの詳細を追加)] の各オプションは作成アクションとカスタム アラート アクションでのみ使用できます。
アラート アクションをマッピングする
Jira Service Management ではアラート アクション用の Webhook URL を POST できます。[Post to Webhook URL for Jira Service Management alerts (Jira Service Management アラート用の Webhook URL に POST)] セクションを使用してアラート アクションを特定の URL に POST します。たとえば、「アラートが作成されたときに URL に POST する」を追加します。これを行うには、「Jira Service Management でアラートが作成された場合」に「URL に POST する」のマッピングを定義します。
「アラートにタグが追加される」アクションと「アラートでカスタム アクションが実行される」アクションは、他のアクションと異なります。これらのアクションのいずれかを選択すると、このマッピングが機能するタグまたはカスタム アクションを入力するための追加のフィールドが表示されます。
タグをカンマで区切って、複数のタグを入力します。複数のタグを入力した場合、マッピングは、指定されたタグが 1 つ以上アラートにある場合に機能します。タグのフィールドを空のままにすると、どのタグでもマッピングが機能します。
1 つの Jira Service Management アクションが Webhook の統合で複数の「URL に POST する」アクションに関連付けられている場合、「アラートにタグが追加される」アクションと「アラートでカスタム アクションが実行される」アクションを除いて、エラーが発生します。マッピングは特定のタグとカスタム アクション名によって異なるため、これらのアクションに対してのみ複数のマッピングを保存できます。
さまざまなアクションの Webhook データの例については、「Jira Edge Connector アラート アクション データ」を参照してください。
この内容はお役に立ちましたか?