Benachrichtigungen anpassen, die als einzelne E-Mails gesendet werden

Sie können die standardmäßigen E-Mail-Nachrichten anpassen, die von den Anwendungen in IBM® Connections gesendet werden. Dazu gehören auch die automatisch generierten Benachrichtigungen, die von der Anwendung "Nachrichten" generiert werden.

Vorbereitende Schritte

Wichtig:

Ab IBM Connections 6.0 CR4 wird eine neue Vorlagenversion bereitgestellt, die über die entsprechende Bearbeitung der Konfiguration aktiviert werden kann. Weitere Informationen finden Sie im Abschnitt Neue Benachrichtigungsvorlagen aktivieren.
Sichern Sie den ursprünglichen Benachrichtigungsordner, bevor Sie Anpassungen vornehmen. Stellen Sie außerdem sicher, dass alle angepassten Dateien gesichert sind, bevor Sie ein Produktupgrade durchführen oder eine kumulative Aktualisierung oder ein Fixpack anwenden, da Sie Ihre Änderungen möglicherweise nach dem Vornehmen von Aktualisierungen erneut manuell zusammenfügen müssen.

Informationen zu diesem Vorgang

Der Inhalt der einzelnen Benachrichtigungen wird in Vorlagen definiert, die von der FreeMarker-Engine verarbeitet werden. Sie können den Inhalt der Benachrichtigungen anpassen, indem Sie die bereits vorhandenen Vorlagendateien ändern oder indem Sie die Dateien durch benutzerdefinierte Vorlagen ersetzen, die Sie selbst erstellen. Sie können außerdem die Eigenschaftendateien der Benachrichtigungen ändern, um benutzerdefinierte Zeichenfolgen zu den Vorlagen hinzuzufügen und die in den Benachrichtigungen verwendeten Bilder zu ändern.

Vorgehensweise

Gehen Sie wie folgt vor, um den Inhalt einer E-Mail-Nachricht anzupassen.

Gehen Sie wie folgt vor, um eine bereits vorhandene Vorlagendatei anzupassen:
1. Suchen Sie die FreeMarker-Vorlage, die der Benachrichtigung entspricht, die Sie anpassen möchten. Unter Benachrichtigungen anpassen finden Sie weitere Informationen zu den Benachrichtigungstypen, die in IBM Connections verwendet werden.
  Die Benachrichtigungen werden im folgenden Verzeichnis gespeichert:
```
app_server_root/profiles/dm_profile_root/config/cells/cell_name/LotusConnections-config/notifications/
```
  Dabei steht app_server_root für das WebSphere Application Server-Installationsverzeichnis und dm_profile_root für das Deployment Manager-Profilverzeichnis; in der Regel handelt es sich dabei um "dmgr01".
  Sie finden die Ordner für die einzelnen Anwendungen sowie einen Ordner für geteilte Ressourcen in diesem Verzeichnis. Suchen Sie im relevanten Anwendungsordner die FreeMarker-Vorlage der Benachrichtigung, die Sie anpassen möchten. Wenn Sie die zu ändernde Vorlage gefunden haben, öffnen Sie die Datei .ftl in einem Texteditor.
2. Passen Sie die Vorlage wie gewünscht an. Weitere Informationen zum Bearbeiten der Vorlagen finden Sie in der FreeMarker-Dokumentation auf der folgenden Webseite: http://freemarker.sourceforge.net/docs/index.html
  Anmerkung: Derzeit wird die FreeMarker-Version 2.3.15 verwendet.
3. Speichern Sie Ihre Änderungen und schließen Sie dann die Datei.
4. Synchronisieren Sie alle Knoten mithilfe von Integrated Solutions Console.
5. Beenden Sie die Anwendung "Nachrichten" und starten Sie sie erneut.
Gehen Sie wie folgt vor, um die in der Benachrichtigung verwendeten Textzeichenfolgen zu bearbeiten:
1. Öffnen Sie in einem Texteditor die Dateien notification_language_code.properties in einem der folgenden Verzeichnisse und nehmen Sie Ihre Änderungen vor:
  - Anwendungsspezifische Zeichenfolgen:
```
app_server_root/profiles/dm_profile_root/config/cells/cell_name/LotusConnections-config/notifications/application_name/resources/nls
```
  - Geteilte Zeichenfolgen:
