スマート バリューとは

スマート値を使用すると、Atlassian Cloud 内の課題データにアクセスして操作できます。ルールをさらに強力に、複雑なものにもできます。次に例を示します。

• {{now.plusDays(5)}} というスマート値は現在の日付を参照し、それに 5 日間を追加します。

• {{issue.summary}} は、課題の要約を出力します

• {{page.created}} は、Confluence ページが作成された日付と時刻を出力します

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

スマート バリューでは Mustache ライブラリを使用して、任意のコードを実行できないようにしています。置換するには、二重波かっこで値を囲む必要があります。例: {{value}}.

ピリオドを使用して、子要素を参照します。例: {{issue.key}}。

スマート値を見つける

大半のケースでは、次の参照ドキュメントからスマート バリューを選択できます。

• Jira Cloud のスマート値に関する詳細をご確認ください。

• Confluence Cloud のスマート値に関する詳細をご確認ください。

Jira Cloud 自動化では、REST API を調べて、課題のすべてのスマート値を見つけられます。Jira Cloud フィールドのスマート値を見つける方法の詳細をご確認ください。

スマート バリューをテストする

スマート バリューが何を返すかテストする方法:

1. 次のセットアップでルールを作成します。

   • トリガー: 手動 

   • アクション: ログ 

2. 課題に移動して [ルールを実行] を選び、手動でルールをトリガーします。

3. 結果は監査ログに表示されます。

スマート バリューの関数をチェーン化する

スマート関数を連結することで、1 つのステップで複数の変換を適用できます。

下の例では、スマート値 toLowerCase、substring、concat を連鎖させて課題の要約を小文字に変更し、最初の 10 文字だけを残して、文末に !! を追加します。

セクションとリストでスマート値を使う

複数のアイテムがあるスマート値を操作する際は、# とスマート値を併用してルールをリストのすべてのアイテムに適用できます。

たとえば、スマート値 {{issue.comments}} でアクセスして、Jira 課題のコメントを返します。ただし、課題にコメントが複数ある場合は、スマート値 {{#issue.comments}} によって各コメントで個別にルールが反復されます。# を使用する際は、式を {{/}} で閉じる必要があります。

たとえば、Jira 課題のコメント作成者の一覧を出力するには、以下を使用します。

アイテムを数値として扱うには、数学関数を使用する際に {{#=}} を使用します。たとえば [Invoice amount] カスタム フィールドに 100 を追加するには、次のようにします。

デフォルト値

フィールドまたは値が存在しない場合は空の値 ({{invalid reference}}) を返します。これを避けるためにデフォルト値を指定できます。

たとえば、無効な参照に値が含まれていない場合、{{invalid reference|"Hello world"}} を使用して Hello world を表示できます。

独自のスマート バリューを作成する

Jira Cloud で「変数を作成」アクションを使用して、独自のカスタム スマート値を定義できます。

詳細

Jira Automation テンプレート ライブラリでスマート バリューを使用する方法をご確認ください。