robotsnoindex
robotsnoindex

スマート バリューを使用すると、Jira 内の課題データにアクセスして操作できます。ルールをさらに強力に、複雑なものにもできます。たとえば、{{now.plusDays(5)}} というスマート バリューは現在の日付から 5 日後を参照します。{{issue.summary}} というスマート バリューは課題の要約を印刷します。


スマート値を使って移行中の課題にコメントを追加したり、課題の報告者と担当者の名前を入力したりできます。

Hi {{reporter.displayName}}

We're now looking into your issue {{issue.summary}}.

We'll get back to you soon with an update.

{{assignee.displayName}}

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

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

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

スマート値を見つける

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

カスタム フィールドの値には、カスタム フィールド名を使用してアクセスできます (例: {{issue.Team Leader}} など)。フィールド名は大文字と小文字が区別され、ルール行為者の言語設定に基づき翻訳されます。課題フィールドへのアクセス方法の詳細をご覧ください

インスタンスが大幅にカスタマイズされている場合、REST API で適切なスマート バリューを検索する必要があります。フィールドに適したスマート バリューの検索に関する詳細をご覧ください


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

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

  1. 手動トリガーとログ アクションのアクションを併用するルールを作成します。 
  2. 課題に移動して、[ルールの実行] を選択して手動でルールをトリガーします。
  3. 結果は以下のように監査ログに表示されます。


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

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

以下の例を使用して、課題の要約を小文字に変更し、最初の 10 文字だけを使い、末尾に !! を追加します。

{{issue.summary.toLowerCase().substring(0, 10).concat("!!")}}

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

複数のアイテムがあるスマート バリューを操作する場合は、# とスマート バリューを組み合わせてルールをリストのすべてのアイテムに適用できます。たとえば、アクセスにスマート バリュー {{issue.comments}} を使って課題のコメントを返します。ただし、課題にコメントが複数ある場合は、スマート バリュー {{#issue.comments}} によって各コメントで個別にルールが反復されます。# を使う場合は式を {{/}} で囲む必要があります。

たとえば、コメント作成者の一覧を表示するには、以下を使用します。

{{#issue.comments}}Author: {{author.displayName}}{{/}}

項目を数字として扱うには {{#=}} を使用します {{#=}} (数学関数を 使用する場合)。たとえば、カスタム フィールドの [請求書額] に 100 を 追加する場合:

{{#=}}{{issue.Invoice Amount}} + 100{{/}}


デフォルト値

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

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

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

[変数の作成] 操作を使用して、独自のカスタム スマート バリューを定義できます。

詳細

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