スマート バリュー - 構文とフォーマット
スマート値によって、Jira のほとんどすべての課題データにアクセスして操作できます。修得するまでにやや時間を要するかもしれませんが、ルールの活用法が大幅に増えるでしょう。
スマート バリューとは
スマート バリューは、データを動的に取り込むプレースホルダーのようなものです。次に例を示します。
- スマート バリュー
{{now.plusDays(5)}}
では、現在の時刻を参照してそれに 5 日間を追加します。 - スマート バリュー
{{issue.summary}}
では、課題の要約を出力します。
では、簡単な例を見てみましょう。トランジション中の課題にコメントを追加したり、課題の報告者と担当者の名前を入力したりするとします。コメントの適切な場所に適切なスマート値を挿入するだけで実行できます。
スマート バリューをフォーマットする
スマート バリューでは、Mustache ライブラリによって任意のコードを実行できないようにしています。置換するには、二重波かっこで値を囲む必要があります (例: {{somevalue}}
)。
Use a period to reference child elements, for example {{issue.key}}
.
課題フィールドへのアクセス
Use the field's name: {{issue.My custom field name}}
.
If the field is an object, reference the value within it. For example, if it is a user custom field, use:
{{issue.My user field.displayName}}
フィールド名は大小文字が区別されて、ルール アクターの言語設定で翻訳されます。スマート値の名前が翻訳されているカスタム フィールドにアクセスするには、ルール アクター ユーザー用に設定された言語を使用します。
同名のカスタム フィールドが複数ある、またはカスタム フィールドがシステム フィールドと同名の場合は、カスタム フィールド ID も使用できます。
{{issue.customfield_10001}}
詳細については「課題フィールドへのアクセス」をご参照ください。
セクションとリストに #
を使用する
複数のアイテムを反復する際は、#
を使用します。スマート値でキャプチャされるすべてについて同じことを実行します。#
を使用する際は、必ず {{/}}
で終わる必要があります。次の例では、アクションによってコメント作成者のリストが表示されます。
{{#issue.comments}}Author: {{author.displayName}}{{/}}
項目を数値として扱うには、数学関数を使用する際は {{#=}}
を使用します。たとえば、利用可能な課題の「請求金額」カスタム フィールドに 100 を追加するという簡単な計算を実行する場合は、次のようにします。
{{#=}}{{issue.Invoice Amount}} + 100{{/}}
既定値
If a field or value doesn't exist, it typically just returns an empty value: {{invalid reference}}
.
If you must have a value, you can specify a default value. For example, when an "invalid reference" doesn't contain a value, you can print "Hello world" using {{invalid reference|Hello world}}
.
利用可能なスマート バリューと例を確認する
ここでは、すべてのスマート バリューのリストを示して、それらの使用方法の例を紹介します。