スマート バリューとは
動的なプレースホルダーであるスマート値を使用すると、Atlassian Cloud 内のデータにアクセスして操作できます。自動化ルールをさらに強力かつ複雑なものにできます。スマート値によって返される出力は、すべてのユーザーで同じというわけではありません。自動化ルールが実行されている特定の作業項目、ページ、またはその他のコンテキストに基づいて変化します。
たとえば、スマート値 {{now.plusDays(5)}} は現在の時刻を見つけて 5 日を追加し、{{page.created}} は特定の Confluence ページが作成された日時を返します。
スマート バリューをフォーマットする
スマート値は、Mustache ライブラリを使用してセキュリティと信頼性を最大限に高めます。スマート値を作成するには、{{value}} のようにテキストを二重中括弧で囲む必要があります。
ピリオドを使用して、子要素を参照します (例: {{comment.author}})。
使用可能なスマート値の見つけ方
ルールビルダーにあるスマート値のヘルプ パネルにアクセスすると、使用可能なスマート値のリストをご確認いただけます。
スマート値を追加する必要がある既存のルールをルールビルダーで開くか、新しいルールの作成を開始します。
「メールを送信」アクションなど、独自のテキストを入力できるアクションを選択します。
スマート値を追加する必要があるテキスト フィールドの
{}ボタンを選択します。これにより、ヘルプ パネルが開きます。これで、使用できるスマート値のリストをブラウズして、テキスト フィールドに値を貼り付けできるようになりました。
使用可能なスマート値のリストは、サポート ドキュメントにもあります。
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 自動化で「変数を作成」アクションを使用して、独自のカスタム スマート値を定義できます。
You can also customise smart values, functions and methods in the smart values help panel. Under the Custom fields tab, you can find customised values that are specific to the spaces or scope your rule will be running in. You can also input your own data into the functions and methods under the Advanced formatting tab, which allows you to easily customise their output.
スマート値の詳細については、Jira 自動化テンプレート ライブラリでスマート値の使用方法をご確認ください。
この内容はお役に立ちましたか?