```
app_server_root/profiles/dm_profile_root/config/cells/cell_name/LotusConnections-config/notifications/resources/nls
```
  Dabei steht language_code für die Ländereinstellung der Sprache. Beispiel: notification_fr.properties.
  Tipp: Um anzuzeigen, wo die einzelnen Zeichenfolgen, die Sie bearbeiten, verwendet werden, sehen Sie sich die .ftl-Vorlagendateien im selben Verzeichnis an und überprüfen Sie die Anweisungen im folgenden Format:
```
u.resource("key")
```
  Dabei ist key der Schlüssel einer übersetzten Zeichenfolge in den Ressourcenpaketdateien vom Typ notification_language_code.properties.
  Beachten Sie, dass das Benachrichtigungsframework zuerst im Ordner mit den anwendungsspezifischen Ressourcen sucht, bevor es zu den geteilten Zeichenfolgen im Ordner mit den geteilten Ressourcen übergeht.
2. Speichern Sie Ihre Änderungen und schließen Sie die Dateien.
3. Synchronisieren Sie alle Knoten mithilfe von Integrated Solutions Console.
4. Beenden Sie die Anwendung "Nachrichten" und starten Sie sie erneut.
Gehen Sie wie folgt vor, um die in der Benachrichtigung verwendeten Bilder anzupassen:
1. Suchen Sie die Bilder in einem der folgenden Verzeichnisse:
  - Anwendungsspezifische Bilder:
```
app_server_root/profiles/dm_profile_root/config/cells/cell_name/LotusConnections-config/notifications/application_name/resources/images
```
  - Geteilte Bilder:
```
app_server_root/profiles/dm_profile_root/config/cells/cell_name/LotusConnections-config/news/notifications/resources/images
```
  Beachten Sie, dass die anwendungsspezifischen Bilder vor den Bildern im Ordner mit den geteilten Ressourcen geladen werden. Wenn ein Bild aus dem Ordner mit den anwendungsspezifischen Ressourcen geladen wird, wird der Ordner mit den geteilten Ressourcen nicht nach diesem Bild durchsucht.
2. Ersetzen Sie alle Bilder, die Sie mit Ihrer eigenen Version unter Verwendung des gleichen Dateinamens anpassen möchten. Achten Sie auf eine kleine Bildgröße, da die Bilder als MIME-Anhang an die entsprechenden E-Mail-Auszüge gesendet werden.
3. Synchronisieren Sie alle Knoten mithilfe von Integrated Solutions Console.
4. Beenden Sie die Anwendung "Nachrichten" und starten Sie sie erneut.
Gehen Sie wie folgt vor, um die in Benachrichtigungen verwendete Absender-E-Mail-Adresse anzupassen:
1. Befolgen Sie die Anweisungen unter Auf Benachrichtigungskonfigurationsdatei zugreifen, um die Datei /LotusConnections-config/notification-config.xml auszuchecken und zu öffnen. Jede App-Quelle verfügt über eine sender-Eigenschaft. Beispiel: Die Nachrichten-App (die für das Senden von täglichen/wöchentlichen Auszügen verantwortlich ist) verfügt möglicherweise über eine sender-Eigenschaft, die der folgenden ähnelt:
```
<property name="sender">news-admin@example.com/property>
```
2. Ändern Sie das E-Mail-Format und den Benutzernamen in der Zeile sender in einen aussagekräftigeren Namen für die Benutzer. Beispiel: Wenn Sie das E-Mail-Format in "Firstname Lastname<user@example.com>" ändern, haben Ihre Benutzer einen besseren Eindruck davon, von wem die Benachrichtigung stammt.
```
<property name="sender">Firstname Lastname &lt;user@example.com&gt;</property>
```
  Anmerkung: Vergewissern Sie sich, dass Sie die Escapezeichen < und > für die Zeichen < und > in der E-Mail-Adresse verwenden.
3. Checken Sie die Datei /LotusConnections-config/notification-config.xml ein und starten Sie die Anwendung "Nachrichten" erneut, damit die Änderungen wirksam werden. Benutzer sehen dann die neue Absenderadresse der Nachricht, beispielsweise <Renovations-Newsflash@example.com> im Feld "Absender" für Benachrichtigungen und E-Mail-Auszüge.