{"id":7173,"date":"2021-04-27T08:00:00","date_gmt":"2021-04-27T06:00:00","guid":{"rendered":"https:\/\/u-labs.de\/portal\/?p=7173"},"modified":"2021-05-11T17:56:31","modified_gmt":"2021-05-11T15:56:31","slug":"mailserver-in-hcl-connections-konfigurieren-um-benachrichtigungs-mails-zu-verschicken-und-den-newsletter-versand-zu-testen","status":"publish","type":"post","link":"https:\/\/u-labs.de\/portal\/mailserver-in-hcl-connections-konfigurieren-um-benachrichtigungs-mails-zu-verschicken-und-den-newsletter-versand-zu-testen\/","title":{"rendered":"Mailserver in HCL Connections konfigurieren, um Benachrichtigungs-Mails zu verschicken und den Newsletter-Versand zu testen"},"content":{"rendered":"

Auf einer Testinstallation von HCL Connections 6.5.1 wollte ich den E-Mail Versand testen, genauer den Newsletter. Hierf\u00fcr muss in der Anwendung ein SMTP-Konto konfiguriert werden. Konkret befindet sich diese Konfiguration in der WebSphere ISC unter Ressources > Mail > Mail sessions<\/strong>. Hier gibt es einen standardm\u00e4\u00dfig leeren Eintrag lcnotification<\/strong> von Connections. Im unteren Bereich kann ein SMTP-Server f\u00fcr den ausgehenden E-Mail Verkehr hinterlegt werden.<\/p>\n

\"\"<\/a><\/figure>\n

In der Regel ben\u00f6tigen Mailserver eine Authentifizierung. Ausnahmen gibt es m\u00f6glicherweise bei internen und Testmailservern. Bei mir ist diese aktiv, sodass ich rechts auf Custom properties<\/strong> klicken und ein Attribut mail.smtp.auth<\/strong> mit dem Wert true <\/strong>anlegen muss. Nun meldet sich Connections ordnungsgem\u00e4\u00df am Mailserver an, wodurch der E-Mail Versand m\u00f6glich ist.<\/p>\n

Absender-Adresse setzen<\/h3>\n

In der notifications-config.xml<\/strong> gibt es bei den Properties ein Element globalSenderEmailAddress<\/strong>. Dort sollte man eine g\u00fcltige E-Mail Adresse eintragen, die als Absender verwendet wird. F\u00fcr einzelne Benachrichtigungen (z.B. Kommentare) kommt die Adresse des Benutzers zum Einsatz, der das Ereignis ausgel\u00f6st hat. F\u00fcr die t\u00e4glichen oder w\u00f6chentlichen Newsletter nutz das System globalSenderEmailAddress<\/strong>. Wenn die auf @example.com steht, lehnen manche Mailserver die Nachricht ggf. ab oder verschieben sie in den Spam-Ordner.<\/p>\n

Damit der globale Sender auch genutzt wird, muss ein neues Attribut innerhalb <properties> angelegt werden:<\/p>\n

<property name="alwaysUseGlobalSender">true<\/property><<\/code><\/pre>\n
Alternativ kann man auch die E-Mail Adressen einzeln f\u00fcr jede Anwendung weiter unten setzen, falls man dort unterschiedliche Absender w\u00fcnscht.<\/p>\n
Fehleranalyse: Protokollierung der Mails<\/h2>\n
Auf der vorherigen lcnotification Eigenschaftenseite gibt es einen Haken Enable debug mode<\/strong>. Ist er aktiviert, werden ausf\u00fchrliche Logereignisse vom Mailversand in den AppsCluster geschrieben, worin die News-Anwendung l\u00e4uft. Standardm\u00e4\u00dfig ist dies der InfraCluster. Nach dem Neustart der News-Anwendung werden alle Details zu versendeten E-Mails in das SystemOut-Log geschrieben (z.B. \/opt\/IBM\/WebSphere\/AppServer\/profiles\/CnxNode01\/logs\/InfraCluster_server1\/SystemOut.log<\/strong>), inklusive dem HTML-Body der Nachricht.<\/p>\n
T\u00e4glichen und w\u00f6chentlichen Newsletter testen<\/h2>\n
Beispielhaft folgende Adresse meines Testsystemes f\u00fcr den Aufbau, cnx.fritz.box ist entsprechend durch den IHS-Hostname zu ersetzen:<\/p>\n
https:\/\/cnx.fritz.box\/news\/web\/testEmailDigestSendMail.action?type=daily&begin=2020-08-10<\/a><\/p>\n
Der aufrufende Nutzer muss die Administratorrolle in der News-Anwendung haben, ansonsten funktioniert der Zugriff nicht. Wahlweise kann mit type=weekly<\/strong> auch der w\u00f6chentliche Versand getriggert werden. Optional erweitert begin <\/strong>den Zeitstempel zur Ber\u00fccksichtigung der Ereignisse in Connections. Auf Testsystemen w\u00e4hle ich bewusst ein Datum aus der entfernteren Vergangenheit. Da dort oft nicht all zu viele Ereignisse entstehen, liegen sonst keine Daten vor. Und wenn keine Daten f\u00fcr den Versand vorliegen, passiert schlichtweg nichts – ihr erhaltet weder eine E-Mail, noch eine Fehlermeldung.<\/p>\n
Wichtig ist auch, dass der Benachrichtigungsintervall unter https:\/\/cnx.fritz.box\/news\/ passt. Das hei\u00dft: Wenn ihr den t\u00e4glichen Newsletter testen m\u00f6chtet, muss dort die jeweilige Anwendung auf „t\u00e4glich“ stehen. Falls dort einzelne E-Mails aktiviert sind, wird ebenfalls kein Newsletter verschickt – in diesem Fall wurde der Nutzer ja bereits \u00fcber die auf das Ereignis folgende Mail informiert.<\/p>\n","protected":false},"excerpt":{"rendered":"
Auf einer Testinstallation von HCL Connections 6.5.1 wollte ich den E-Mail Versand testen, genauer den Newsletter. Hierf\u00fcr muss in der Anwendung ein SMTP-Konto konfiguriert werden. Konkret befindet sich diese Konfiguration in der WebSphere ISC unter Ressources > Mail > Mail sessions. Hier gibt es einen standardm\u00e4\u00dfig leeren Eintrag lcnotification von Connections. Im unteren Bereich kann …<\/p>\n","protected":false},"author":5,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[765],"tags":[550,760,850,866],"class_list":["post-7173","post","type-post","status-publish","format-standard","hentry","category-hcl-connections","tag-e-mail","tag-hcl-connections","tag-hcl-connections-6-5","tag-hcl-connections-newsletter"],"_links":{"self":[{"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/posts\/7173","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/comments?post=7173"}],"version-history":[{"count":5,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/posts\/7173\/revisions"}],"predecessor-version":[{"id":7215,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/posts\/7173\/revisions\/7215"}],"wp:attachment":[{"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/media?parent=7173"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/categories?post=7173"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/tags?post=7173"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}