Vous consultez actuellement l'aide de la version:

AEM envoie des notifications aux utilisateurs qui :

  • Ont souscrit aux événements de pages, par exemple la modification ou la réplication. La section Boîte de réception de notifications décrit comment s’abonner à ces événements.
  • Ont souscrit aux événements de forums.
  • Doivent effectuer une opération dans un workflow. La section Étape du participant décrit comment déclencher la notification électronique dans un workflow.

Conditions préalables :

  • L’utilisateur doit disposer d’une adresse électronique valide définie dans son profil.
  • La variable Service de messagerie Day CQ doit être correctement configurée.

Lorsque l’utilisateur est averti, il reçoit un courrier électronique dans la langue définie dans son profil. Chaque langue possède son propre modèle, qui peut être personnalisé. De nouveaux modèles de courrier électronique peuvent être ajoutés pour de nouvelles langues.

Remarque :

Lorsque vous utilisez AEM, plusieurs méthodes permettent de gérer les paramètres de configuration pour ces services. Voir Configuration d’OSGi pour plus de détails et connaître les pratiques recommandées.

Configuration du service de messagerie

Pour qu’AEM puisse envoyer des courriers électroniques, le service de messagerie Day CQ doit être correctement configuré. Vous pouvez afficher la configuration dans la console Web. Lorsque vous utilisez AEM, plusieurs méthodes permettent de gérer les paramètres de configuration pour ces services. Voir Configuration d’OSGi pour plus de détails et connaître les pratiques recommandées.

Les contraintes suivantes s’appliquent :

  • Le port de serveur SMTP doit être le port 25 ou supérieur.
  • Le nom d’hôte de serveur SMTP ne doit pas être vide.
  • L’adresse « De » ne doit pas être vide.

Pour résoudre plus facilement un problème avec le service de messagerie Day CQ, vous pouvez examiner les journaux du service :

com.day.cq.mailer.DefaultMailService

La configuration ressemble à ce qui suit dans la console Web :

chlimage_1

Configuration du canal de notification électronique

Lorsque vous vous abonnez à des notifications d’événement de page ou de forum, l’adresse électronique De est définie sur no-reply@acme.com par défaut. Vous pouvez modifier cette valeur en configurant le service Notification par courrier électronique dans la console Web.

Pour configurer l’adresse électronique De, ajoutez un nœud sling:OsgiConfig au référentiel. Procédez comme suit pour ajouter le nœud directement avec CRXDE Lite :

  1. Dans CRXDE Lite, ajoutez un dossier nommé config sous votre dossier d’application.
  2. Dans le fichier config, ajoutez un nœud nommé
    com.day.cq.wcm.notification.email.impl.EmailChannel de type sling:OsgiConfig.
  3. Ajoutez une propriété String au nœud nommé email.from. Pour la valeur, indiquez l’adresse électronique que vous souhaitez utiliser.
  4. Cliquez sur Enregistrer tout.

Utilisez la procédure suivante pour définir le nœud dans vos dossiers sources de module de contenu :

  1. Dans votre dossier jcr_root/apps/app_name/config. Créez un fichier nommé com.day.cq.wcm.notification.email.impl.EmailChannel.xml 
  2. Ajoutez le fichier XML suivant pour représenter le nœud :

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

  3. Remplacez la valeur de l’attribut email.from (name@server.com) par votre adresse électronique.
  4. Enregistrez le fichier.

Configuration du service de notification électronique de workflow

Lorsque vous recevez des notifications électroniques de workflow, l’adresse électronique De et le préfixe URL hôte sont définis sur les valeurs par défaut. Vous pouvez modifier ces valeurs en configurant le service de notification électronique de workflow Day CQ dans la console Web. Dans ce cas, il est recommandé de conserver le changement dans le référentiel.

La configuration par défaut se présente comme suit dans la console Web :

chlimage_1

Modèles de courrier électronique pour la notification de page

Les modèles de courrier électronique pour les notifications de page se trouvent à l’emplacement suivant :

/etc/notification/email/default/com.day.cq.wcm.core.page

Le modèle en anglais par défaut (en.txt) est défini comme suit :

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.

Personnalisation des modèles de courrier électronique pour la notification de page

Pour personnaliser le modèle de courrier électronique en anglais en vue de la notification de page :

  1. Dans CRXDE, ouvrez le fichier
    /etc/notification/email/default/com.day.cq.wcm.core.page/en.txt
  2. Modifiez le fichier en fonction de vos besoins.
  3. Enregistrez les modifications.

Le modèle doit avoir le format suivant :

subject=<texte_1>
header=<texte_2>
message=<texte_3>
footer=<texte_4>

<text_x> pouvant combiner du texte statique et des variables de chaînes dynamiques. Les variables suivantes peuvent être utilisées dans le modèle de courrier électronique pour les notifications de page :

  • ${time}, la date et l’heure de l’événement.
  • ${userFullName}, le nom complet de l’utilisateur ayant déclenché l’événement.
  • ${userId}, l’ID de l’utilisateur ayant déclenché l’événement.
  • ${modifications}, décrit le type de l’événement de page et le chemin d’accès à la page au format :
    <type de page d’événement> => <chemin d’accès à la page>
    Par exemple :
    PageModified => /content/geometrixx/en/products

Modèles de courrier électronique pour les notifications de forum

Les modèles de courrier électronique pour les notifications de forum se trouvent dans l’emplacement suivant :

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

Le modèle en anglais par défaut (en.txt) est défini comme suit :

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.

