電子メール通知の設定

AEM は、次のようなユーザーに電子メール通知を送信します。

• 変更やレプリケーションなど、ページイベントを購読したことがある。通知インボックスでは、このようなイベントを購読する方法について説明します。

• フォーラムイベントを購読したことがある

• ワークフローで手順を実行する必要がある。参加者ステップでは、ワークフローで電子メール通知を実行する方法について説明します。

前提条件：

• ユーザーのプロファイルで有効な電子メールアドレスが定義されている必要があります。
• この Day CQ Mail Service を適切に設定する必要があります。

ユーザーへの通知は、各自がプロファイルで定義している言語の電子メールで送信されます。言語ごとに、独自のカスタマイズ可能なテンプレートがあります。新しい言語用には新しい電子メールテンプレートを追加できます。

メールサービスの設定

AEM で電子メールを送信できるようにするために、Day CQ Mail Service を適切に設定する必要があります。設定は、Web コンソールで表示できます。AEM を操作しているときは、このようなサービスの設定を管理する方法がいくつかあります。詳細および推奨事項については、OSGi の設定を参照してください。

以下の制約が適用されます。

• SMTP サーバーポート​は 25 以上にする必要があります。

• この SMTP サーバーのホスト名 は空にできません。

• 「送信元」アドレス​は空白にしてはなりません。

Day CQ Mail Service の問題をデバッグしやすくするために、サービスのログを監視できます。

com.day.cq.mailer.DefaultMailService

設定は、Web コンソールに次のように表示されます。

電子メール通知チャネルの設定

ページまたはフォーラムのイベント通知を購読するとき、送信元の電子メールアドレスは、デフォルトで no-reply@acme.com に設定されます。この値は、Web コンソールで Notification Email Channel サービスを設定することで変更できます。

送信元電子メールアドレスを設定するには、 sling:OsgiConfig ノードをリポジトリに追加します。 以下の手順を実行し、ノードを使用してCRXDE Liteを直接追加します。

1. CRXDE Lite で、config という名前のノードを、アプリケーションフォルダーの下に追加します。

2. config フォルダーに、という名前のノードを追加します。

   com.day.cq.wcm.notification.email.impl.EmailChannelリソースのタイプは次のとおりとします。sling:OsgiConfig

3. を追加します。 String プロパティを email.from. 値には、使用する電子メールアドレスを指定します。

4. 「すべて保存」をクリックします。

次の手順を使用して、コンテンツパッケージソースフォルダーでノードを定義します。

1. を jcr_root/apps/*app_name*/config folder、という名前のファイルを作成します。 com.day.cq.wcm.notification.email.impl.EmailChannel.xml

2. このノードを表現する次の XML を追加します。

   <?xml version="1.0" encoding="UTF-8"?> <jcr:root xmlns:sling="https://sling.apache.org/jcr/sling/1.0" xmlns:jcr="https://www.jcp.org/jcr/1.0" jcr:primaryType="sling:OsgiConfig" email.from="name@server.com"/>

3. email.from 属性の値（name@server.com）を、実際の電子メールアドレスに置き換えます。

4. ファイルを保存します。

ワークフロー電子メール通知サービスの設定

ワークフロー電子メール通知を受信したとき、送信元電子メールアドレスとホスト URL プレフィックスはいずれもデフォルトに設定されています。これらの値は、Web コンソールで Day CQ Workflow Email Notification Service を設定することによって変更できます。その場合は、変更をリポジトリに保持することをお勧めします。

デフォルト設定は、Web コンソールに次のように表示されます。

ページ通知用の電子メールテンプレート

ページ通知用の電子メールテンプレートは次の場所にあります。

/libs/settings/notification-templates/com.day.cq.wcm.core.page

デフォルトの英語のテンプレート（en.txt）は次のように定義されています。

subject=[CQ Page Event Notification]: Page Event

header=-------------------------------------------------------------------------------------\n \
Time: ${time}\n \
User: ${userFullName} (${userId})\n \
-------------------------------------------------------------------------------------\n\n

message=The following pages were affected by the event: \n \
 \n \
${modifications} \n \
 \n\n
footer=\n \
-------------------------------------------------------------------------------------\n \
This is an automatically generated message. Please do not reply.

ページ通知用の電子メールテンプレートのカスタマイズ

ページ通知用の英語の電子メールテンプレートをカスタマイズするには：

1. CRXDE で、次のファイルを開きます。

   /libs/settings/notification-templates/com.day.cq.wcm.core.page/en.txt

2. ニーズに合わせてファイルを変更します。

3. 変更内容を保存します。

テンプレートには以下の書式が必要です。

 subject=<text_1>
 header=<text_2>
 message=<text_3>
 footer=<text_4>

<text_x> には、静的テキストと動的文字列変数を混在させることができます。ページ通知用の電子メールテンプレート内では次の変数を使用できます。

• ${time}、イベントの日時。

• ${userFullName}：イベントをトリガーしたユーザーの完全名。

• ${userId}：イベントをトリガーしたユーザーの ID。

• ${modifications}は、ページイベントのタイプとページパスを次の形式で表します。

  <page event="" type=""> => <page path="">

  次に例を示します。

  PageModified => /content/geometrixx/en/products

フォーラム通知用の電子メールテンプレート

