メールコンテンツのカスタマイズ

このページは Jira Data Center 用です

Jira Server を使用している場合は、ここで説明した方法とは異なる方法でテンプレートを取得する必要があります。Jira Server でメール コンテンツをカスタマイズする方法をご確認ください。

Jira には、さまざまなインタラクションに使用できる既定のテンプレートが幅広く用意されています。ヘッダーやフッダーへの情報の追加やメールのコンテンツの入れ替えなどのために、多数のカスタマイズを行い、要件に応じてメールを調整できます。さまざまな通知タイプについてご確認ください。

Jira でのメール テンプレートの設定方法

Jira は、Apache の ベロシティと呼ばれるテンプレート エンジンを使用して、イベントに応答するメールを生成します。これは、Java オブジェクトを多くの方法で分離できるテンプレート言語です。

Jira 開発者向けドキュメントに記載されているベロシティ テンプレートの詳細をご確認ください。

ベロシティ テンプレートやその他の Jira ファイルのカスタマイズは、アトラシアン サポートの範囲には含まれません「アトラシアン サポートの提供について」をご確認ください。 

メール テンプレートの表示

次のすべての手順を行うには、Jira システム管理者グローバル権限を持つユーザーとしてログインする必要があります。

Jira のメール テンプレートを表示してカスタマイズするには、次の手順を実行します。

  1. 画面右上で、[管理 ] > [システム] の順に選択します。 

  2. [メール] の下の [メール テンプレート] を選択します

  1. .zip 形式でダウンロード: 使用可能なすべてのテンプレートを含む ZIP アーカイブをダウンロードし、ローカルで編集します。
  2. アップロード: 編集が完了したら、アーカイブを Jira に再度アップロードします。.zip ファイル構造は元のアーカイブと同じである必要があります。必要なファイル構造をご確認ください。
  3. 既定に戻す: アップロードしたテンプレートに問題がある場合、既定のテンプレートに戻します。Jira は、既定のテンプレートをそのリソースから Jira 共有ホーム ディレクトリにコピーします。

メール テンプレートの編集

メール テンプレートを編集すると、メール通知の外観を変更できます。これは、会社のブランディングを追加したり、コンテンツを再編成したりする場合に便利です。

テンプレートを編集する時は、Velocity テンプレート言語を使用するので、それに関する知識が欠かせません。

次のガイドを使用して、Jira のさまざまなメール テンプレートとそのカスタマイズについてご確認ください。

テンプレートのアップロード

テンプレートを ZIP アーカイブにアーカイブし、Jira に再度アップロードする必要があります。 

必要なファイル構造

テンプレートを編集する際、Jira がファイル構造を検証するため、ファイル名やフォルダ内の場所を変更しないでください。グラフィックなどのファイルをアーカイブに追加し、テンプレートからリンクすることができます。

Jira は、必要なテンプレートが存在する場合にのみチェックします。テンプレートの構文やエラーは検証されません。

次のファイル構造が認められます。または、テンプレート フォルダを省略することもできます。

- templates
    - email
    - email-batch

変更の適用

テンプレートをアップロードしても、すぐには適用されません。Jira は最初にファイル構造を検証し、すべて正しいと判断した場合、変更を適用するように依頼します。いったんこの操作を行うと、新しいテンプレートは <Jira-shared-home>/data/templates/data/templates に移動され、そこに存在するファイルは上書きされます。

テンプレートを既定に戻す

変更したテンプレートで何かが正しくない場合、[既定に戻す] をクリックして既定のテンプレートに戻すことができます。この操作を実行すると、次のような結果になります。

  1. Jira は、既定のテンプレートをそのリソースから Jira 共有ホーム ディレクトリにコピーします。

  2. 既定のテンプレートは <Jira-shared-home>/data/templates の中にある既存のテンプレートをすべて上書きします。

  3. Jira はテンプレート キャッシュをクリアし、既定のテンプレートがすぐに適用されます。

考慮事項

以下に、きっとお役に立つその他の情報を紹介します。

テンプレート: 既定のテンプレートと現在のテンプレートの比較

現在のテンプレート

現在のテンプレートとは、Jira がメール通知に使用するテンプレートです。これらは Jira 共有ホーム ディレクトリに保存され、新しい ZIP アーカイブをアップロードして変更を適用するたびに更新されます。

  • 個別の課題通知とその他のイベント: <Jira-shared-home>/data/templates/email

  • バッチ処理された課題通知: <Jira-shared-home>/data/templates/email-batch

既定のテンプレート

tip/resting Created with Sketch.

既定のテンプレートが動作する仕組みが上記のように定められているので、Jira が常に元に戻せるまたはフォールバックできるものが存在するように、このテンプレートは変更しないようにしてください。

既定のテンプレートとは、Jira リソースのインストール ディレクトリ (個別の課題通知およびその他のイベント) またはアプリ (バッチ処理された課題通知) のいずれかに保存されるバックアップ テンプレートのことです。

これらのテンプレートはバックアップとして機能し、次の場合にのみ使用されます。

  • ファイルが見つからない: Jira 共有ホーム ディレクトリにいずれかのテンプレートがありません。そのようなテンプレートのために、Jira は既定のテンプレートにフォールバックします。

  • 既定に戻す: 自らの選択でテンプレートを既定に戻します。既定のテンプレートが共有ホーム ディレクトリにコピーされ、現在のテンプレートが上書きされます。

アップグレード時に変更を保持

メール テンプレートは Jira 共有ホーム ディレクトリに保存されるため、変更内容はアップグレード時にも保持されます。また、テンプレートを編集した後に Jira を再起動する必要はありません。

メール テンプレートをキャッシュする

Jira 共有ホーム ディレクトリ内のすべてのテンプレートがキャッシュされます。これにより、共有ディレクトリにアクセスできない場合でも、Jira はこれらのテンプレートを使用できます。

見つからないファイルに関する情報はキャッシュされません。いずれかのテンプレートが共有ディレクトリに存在しない場合、Jira はそのファイルを毎回読み込もうとし、既定のテンプレートにフォールバックします。

最終更新日: 2023 年 10 月 12 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.