• 製品
  • 使用を開始する
  • 関連ドキュメント
  • リソース

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

この記事では、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 本文にある次の値にアクセスすることもできます。

1 2 3 4 5 6 7 { "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」というテキストを含むメモが追加されます。文字列処理メソッドの詳細をご確認ください

 

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

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