スマート バリューとは
動的なプレースホルダーであるスマート値を使用すると、Atlassian Cloud 内のデータにアクセスして操作できます。自動化ルールをさらに強力かつ複雑なものにできます。スマート値によって返される出力は、すべてのユーザーで同じというわけではありません。自動化ルールが実行されている特定の作業項目、ページ、またはその他のコンテキストに基づいて変化します。
たとえば、スマート値 {{now.plusDays(5)}} は現在の時刻を見つけて 5 日を追加し、{{page.dateFirstPublished}} は特定の Confluence ページが最初に公開された日時を返します。
スマート バリューをフォーマットする
Smart values use mustache brackets to maximize security and reliability. To create a smart value, you need to wrap text in double curly brackets, such as {{value}}.
{{comment.author}} のコメント作成者などのプロパティを追加するには、ピリオドを使用します。
使用可能なスマート値の見つけ方
最も簡単な方法は、自動化コンポーネントで互換性のあるスマート値のリストを検索して選択することです。ルール ビルダーから:
「メールを送信」アクションなど、独自のテキストを入力するアクションを選択します。
テキスト フィールドの
{}ボタンを選択すると、互換性のあるスマート値リストが開きます。目的のスマート値が見つかったら、コピー アイコンを選択してテキスト フィールド貼り付けます。
You can also view lists of smart values available for automations in Jira and Confluence.
In Jira Automation, you can investigate the REST API to find available smart values for a work item. See how to find smart values for a Jira Cloud field.
スマート バリューをテストする
この機能は Jira 自動化でのみ利用できます。
スマート バリューが何を返すかテストする方法:
自動化のルールビルダーを開きます。
ルールのトリガーとして手動トリガーを選択します。
ルールのアクションとしてログ アクションを選択します。
作業項目に移動して [ルールを実行] を選び、手動でルールをトリガーします。
The result will be visible in the audit log.
スマート バリューの関数をチェーン化する
スマート関数を連結するだけで、1 つのステップで複数の変換を適用できます。
下の例では、スマート値 toLowerCase、substring、concat を連鎖させて作業項目の要約を小文字に変更し、最初の 10 文字だけを残して、文末に !! を追加します。
{{issue.summary.toLowerCase().substring(0, 10).concat("!!")}}セクションとリストでスマート値を使う
複数のアイテムがあるスマート値を操作する際は、# とスマート値を併用してルールをリストのすべてのアイテムに適用できます。
たとえば、スマート値 {{issue.comments}} を使用してアクセスし、作業項目のコメントを返します。ただし、作業項目にコメントが複数ある場合は、スマート値 {{#issue.comments}} によって各コメントで個別にルールが反復されます。# を使用する際は、式を {{/}} で閉じる必要があります。
たとえば、作業項目のコメント作成者の一覧を出力するには、以下を使用します。
{{#issue.comments}}Author: {{author.displayName}}{{/}}To treat items as numbers, use {{#=}} when using a math function. For example, to add 100 to an Invoice amount custom field:
{{#=}}{{issue.Invoice Amount}} + 100{{/}}デフォルト値
フィールドまたは値が存在しない場合は空の値 ({{invalid reference}}) を返します。これを避けるためにデフォルト値を指定できます。
たとえば、無効な参照に値が含まれていない場合、{{invalid reference|"Hello world"}} を使用して Hello world を表示できます。
スマート値をカスタマイズ
In Jira Automation, you can define your own custom smart values using the Create variable action.
スマート値のヘルプ パネルでは、スマート値、関数、メソッドをカスタマイズすることもできます。[カスタム フィールド] タブには、ルールを実行するスペースやスコープに固有のカスタマイズされた値が表示されます。また、[詳細な書式設定] タブの関数やメソッドに独自のデータを入力して、出力を簡単にカスタマイズすることもできます。
To see more about smart values, check out how we use them in our Jira automation template library.
この内容はお役に立ちましたか?