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

プラットフォームについて: Data Center および Cloud (状況に応じる) - この記事はアトラシアンの Data Center プラットフォーム 向けに記述されていますが、Atlassian Cloud のカスタマーも記事の内容を利用できる可能性があります。この記事で説明されている手順の実施が役立つと考えられる場合、 アトラシアンサポートに連絡する のうえ、この記事について言及してください。

Server* 製品のサポートは 2024 年 2 月 15 日に終了しました。Server 製品を実行している場合は、 アトラシアン Server サポート終了 のお知らせにアクセスして、移行オプションを確認してください。

*Fisheye および Crucible は除く

要約

このページは、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

  • カスタム フィールド

変換方法

$issue.key

{{issue.key}}

$customfields.get(10232)

{{issue.customfield_10232}} (または「customfield_10232」をカスタム フィールドの名前に置き換えられます)

$issue.summary

{{issue.summary}}

$project.name

{{issue.project.name}}

$reporter.displayName

{{issue.reporter.displayName}}

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

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

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

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

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

自動化を使用して課題にコメントする

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

更新日時: 2024年05月31日)

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。