スマート バリュー - 構文とフォーマット
スマート値によって、Jira のほとんどすべての課題データにアクセスして操作できます。修得するまでにやや時間を要するかもしれませんが、ルールの活用法が大幅に増えるでしょう。
スマート バリューとは
スマート バリューは、データを動的に取り込むプレースホルダーのようなものです。次に例を示します。
- スマート バリュー
{{now.plusDays(5)}}では、現在の時刻を参照してそれに 5 日間を追加します。 - スマート バリュー
{{issue.summary}}では、課題の要約を出力します。
では、簡単な例を見てみましょう。トランジション中の課題にコメントを追加したり、課題の報告者と担当者の名前を入力したりするとします。コメントの適切な場所に適切なスマート値を挿入するだけで実行できます。
| 例 | 出力 |
|---|---|
現在あなたの 近いうちに最新情報をお知らせします。
| John Doe さん 現在あなたのワークフローの作成に関する更新ドキュメンテーションを調べています。 近いうちに最新情報をお知らせします。 ジョン・スミス |
スマート バリューをフォーマットする
スマート バリューでは、Mustache ライブラリによって任意のコードを実行できないようにしています。置換するには、二重波かっこで値を囲む必要があります (例: {{somevalue}})。
ピリオドによって子要素を参照します (例: {{issue.key}})。
課題フィールドへのアクセス
{{issue.My custom field name}} というフィールド名を使用します。
フィールドがオブジェクトの場合は、その中の値を参照します。たとえば、ユーザー カスタム フィールドの場合は次のようにします。
{{issue.My user field.displayName}}フィールド名は大小文字が区別されて、ルール アクターの言語設定で翻訳されます。スマート値の名前が翻訳されているカスタム フィールドにアクセスするには、ルール アクター ユーザー用に設定された言語を使用します。
同名のカスタム フィールドが複数ある、またはカスタム フィールドがシステム フィールドと同名の場合は、カスタム フィールド ID も使用できます。
{{issue.customfield_10001}}詳細については「課題フィールドへのアクセス」をご参照ください。
セクションとリストに # を使用する
複数のアイテムを反復する際は、# を使用します。スマート値でキャプチャされるすべてについて同じことを実行します。# を使用する際は、必ず {{/}} で終わる必要があります。次の例では、アクションによってコメント作成者のリストが表示されます。
{{#issue.comments}}Author: {{author.displayName}}{{/}}項目を数値として扱うには、数学関数を使用する際は {{#=}} を使用します。たとえば、利用可能な課題の「請求金額」カスタム フィールドに 100 を追加するという簡単な計算を実行する場合は、次のようにします。
{{#=}}{{issue.Invoice Amount}} + 100{{/}}既定値
フィールドまたは値が存在しない場合、通常は空の値を返します ({{invalid reference}})。
値が必要な場合は、既定値を指定できます。たとえば「invalid reference」に値が含まれていない場合は、{{invalid reference|Hello world}} によって「Hello world」を表示できます。
利用可能なスマート バリューと例を確認する
ここでは、すべてのスマート バリューのリストを示して、それらの使用方法の例を紹介します。