スマート バリューとは
動的なプレースホルダーであるスマート値を使用すると、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 自動化で「変数を作成」アクションを使用して、独自のカスタム スマート値を定義できます。
スマート値のヘルプ パネルでは、スマート値、関数、メソッドをカスタマイズすることもできます。[カスタム フィールド] タブには、ルールを実行するプロジェクトやスコープに固有のカスタマイズされた値が表示されます。また、[詳細な書式設定] タブの関数やメソッドに独自のデータを入力して、出力を簡単にカスタマイズすることもできます。
スマート値の詳細については、Jira 自動化テンプレート ライブラリでスマート値の使用方法をご確認ください。
この内容はお役に立ちましたか?