動的プロパティを使用する

この記事では、Jira Service Management Cloud の一部のお客様に段階的に展開されている、Jira Service Management でネイティブに利用できる新しいアラート機能を取り上げています。ご利用のサイトにはまだ表示されていないか、利用できない可能性があります。

Jira Service Management はデータを解析して、豊富で有益なアラートを作成します。ユーザーは動的プロパティを使用して、アラートとアラート条件をカスタマイズできます。

動的 (ドラッグ可能) プロパティ

ドラッグ可能なプロパティは、十分な情報に基づくアラートを作成して管理するための重要なデータを提供します。統合フレームワークは、統合アプリ固有のさまざまな動的プロパティを提供します。動的プロパティは、アラートフィールドだけでなく、統合アクションのフィルターにも使用できます。フィルターでは、条件のドロップダウンで動的プロパティを選択できます。アラートのプロパティでは、動的プロパティを適切なアラートフィールドにドラッグできます。

Jira Service Management では、二重の中括弧で囲まれた式が動的プロパティとして解釈されます。動的データは、Jira Service Management に送信されるすべての通知に入力されます。たとえば、誰かが Jira で課題を作成し、要約として「This is the summary」と入力したとします。Jira Service Management の Jira 統合を使用すると、「アラートの作成」アクションでメッセージの「[Jira] {summary}」によって「[Jira] This is the summary」というメッセージを含むアラートが作成され、ユーザーに通知されます。ここで必要なのは、{summary} をメッセージにドラッグすることだけです。課題が作成されると、Jira Service Management に自動で通知が届き、課題の要約を示すメッセージを含むアラートが作成されます。

静的テキストと動的プロパティは混在可能です。上記の例では、「[Jira] {summary}」の「[Jira]」は静的であり、新しいアラートが作成されるたびにメッセージの先頭に表示されます。「{summary}」はアラートごとに異なる可能性があります。

Webhook URL、ペイロード、ヘッダーの生のパラメーターを使用する

Webhook から URL パラメーターまたは http ペイロードパラメーターをアラートに直接挿入できます。たとえば、統合アプリの Webhook ペイロードで timestamp という名前の変数を Jira Service Management に送信するとします。しかし、設定ページでは timestamp をドラッグ可能なプロパティとして利用できません。それでも timestamp をアラートに使用する必要がある場合は、入力フィールドに {{_payload.timestamp}} を追加します。

ネストされたペイロード変数にもアクセスできます。次の例のように、_payload.issue.fields.environment を使用して Webhook の http 本文にある次の値にアクセスすることもできます。

{
    "issue" : {
        "fields" : {
            "environment" : "env_val"
        }
    }
}

Webhook の URL クエリパラメーターには、{{_url.param}} を介してアクセスできます (param はパラメーターキーです)。カスタムパラメーターを Webhook URL に追加して、アラートに挿入できます。たとえば、Jira Service Management の Stackdriver 統合を使用しているとします。多くのプロジェクトを監視しており、すべてのアラートに対して 1 つの統合を使用する必要があります。それでもどのアラートがどのドメインに属しているかを区別する必要がある場合は、プロジェクトごとにカスタムパラメーターを使用できます。

Stackdriver 統合の Webhook URL にカスタムパラメーター (¶m1=val1 など) を追加し、統合設定で {{_url.param1}} を挿入してこれにアクセスできます。{{_headers.param}} を介して Webhook リクエストのヘッダーを入手することもできます (param はヘッダーの名前です)。アラートフィールドでは、リクエストのすべてのヘッダーを使用できます。

メールベースの統合では、アラートフィールドで {_headers.PARAM1} と {_headers.IMPORTANCE} の表記を介してメールのヘッダーを使用できます。キーには大文字を使用してください。

アラートフィールドをさらに制御するために、動的プロパティで文字列処理メソッドを使用できます。たとえば、統合に「メモの追加」アクションがあり、メモが「note: {comment_body.substringAfter("is")}」として設定されているとします。

統合アプリで誰かが課題へのコメントとして「This is the comment」を追加すると、対応するアラートに「note: the comment」というテキストを含むメモが追加されます。文字列処理メソッドの詳細をご確認ください。

この内容はお役に立ちましたか?

正確ではなかった

明確ではなかった

関係なかった

さらにヘルプが必要ですか?

アトラシアンコミュニティをご利用ください。

コミュニティに質問