スマート バリューとは
動的なプレースホルダーであるスマート値を使用すると、Atlassian Cloud 内のデータにアクセスして操作できます。自動化ルールをさらに強力かつ複雑なものにできます。スマート値によって返される出力は、すべてのユーザーで同じというわけではありません。自動化ルールが実行されている特定の作業項目、ページ、またはその他のコンテキストに基づいて変化します。
For example, the smart value {{now.plusDays(5)}} finds the current time and adds 5 days to it, and {{page.dateFirstPublished}} returns the date that a specific Confluence page was originally published.
スマート バリューをフォーマットする
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}}.
Use a period to add properties like the author of a comment in {{comment.author}}.
使用可能なスマート値の見つけ方
The easiest way is to search and select a list of compatible smart values in an automation component. From the rule builder:
Select an action that requires you to input your own text, such as the Send email action.
Select the
{}button in the text field to open a list of compatible smart values.When you find the smart value you want, select the copy icon and paste it into the text field.
You can also view lists of smart values available for automations in Jira and Confluence.
Jira 自動化では、REST API を調べて、作業項目に使用できるスマート値を見つけることができます。Jira Cloud フィールドのスマート値を見つける方法をご確認ください。
スマート バリューをテストする
この機能は Jira 自動化でのみ利用できます。
スマート バリューが何を返すかテストする方法:
自動化のルールビルダーを開きます。
ルールのトリガーとして手動トリガーを選択します。
ルールのアクションとしてログ アクションを選択します。
作業項目に移動して [ルールを実行] を選び、手動でルールをトリガーします。
結果は監査ログに表示されます。
スマート バリューの関数をチェーン化する
スマート関数を連結するだけで、1 つのステップで複数の変換を適用できます。
下の例では、スマート値 toLowerCase、substring、concat を連鎖させて作業項目の要約を小文字に変更し、最初の 10 文字だけを残して、文末に !! を追加します。
{{issue.summary.toLowerCase().substring(0, 10).concat("!!")}}セクションとリストでスマート値を使う
複数のアイテムがあるスマート値を操作する際は、# とスマート値を併用してルールをリストのすべてのアイテムに適用できます。
たとえば、スマート値 {{issue.comments}} を使用してアクセスし、作業項目のコメントを返します。ただし、作業項目にコメントが複数ある場合は、スマート値 {{#issue.comments}} によって各コメントで個別にルールが反復されます。# を使用する際は、式を {{/}} で閉じる必要があります。
たとえば、作業項目のコメント作成者の一覧を出力するには、以下を使用します。
{{#issue.comments}}Author: {{author.displayName}}{{/}}アイテムを数値として扱うには、数学関数を使用する際に {{#=}} を使用します。たとえば [Invoice amount] カスタム フィールドに 100 を追加するには、次のようにします。
{{#=}}{{issue.Invoice Amount}} + 100{{/}}デフォルト値
フィールドまたは値が存在しない場合は空の値 ({{invalid reference}}) を返します。これを避けるためにデフォルト値を指定できます。
たとえば、無効な参照に値が含まれていない場合、{{invalid reference|"Hello world"}} を使用して Hello world を表示できます。
スマート値をカスタマイズ
Jira 自動化で「変数を作成」アクションを使用して、独自のカスタム スマート値を定義できます。
スマート値のヘルプ パネルでは、スマート値、関数、メソッドをカスタマイズすることもできます。[カスタム フィールド] タブには、ルールを実行するスペースやスコープに固有のカスタマイズされた値が表示されます。また、[詳細な書式設定] タブの関数やメソッドに独自のデータを入力して、出力を簡単にカスタマイズすることもできます。
スマート値の詳細については、Jira 自動化テンプレート ライブラリでスマート値の使用方法をご確認ください。
この内容はお役に立ちましたか?