Jira Service Management の管理者向けの利用開始ガイド
最初に、Jira Service Management の使用を開始する方法を確認します。
動的プロパティを使用する
この記事では、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」というテキストを含むメモが追加されます。文字列処理メソッドの詳細をご確認ください。
この内容はお役に立ちましたか?
さらにヘルプが必要ですか?
アトラシアン コミュニティをご利用ください。