Personnalisation des modèles de courrier électronique pour les notifications de forum

Pour personnaliser le modèle de courrier électronique en anglais en vue de la notification de forum :

  1. Dans CRXDE, ouvrez le fichier
    /etc/notification/email/default/com.day.cq.collab.forum/en.txt
  2. Modifiez le fichier en fonction de vos besoins.
  3. Enregistrez les modifications.

Le modèle doit avoir le format suivant :

subject=<texte_1>
header=<texte_2>
message=<texte_3>
footer=<texte_4>

<text_x> pouvant combiner du texte statique et des variables de chaînes dynamiques.

Les variables suivantes peuvent être utilisées dans le modèle de courrier électronique pour les notifications de forum :

  • ${time}, la date et l’heure de l’événement.
  • ${forum.path}, le chemin d’accès à la page de forum.

Modèles de courrier électronique pour la notification de workflow

Le modèle de courrier électronique pour les notifications de workflow (en anglais) se trouve à l’emplacement suivant :

/etc/workflow/notification/email/default/en.txt

Il est défini comme suit :

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.

Personnalisation des modèles de courrier électronique pour la notification de workflow

Pour personnaliser le modèle de courrier électronique en anglais en vue de la notification d’événement de workflow :

  1. Dans CRXDE, ouvrez le fichier
    /etc/workflow/notification/email/default/en.txt
  2. Modifiez le fichier en fonction de vos besoins.
  3. Enregistrez les modifications.

Le modèle doit avoir le format suivant :

subject=<texte_1>
header=<texte_2>
message=<texte_3>
footer=<texte_4>

Remarque :

<text_x> pouvant combiner du texte statique et des variables de chaînes dynamiques. Chaque ligne d’un élément <texte_x> doit se terminer par une barre oblique inverse (\), à l’exception de la dernière instance, lorsque l’absence de la barre oblique inverse indique la fin de la variable de chaîne <texte_x>.

Vous trouverez plus d’informations sur le format des modèles dans la méthode javadocs of the Properties.load().

La méthode ${payload.path.open} révèle le chemin d’accès à la charge utile de l’élément de travail. Par exemple, pour une page dans Sites, payload.path.open serait similaire à /bin/wcmcommand?cmd=open&path=….sans le nom de serveur, raison pour laquelle le modèle fait précéder ceci de ${host.prefix}.

Les variables suivantes peuvent être utilisées dans le modèle de courrier électronique :

  • ${event.EventType}, type de l’événement
  • ${event.TimeStamp}, date et heure de l’événement
  • ${event.User}, utilisateur ayant déclenché l’événement
  • ${initiator.home}, chemin d’accès au nœud de l’initiateur
  • ${initiator.name}, nom de l’initiateur
  • ${initiator.email}, adresse électronique de l’initiateur
  • ${item.id}, ID de l’élément de travail
  • ${item.node.id}, ID du nœud dans le modèle de workflow associé à cet élément de travail
  • ${item.node.title}, titre de l’élément de travail
  • ${participant.email}, adresse électronique du participant
  • ${participant.name}, nom du participant
  • ${participant.familyName}, nom de famille du participant
  • ${participant.id}, ID du participant
  • ${participant.language}, langue du participant
  • ${instance.id}, ID du workflow
  • ${instance.state}, état du workflow
  • ${model.title}, titre du modèle de workflow
  • ${model.id}, ID du modèle de workflow
  • ${model.version}, version du modèle de workflow
  • ${payload.data}, charge utile
  • ${payload.type}, type de charge utile
  • ${payload.path}, chemin d’accès à la charge utile
  • ${host.prefix}, préfixe hôte, par exemple, http://localhost:4502

Ajout d’un modèle de courrier électronique pour une nouvelle langue

Pour ajouter un modèle pour une nouvelle langue :

  1. Dans CRXDE, ajoutez un fichier <code-langue>.txt ci-dessous :
    • /etc/notification/email/default/com.day.cq.wcm.core.page : pour les notifications de page
    • /etc/notification/email/default/com.day.cq.collab.forum : pour les notifications de forum
    • /etc/workflow/notification/email/default : pour les notifications de workflow
  2. Adaptez le fichier à la langue.
  3. Enregistrez les modifications.

Remarque :

Le <code-langue> utilisé comme nom de fichier du modèle de courrier électronique doit être un code de langue à deux lettres en minuscules reconnu par AEM. Pour les codes de langue, AEM s’appuie sur la norme ISO-639-1.

Configuration des notifications électroniques d’AEM Assets

Quand les collections dans AEM Assets sont partagées ou non, les utilisateurs peuvent recevoir des notifications électroniques de la part d’AEM. Pour configurer les notifications électroniques, procédez comme suit.

  1. Configurez le service de messagerie, comme décrit ci-dessus dans Configuration du service de messagerie.

  2. Connectez-vous à AEM en tant qu’administrateur. Cliquez sur Outils > Opérations > Console web pour ouvrir la configuration de la console web.

  3. Modifiez la servlet de collection de ressources de la gestion des actifs numériques Day CQ. Sélectionnez Envoyer un courrier électronique. Cliquez sur Enregistrer.

Ce produit est distribué sous licence Creative Commons Attribution - Pas d’utilisation commerciale - Partage à l’identique 3.0 non transposé  Les publications Twitter™ et Facebook ne sont pas couvertes par les dispositions Creative Commons.

Mentions légales   |   Politique de confidentialité en ligne