スマート バリュー - 構文とフォーマット

スマート値によって、Jira のほとんどすべての課題データにアクセスして操作できます。修得するまでにやや時間を要するかもしれませんが、ルールの活用法が大幅に増えるでしょう。

スマート バリューとは

スマート バリューは、データを動的に取り込むプレースホルダーのようなものです。次に例を示します。

  • スマート バリュー {{now.plusDays(5)}} では、現在の時刻を参照してそれに 5 日間を追加します。
  • スマート バリュー {{issue.summary}} では、課題の要約を出力します。

では、簡単な例を見てみましょう。トランジション中の課題にコメントを追加したり、課題の報告者と担当者の名前を入力したりするとします。コメントの適切な場所に適切なスマート値を挿入するだけで実行できます。

スマート バリューをフォーマットする

スマート バリューでは、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」を表示できます。

利用可能なスマート バリューと例を確認する

ここでは、すべてのスマート バリューのリストを示して、それらの使用方法の例を紹介します。

Last modified on Mar 10, 2023

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

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.