Show TOC

Text von Benachrichtigungs-E-Mails ändernLocate this document in the navigation structure

Voraussetzungen

Bei dieser Vorgehensweise müssen Sie den AS Java stoppen, d.h. Sie müssen die erforderliche Ausfallzeit, während der AS Java neu startet, einplanen.

Kontext

Die User Management Engine (UME) wird mit Standardtexten für Benachrichtiungs-E-Mails geliefert. Diese Texte werden in einer Java-Archiv-Datei (JAR-Datei) auf dem SAP NetWeaver Application Server (AS) Java abgelegt. Sie können die Standardtexte ändern und in der Konfigurationsablage des AS Java ablegen. Die modifizierten Texte, die in der Konfigurationsablage abgelegt sind, haben Vorrang vor den Texten in der JAR-Datei und werden bei einem Upgrade nicht überschrieben.

Die Benachrichtigungstexte werden in komprimierten Dateien definiert. Mit der UME werden eine Reihe von Dateien ausgeliefert. Jede Datei enthält die E-Mail-Benachrichtigungstexte für eine einzige landesspezifische Java-Sprachversion. Die Benutzerverwaltung bietet auch eine Reihe an Platzhaltervariablen, die Sie im Text verwenden können.

Vorgehensweise


  1. Legen Sie die Datei für die Sprache, die Sie benötigen, an und geben Sie die Texte, die Sie für die Benachrichtigungs-E-Mails verwenden wollen, ein.

    Empfehlung

    SAP empfiehlt Ihnen, eine vorhandene Datei zu kopieren und nach Bedarf zu ändern.

    Gehen Sie zum Ändern einer vorhandenen Datei folgendermaßen vor:

    1. Navigieren Sie auf dem Dateiserver an folgenden Ablageort:

      <AS_Java_Installation>\j2ee\cluster\bin\ext\com.sap.security.core.sda\

    2. Extrahieren Sie aus der Datei sap.com~tc~sec~ume~core~impl.jar die Datei com.sap.security.core.jar.

    3. Extrahieren Sie aus der Datei sap.com~tc~sec~ume~core~impl.jar die Datei notificationTexts_ <Java_locale>.properties .

      Die landesspezifischen Java-Sprachversionen bestehen aus dem Sprachcode ISO 639-1 und dem optionalen Landescode ISO 3166, die durch einen Unterstrich (_) getrennt sind.

      Beispiel

      Für jede Sprache gibt es eine eigene Datei. Deutsche Texte werden in notificationTexts_de.properties definiert. Texte für Hong-Kong-Chinesisch werden in notificationTexts_zh_HK.properties definiert. Um die E-Mail-Mitteilung in mehreren Sprachen zu ändern, müssen Sie alle entsprechenden Dateien ändern.

    4. Legen Sie eine Kopie der Datei an, und modifizieren Sie diese nach Bedarf.

      Verwenden Sie die Zeichenfolge \n, um eine neue Zeile zu beginnen.

      Folgende Platzhalter sind definiert und können verwendet werden, um entsprechende Variablen aus den Benutzerdaten zu holen.

      Platzhalter

      Beschreibung

      {0}

      Anzeigename des Senders

      {1}

      Anrede des Senders

      {2}

      Vorname des Senders

      {3}

      Nachname des Senders

      {4}

      Anzeigename des Empfängers

      {5}

      Anrede des Empfängers

      {6}

      Vorname des Empfängers

      {7}

      Nachname des Empfängers

      {8}

      Kennwort des Empfängers

      Hinweis

      Das System ersetzt den Platzhalter durch das Kennwort,

      • wenn sich Benutzer selbst registrieren und das System das Benutzerkennwort automatisch generiert

      • wenn Benutzer ihr eigenes Kennwort mit der Anmeldehilfe zurücksetzen

      • wenn der Benutzeradministrator das Kennwort des Benutzers ändert oder zurücksetzt

      • wenn der Benutzeradministrator einen neuen Benutzer anlegt

      Achtung

      Das System versendet das Kennwort in Klartext. Die Benutzer müssen ihr Kennwort bei der ersten Gelegenheit ändern.

      {9}

      Freitext. Dies ist der Text, den der Administrator oder der Benutzer im Textfeld hinzufügen kann, z.B. beim Sperren eines Benutzers. Entfernen Sie den Freitextplatzhalter nicht.

    5. Sichern Sie die Datei unter dem Namen com.sap.security.core.util.notification.notificationTexts_ <Java_locale>.properties .

      Hinweis

      Bei der Ermittlung der für die Benachrichtigungstexte zu verwendenden Datei verwendet die UME folgende Kriterien:

      • Wenn die landesspezifische Java-Sprachversion des Benutzers angegeben wird, versucht die UME, die landesspezifische Java-Sprachversion im Benutzerprofil mit der landesspezifischen Java-Sprachversion im Dateinamen abzugleichen. Die UME sucht zunächst nach der exakten landesspezifischen Java-Sprachversion, dann nach weniger spezifischen Versionen der landesspezifischen Sprachversion bis sie eine Übereinstimmung findet.

        Beispiel

        Donna Moore hat bei der Selbstregistrierung eine landesspezifische Java-Sprachversion en_US_Bronx in ihrem Benutzerprofil angegeben. Die UME sucht erst nach einer Datei mit dem Namensbestandteil en_US_Bronx. Wenn sie keine findet, sucht sie nach einer Datei mit dem Namensbestandteil en_US. Wenn sie keine findet, sucht sie nach einer Datei mit dem Namensbestandteil en. Wenn sie dann immer noch keine Datei findet, verwendet sie die Standardbenachrichtigungstexte.

      • Wenn die landesspezifische Java-Sprachversion des Benutzers nicht angegeben ist, erhält der Benutzer den Text der Standardtextdatei für E-Mail-Benachrichtigungen.

  2. Laden Sie die Datei in den AS Java wie folgt hoch:

    1. Fahren Sie alle Cluster-Elemente herunter.

    2. Starten Sie das Konfigurationswerkzeug.

    3. Wählen Sie die Drucktaste Switch to configuration editor mode.

    4. Wählen Sie auf der Registerkarte "Konfiguration anzeigen" Anfang des Navigationspfads cluster_config Nächster Navigationsschritt system Nächster Navigationsschritt custom_global Nächster Navigationsschritt cfg Nächster Navigationsschritt services Nächster Navigationsschritt com.sap.security.core.ume.service Nächster Navigationsschritt persistent Ende des Navigationspfads

    5. Wählen Sie die Drucktaste Switch between view and edit mode.

    6. Wählen Sie den Knoten persistent und dann die Drucktaste Create sub-node.

      Es öffnet sich ein Dialogfenster.

    7. Wählen Sie File entry.

    8. Laden Sie die von Ihnen angelegte Datei hoch.

      Der Text Ihrer Datei wird im Textfeld angezeigt.

    9. Legen Sie die Datei an, und schließen Sie anschließend das Fenster.

      Unter persistent wird ein neuer Eintrag namens com.sap.security.core.util.notification.notificationTexts_ <Java_locale>.properties angezeigt.

    10. Starten Sie alle Cluster-Elemente neu.

Ergebnisse

Die modifizierten Texte werden in den Benachrichtigungs-E-Mails angezeigt.