フォーラム通知用の電子メールテンプレートは次の場所にあります。

/etc/notification/email/default/com.day.cq.collab.forum

デフォルトの英語のテンプレート（en.txt）は次のように定義されています。

subject=[CQ Forum Notification]

header=-------------------------------------------------------------------------------------\n \
Time: Time: ${time}\n \
Forum Page Path: ${forum.path}\n \
-------------------------------------------------------------------------------------\n\n

message=Page: ${host.prefix}${forum.path}.html\n

footer=\n \
-------------------------------------------------------------------------------------\n \
This is an automatically generated message. Please do not reply.

フォーラム通知用の電子メールテンプレートのカスタマイズ

フォーラム通知用の英語の電子メールテンプレートをカスタマイズするには：

1. CRXDE で、次のファイルを開きます。

   /etc/notification/email/default/com.day.cq.collab.forum/en.txt

2. ニーズに合わせてファイルを変更します。

3. 変更内容を保存します。

テンプレートには以下の書式が必要です。

 subject=<text_1>
 header=<text_2>
 message=<text_3>
 footer=<text_4>

ここで、 <text_x> は、静的テキストと動的文字列変数を組み合わせることができます。

フォーラム通知用の電子メールテンプレート内では次の変数を使用できます。

• ${time}、イベントの日時。

• ${forum.path}：フォーラムページへのパス。

ワークフロー通知用の電子メールテンプレート

ワークフロー通知用の電子メールテンプレート（英語）は次の場所にあります。

/libs/settings/workflow/notification/email/default/en.txt

次のように定義されています。

subject=Workflow notification: ${event.EventType}

header=-------------------------------------------------------------------------------------\n \
Time: ${event.TimeStamp}\n \
Step: ${item.node.title}\n \
User: ${participant.name} (${participant.id})\n \
Workflow: ${model.title}\n \
-------------------------------------------------------------------------------------\n\n

message=Content: ${host.prefix}${payload.path.open}\n

footer=\n \
-------------------------------------------------------------------------------------\n \
View the overview in your ${host.prefix}/aem/inbox\n \
-------------------------------------------------------------------------------------\n \
This is an automatically generated message. Please do not reply.

ワークフロー通知用の電子メールテンプレートのカスタマイズ

ワークフローイベント通知用の英語の電子メールテンプレートをカスタマイズするには：

1. CRXDE で、次のファイルを開きます。

   /libs/settings/workflow/notification/email/default/en.txt

2. ニーズに合わせてファイルを変更します。

3. 変更内容を保存します。

テンプレートには以下の書式が必要です。

subject=<text_1>
 header=<text_2>
 message=<text_3>
 footer=<text_4>

メソッド ${payload.path.open} 作業項目のペイロードへのパスを表示します。 例えば、サイトのページの場合は、 payload.path.open 次に似ています： /bin/wcmcommand?cmd=open&path=….;サーバー名が付いていないので、テンプレートの前にはが付きます。 ${host.prefix}.

電子メールテンプレート内では以下の変数を使用できます。

• ${event.EventType}、イベントのタイプ

• ${event.TimeStamp}、イベントの日時

• ${event.User}：イベントをトリガーしたユーザー

• ${initiator.home}、イニシエータノードのパス

• ${initiator.name}、イニシエーター名

• ${initiator.email}（イニシエーターの E メールアドレス）

• ${item.id}（作業項目の id）

• ${item.node.id}（この作業項目に関連付けられたワークフローモデル内のノードの id）

• ${item.node.title}、作業項目のタイトル

• ${participant.email}、参加者のメールアドレス

• ${participant.name}、参加者の名前

• ${participant.familyName}（参加者の姓）

• ${participant.id}（参加者の id）

• ${participant.language}、参加者の言語

• ${instance.id}、ワークフロー ID

• ${instance.state}、ワークフローの状態

• ${model.title}、ワークフローモデルのタイトル

• ${model.id}（ワークフローモデルの id）

• ${model.version}（ワークフローモデルのバージョン）

• ${payload.data}、ペイロード

• ${payload.type}、ペイロードタイプ

• ${payload.path}、ペイロードのパス

• ${host.prefix}、ホストプレフィックス、例：http://localhost:4502

新しい言語用の電子メールテンプレートの追加

新しい言語用のテンプレートを追加するには：

1. CRXDE で、ファイルを追加します。 <language-code>.txt 以下：

   • /libs/settings/notification-templates/com.day.cq.wcm.core.page :（ページ通知）
   • /etc/notification/email/default/com.day.cq.collab.forum :フォーラム通知
   • /libs/settings/workflow/notification/email/default :ワークフロー通知の場合

2. 言語に合わせてファイルを調整します。

3. 変更内容を保存します。

AEM Assets の電子メール通知の設定

AEM Assets のコレクションが共有されている場合も共有されていない場合も、AEM から電子メール通知を受信できます。電子メール通知を設定するには、次の手順に従います。

1. メールサービスの設定で説明したように、電子メールサービスを設定します。
2. AEM に管理者としてログインします。ツール／操作／Web コンソール​をクリックして、Web コンソール設定を開きます。
3. Day CQ DAM Resource Collection Servlet を編集します。「send email」を選択します。「保存」をクリックします。