Show Menu
トピック×

電子メール通知の設定

AEM は、次のようなユーザーに電子メール通知を送信します。
  • 変更やレプリケーションなど、ページイベントを購読したことがある。 通知インボックス では、このようなイベントを購読する方法について説明します。
  • フォーラムイベントを購読したことがある
  • ワークフローで手順を実行する必要がある。 参加者ステップ では、ワークフローで電子メール通知を実行する方法について説明します。
前提条件:
  • ユーザーのプロファイルで有効な電子メールアドレスが定義されている必要があります。
  • The Day CQ Mail Service needs to be properly configured.
ユーザーへの通知は、各自がプロファイルで定義している言語の電子メールで送信されます。言語ごとに、独自のカスタマイズ可能なテンプレートがあります。新しい言語用には新しい電子メールテンプレートを追加できます。
AEM を操作しているときは、このようなサービスの設定を管理する方法がいくつかあります。詳細および推奨事項については、 OSGi の設定 を参照してください。

メールサービスの設定

AEM で電子メールを送信できるようにするために、 Day CQ Mail Service を適切に設定する必要があります。設定は、Web コンソールで表示できます。AEM を操作しているときは、このようなサービスの設定を管理する方法がいくつかあります。詳細および推奨事項については、 OSGi の設定 を参照してください。
以下の制約が適用されます。
  • SMTP サーバーポート ​は 25 以上にする必要があります。
  • The SMTP server host name must not be blank.
  • 「送信元」アドレス ​は空白にしてはなりません。
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. Save All 」をクリックします。
次の手順を使用して、コンテンツパッケージソースフォルダーでノードを定義します。
  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 コンソールに次のように表示されます。

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

ページ通知用の電子メールテンプレートは次の場所にあります。
/etc/notification/email/default/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で、次のファイルを開きます。
    /etc/notification/email/default/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} に、ページイベントのタイプとページパスを次の形式で示します。
    <ページイベントタイプ> => <ページパス>
    次に例を示します。
    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>

Where <text_x> can be a mix of static text and dynamic string variables.
フォーラム通知用の電子メールテンプレート内では次の変数を使用できます。
  • ${time} 、イベントの日時。
  • ${forum.path} 、フォーラムページへのパス。

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

ワークフロー通知用の電子メールテンプレート(英語)は次の場所にあります。
/etc/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で、次のファイルを開きます。
    /etc/workflow/notification/email/default/en.txt
  2. ニーズに合わせてファイルを変更します。
  3. 変更内容を保存します。
テンプレートには以下の書式が必要です。
subject=<text_1>
 header=<text_2>
 message=<text_3>
 footer=<text_4>

Where <text_x> can be a mix of static text and dynamic string variables. Each line of an <text_x> item needs to be ended with a backslash ( \ ), except for the last instance, when the absence of the backslash indicates the end of the <text_x> string variable.
テンプレート形式について詳しくは、 Properties.load() メソッドの javadocs を参照してください。
The method ${payload.path.open} reveals the path to the payload of the workitem. For example, for a page in Sites then then payload.path.open would be similar to /bin/wcmcommand?cmd=open&path=… .; this is without the server name, which is why the template prepends this with ${host.prefix} .
電子メールテンプレート内では以下の変数を使用できます。
  • ${event.EventType} 、イベントのタイプ
  • ${event.TimeStamp} 、イベントの日時
  • ${event.User} 、イベントをトリガーしたユーザー
  • ${initiator.home} 、イニシエータノードのパス
  • ${initiator.name} 、イニシエータ名
  • ${initiator.email} 、イニシエータの電子メールアドレス
  • ${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. In CRXDE, add a file <language-code>.txt below:
    • /etc/notification/email/default/com.day.cq.wcm.core.page :ページ通知
    • /etc/notification/email/default/com.day.cq.collab.forum :フォーラム通知
    • /etc/workflow/notification/email/default :ワークフロー通知
  2. 言語に合わせてファイルを調整します。
  3. 変更内容を保存します。
The <language-code> used as the filename for the email template needs to be a two-letters lower-case language code that is recognized by AEM. 言語コードについては、AEM は ISO-639-1 に依存しています。

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

AEM Assets のコレクションが共有されている場合も共有されていない場合も、AEM から電子メール通知を受信できます。電子メール通知を設定するには、次の手順に従います。
  1. メールサービスの設定 で説明したように、電子メールサービスを設定します。
  2. AEM に管理者としてログインします。 ツール 操作 Web コンソール ​をクリックして、Web コンソール設定を開きます。
  3. Day CQ DAM Resource Collection Servlet を編集します。「 send email 」を選択します。「 保存 」をクリックします。