従来のレンダリングを変換する

要約

このページは、Atlassian Labs の旧式「Jira Automation」アドオンから「Automation for Jira」にアップグレードした場合にのみ関係します。新規ユーザーでこれまでに一度もアップグレードしたことがない場合は、このドキュメントは確認不要です。

異なるバージョンの詳細については「Lite と Pro の比較」をご参照ください。

旧式の「Jira Automation」アドオンは、自動化ルールで「コメント」アクションまたは「課題を編集」アクションを使用する際に、Velocity によって課題の値をレンダリングしていました。たとえば、次のようにコメントを書いたとします。

• The issue $issue.key was just updated.

次のようにレンダリングされます。

• The issue TEST-1234 was just updated.

「Automation for Jira」アドオンは、Mustache によって課題の値をレンダリングします。Mustache は、主にシンプルさとセキュリティのために選ばれました。Velocity は Jira 内部へのアクセスをはるかに多く許可しますが、安全でないコード実行につながる可能性があります。

ただし、アップグレードをできるだけ簡単にするためにレガシーの Velocity レンダリングが「Automation for Jira」に導入されているため、アップグレード後も既存のルールを引き続き使用できます。唯一の制限として、セキュリティ上の理由から、これらのルールをプロジェクト固有のルールに変換できません。また、利用できる機能が少なくなっています (できるだけ早く Mustache にアップグレードしてください)。

ソリューション

レガシー値の変換

このレンダリング メカニズムを使用するのは、[コメント] と [課題を編集] の各アクションだけです ([課題を編集] は [Allow variable expansion (変数の展開を許可)] がオンになっている場合のみ)。新しい Automation for Jira にアップグレードすると、レガシーのレンダリングを使用するコンポーネントが検出されて、アップグレード後にこれらのコンポーネントに次の警告が表示されます。

このコメントは Velocity によってレンダリングされます。[スマート値のレンダリングを有効化] をクリックすると、このコメント アクションが Mustache レンダリングに切り替わります。この操作は元に戻せません。

Velocity レンダラーは、次のコンテキスト オブジェクトを提供します。

• 課題

• reporter

• project

• カスタム フィールド

変換方法

詳しい例については、スマート値のドキュメントをご参照ください。

上のスクリーンショットに示したコメントの例は、次のとおりです。

1. 「Hello $issue.key」を「Hello {{issue.key}}」に変換します。

2. 次に、[スマート値のレンダリングを有効化] ボタンを押します。

これで終了です。コメント アクションは次のようになります。

アップグレードすると、Velocity を使用する新しいアクションを作成できなくなります。Velocity はもう利用できません。今後は Mustache とスマート値をご活用ください。