問題
メールのテンプレートを変更したいのですが、方法がわかりません。
.解決方法
この記事は、ESET Endpoint Encryption (EEE) Server 2.5.0 以降にのみ適用されます。
EEEサーバーには、ユーザーに送信するメールを作成する際に使用するテンプレートが多数含まれています。これらの電子メールは、ユーザに新しいアクティベーションコードを提供したり、ワークステーションの FDE ステータスの変更を通知したりするなど、さまざまな理由が考えられます。
これらのテンプレートは、企業のアイデンティティに合わせて簡単に変更したり、新しいカスタム翻訳を追加したりすることができます。
テンプレートファイルとリソースは、EEE Serverインストールフォルダの下のTemplatesサブフォルダに格納されます。たとえば、C:¥Program Files¥EnterpriseConsole¥Templates です。
これらを直接編集することもできますが、将来EEE Serverをインストールしたときにこれらのファイルが上書きされる可能性があり、変更をやり直さなければならなくなるため、直接編集しないことをお勧めします。より良い解決策は、独自のファイルを追加して、カスタムテンプレート参照オブジェクトを変更することです。以下を参照してください。
画像を含める
テンプレートには、基本的なテキストファイルであるテキストコンポーネントと、グラフィックアセットを含む可能性のあるhtmlコンポーネントの両方があります。アセットはテンプレートと同じフォルダに配置し、テンプレート内で直接参照する必要があります。EEE サーバーがテンプレートを読み込んで解析すると、リンクされたアセットがインライン添付ファイルとしてメッセージに追加されます。既存のテンプレートを参照してください。
画像タグは1行で完結していることが重要です（例：
）。HTMLでは、タグを分割して「img」と「src」の間で改行することは有効ですが、EEEサーバーは1行のタグでなければ解析しません。
メールテンプレートのタグ
電子メールテンプレートは、複数のタグを使用できます。これらのタグを EEE サーバに追加すると、EEE サーバがメッセージを生成するときに適切なテキストに置き換えられます。以下のタグを使用できます：
汎用タグ
| タグ名 | 説明 |
| 管理者名 | EEE Server で定義されている管理者名。 |
| ユーザ名 | EEE Serverで定義されている、ユーザの名前。 |
| メッセージの作成日。 | メッセージが作成された日付 |
| メッセージの作成時刻。 | メッセージが作成された時刻 |
| メッセージの作成時刻。 | テンプレート参照オブジェクトで定義されたカスタム URL |
アクティベーション・タグ
| タグ名 | 説明 |
| アクティベーションコード | アクティベーション画面に入力するアクティベーション・コードのテキスト |
| アクティベーションURL | アクティベーションをクリックするためのアクティベーションコードのURL |
| ライセンスタイプ | ライセンスの種類 |
| ライセンス日付 | アクティベーションコードが生成された日時 |
FDEタグ
| タグ名 | 説明 |
| ワークステーション名 | ワークステーションの名前 |
| ワークステーションID | ワークステーションのワークステーションID |
| ログインタイプ | ログインのタイプ。NormalまたはSSO*1。 |
| fdeLoginUsername | FDE ログインユーザー名。 |
| ログインパスワード。 | FDE ログインパスワード。 |
| canChangePassword。 | ユーザーがパスワードを変更できるかできないかのブール値。 |
| 再起動回数 | 許可される再起動回数*2 |
| スタートモード | 選択したスタートモード（1～4）*1 |
*1 実際に追加されるテキストは、テンプレート参照オブジェクトで定義されます。EmailTemplates.jsonまたはEmailTemplatesCustom.jsonを参照してください。
*2 このタグは、デフォルトでは$startModeのテキスト内に出現します。この値は、単数または複数を示す可能性のある数値であるため、曖昧さを避けたり、"reboot(s) "のような用語を使用したりするために、正しい単数形または複数形が自動的に使用されるように、特別なタグを使用することができます。rebootcount|reboot|reboots}という形式を使用すると、$rebootCountの実際の値に応じて、"1 reboot "または "2 reboots "というテキストがメールに正しく含まれます。
カスタムテンプレート参照オブジェクトの編集
独自のテンプレートを使用できるようになったら、参照オブジェクトを編集して、EEE サーバが新しいテンプレートを読み込んで使用できるようにする必要があります。このファイルは、EEE Server の scripts フォルダにあります。例えば、C:¥Program Files¥EnterpriseConsole¥Scripts です。ファイル名は EmailTemplatesCustom.json とします。
このオブジェクトは、JSON言語によって定義されます。これにより、複雑なオブジェクトをテキスト・ファイルで簡単に定義できます。これは、簡単なテキストエディタを使って、手で簡単に編集することができます。
オブジェクトを編集したり、独自のカスタムオブジェクトを作成したい場合は、サポートに連絡してください。JSON記法に慣れていない場合、フォーマットがかなり複雑になる可能性があります。
しかし、大まかに言えば、このフォーマットには5つのルート・メッセージ・タイプが記述されている：
- testmessage；
- アクティベーション；
- initatefde；
- modifyfdelogin、そして
- addfdelogin。
これらは、以下のテンプレートに関連しています：
- EEE Server コントロールパネルからのテストメッセージ；
- アクティベーションコードメッセージ；
- ワークステーションでの FDE の起動；
- ユーザの FDE ログインを変更する。
- ユーザの FDE ログインの追加。
これらの各ノードの下には、言語別のサブノードがあります。en」言語はキャッチオールとして使用され、選択した言語が見つからない場合などにデフォルトとして使用されます。したがって、"en "バージョンは常に存在しなければならない（MUST）。言語は、標準の ISO 639-1 2 文字コード（オプションのバリアントコード付き）を使用して指定できます。たとえば、EEEサーバーはコード「en」を「English」と解釈します。また、コード "en-GB" と "en-US" を使用して、英国英語と米国英語に異なるテンプレートを提供することもできます。
現在、EEE サーバで提供されているデフォルトの翻訳は、以下のとおりです：
- en - 英語
- de-DE - ドイツ語
- es-ES - スペイン語
- fr-FR - フランス語
- ja-JP - 日本語
- nl-NL - オランダ語
- pl-PL - ポーランド語
さらに、アクティベーションメッセージは、異なるライセンスグループ用に別々のテンプレートを定義することができます。現在のところ、これらは 1 - Windows または 2 - Mobile (iOS) ライセンスに関連しています。
各言語ノード内で、htmlとプレーンテキストのテンプレートファイル名、メッセージの件名、必要なフレーズを定義できます。
メッセージへのURLの追加
配列の各要素は、$messageURL1、$messageURL2 などのタグに関連付けられます。messageURL 配列で指定する各オブジェクトは、リンクテキスト、 実際の URL (href)、alt テキスト、そしてターゲットを指定することができます。href は必須で、それ以外は省略可能です。
プレーンテキストのメッセージでは、href 属性と text 属性のみが使用されます。textが指定された場合は、hrefの前に追加され、hrefはparenthasisで囲まれます。
例えば、次のようなJSONを考えてみましょう。
"messageURL"：[
{
"href"："http://www.eset.com/"、
"text"："EEEウェブサイト"
},
{
"href"："https://support.eset.com/"
}
]
タグ$messageURL1は "EEE Website (http://www.eset.com/) "に展開され、$messageURL2は単に "https://support.eset.com "になります。
HTMLテンプレートにのみ適用されるテキストを指定したい場合は、texthtml 要素を使用します。これは、text タグに html や画像を含める場合に便利です。
カスタムテンプレートの追加
独自のカスタムテンプレートを実装する場合は、EmailTemplatesCustom.jsonにのみ記述します。EmailTemplates.json を編集すると、このファイルは EEE Server のアップグレードによって上書きされます。lint を使用して、JSON が有効であることを確認してください。ファイルが有効でない場合は、EEE Serverによって無視されます。
有用な JSON lint サイトは、https://jsonlint.com/です。
サポートされるバージョン
EEE Server 2.5.0 以降のみ
