Einführung
Dieser Artikel enthält Informationen über die Umstellung auf den neuen Benachrichtigungsdienst, unter anderem:
- Antworten auf häufig gestellte Fragen
- Bemerkenswerte Unterschiede im Vergleich zu Legacy-Benachrichtigungen
- Überlegungen zur Portierung bereits bestehender Benachrichtigungen
Die Hauptdokumentation des neuen Benachrichtigungsdienstes finden Sie in den folgenden Artikeln der Wissensdatenbank:
Konfigurieren von Benachrichtigungen
Shortcodes für Benachrichtigungen
Benachrichtigungsereignisse und -bedingungen
Informationen über den Zeitplan für die Implementierung finden Sie im Community-Beitrag: New Notification Service Rollout: Gradual Release Plan | Community.
Portierung bestehender Benachrichtigungen
Bei der Umstellung auf das neue Benachrichtigungssystem werden vorhandene Benachrichtigungen automatisch übernommen, so dass Sie in den meisten Fällen keine manuellen Maßnahmen ergreifen müssen. Im weiteren Verlauf dieses Artikels finden Sie jedoch einige Punkte, die Sie vielleicht überprüfen sollten.
Shortcode-Syntax
Zuvor wurden die in den Nachrichtentext eingefügten Shortcodes durch eckige Klammern begrenzt, zum Beispiel [course_link].
Bei den neuen Benachrichtigungen werden alle Shortcodes stattdessen durch doppelte geschweifte Klammern abgegrenzt, zum Beispiel: {{course_link}}.
Nachdem Ihre Plattform auf den neuen Benachrichtigungsdienst umgestellt wird, werden die Shortcodes in Ihren bestehenden Benachrichtigungen automatisch in die neue Syntax umgewandelt. Sie müssen also nichts manuell anpassen.
Basis-URL für Links in Benachrichtigungen
Mit der Umstellung auf den neuen Benachrichtigungsdienst fügt das System automatisch die korrekte Basis-URL für jeden Empfänger in die Benachrichtigungslinks ein. Dies bedeutet, dass:
- Jede Person, die eine Nachricht mit einem Shortcode wie
{{course_link}}erhält, bekommt einen Link, der auf den jeweiligen Extended Enterprise-Client abzielt. - Es ist nicht erforderlich, separate Versionen einer Benachrichtigung für jeden Extended Enterprise-Client zu konfigurieren.
- Die Basis-URL einer Benachrichtigung wird nicht mehr von der Art der Planung oder davon beeinflusst, wer die Benachrichtigung bearbeitet oder speichert.
Weitere Informationen finden Sie im Artikel Shortcodes für Benachrichtigungen > Shortcode-Links und Extended Enterprise-Domains.
Shortcode für Kalenderanhänge
Mit dem neuen Benachrichtigungsdienst wird der alte [calendar_attachment]-Shortcode nicht mehr verwendet. Stattdessen können Sie jetzt Kalenderanhänge über einen Selektor in der Benutzeroberfläche hinzufügen.
Wenn bestehende Benachrichtigungen mit dem alten Shortcode auf den neuen Dienst umgestellt werden, entfernt das System automatisch [calendar_attachment] aus dem Nachrichtentext und fügt den neuen Kalenderanhang hinzu.
Daher müssen Sie möglicherweise den Nachrichtentext der Benachrichtigungen, die zuvor diesen Shortcode verwendeten, manuell überprüfen und anpassen. Zum Beispiel wird ein Satz wie „Kalenderlink zur Sitzung: [calendar_attachment]“ zu „Kalenderlink zur Sitzung: “ gekürzt.
In solchen Fällen sollten Sie den Satz in etwas wie „Der Kalenderlink zur Sitzung wird als Anhang zu dieser Nachricht gesendet“ umformulieren.
Benachrichtigung Lernende hat einen Lernplan abgeschlossen
Für diejenigen, die die Benachrichtigung Lernende hat einen Lernplan abgeschlossen verwenden, die von Benutzern in einem Zweig mit Power Usern oder Superadmins als Empfänger ausgelöst wird, erhalten die Empfänger mit der Umstellung auf das neue Benachrichtigungssystem jetzt nur noch Benachrichtigungen für Benutzer, die zu dem auslösenden Zweig gehören. Sie erhalten keine Benachrichtigungen mehr für andere Plattformbenutzer, die den Lernplan abschließen.
Portierung von Zeitplänen für Benachrichtigungen
Im neuen Benachrichtigungsdienst unterstützt der Planer Zeitrahmen innerhalb der folgenden zulässigen Bereiche:
Stunden: 1→72
Tage: 1→365
Wochen: 1→52
Monate: 1→24
Geplante Legacy-Benachrichtigungen mit einem Zeitrahmen außerhalb dieser Bereiche werden unter Anwendung der folgenden Konvertierungsregel portiert:
Konvertieren Sie den Wert in die nächste Maßeinheit, bis ein zulässiger Wert erreicht ist. Zum Beispiel:
73 Stunden → 4 Tage
371 Tage → 53 Wochen → 13 Monate
Die Uhrzeit ist immer auf 00:00 (bzw. 12 Uhr) entsprechend der festgelegten Zeitzone eingestellt.
Benachrichtigungen mit einem Zeitrahmen von mehr als 24 Monaten (z. B. 200 Wochen) werden nicht migriert.
Dementsprechend können Sie nach der Migration Ihrer bereits bestehenden Benachrichtigungen den durch die Umstellung erhaltenen Zeitrahmen anpassen und eine andere Tageszeit für den Versand der Benachrichtigung festlegen.
Falsche Shortcodes in migrierten Vorlagen
Nur für Sandbox-Plattformen, die im Dezember 2024 erstmals auf den neuen Benachrichtigungsdienst umgestellt wurden, müssen aufgrund eines Problems mit einigen Nachrichtenvorlagen die folgenden Benachrichtigungsarten überprüft und manuell angepasst werden:
Benutzer wurde (vom Administrator) erstellt
Benutzer wurde erstellt (bestätigte Registrierung)
Neue Version der Datenschutzrichtlinie
Neue Frage an Experten
Insbesondere können bereits bestehende Benachrichtigungen, die auf den betroffenen Vorlagen basieren, falsche Shortcodes enthalten, wie z. B.:
{{firstname}} → sollte {{first_name}} sein{{lastname}} → sollte {{last_name}} sein{{password}} → sollte {{user_password}} sein
Oder sie können Shortcodes enthalten, die nicht unter den für diese Benachrichtigung erlaubten aufgeführt sind. Zum Beispiel: {{firstname}} wenn das Benachrichtigungsereignis nur {{username}} zulässt.
Bitte beachten: Dieses Problem betrifft nicht die Plattformen, die erstmals im Januar 2025 oder später auf den neuen Benachrichtigungsdienst umgestellt wurden. Es betrifft nur die Sandboxen, die ursprünglich im Dezember 2024 migriert und anschließend zurückgesetzt wurden.
Was ist zu tun?
Wenn Ihre Plattform zu den potenziell betroffenen gehört, gehen Sie bitte so vor:
- Überprüfen Sie alle bereits vorhandenen Benachrichtigungen der betroffenen Ereignistypen und korrigieren Sie alle falschen Shortcodes manuell. Die zulässigen Shortcodes und ihre korrekte Syntax werden im Abschnitt Shortcodes des Bereichs für die Nachrichtenerstellung angezeigt.
Tipp: Das Problem betrifft nur die bereits vorhandenen Benachrichtigungen der betroffenen Ereignistypen, die vom älteren System migriert wurden. Die Vorlagen wurden nachträglich korrigiert, so dass bei der Erstellung neuer Benachrichtigungen dieser Typen die Shortcodes korrekt sind.
Migration von Benachrichtigungen zu gelöschten Kursen
Nach der Umstellung auf das neue Benachrichtigungssystem könnten einige Ihrer bestehenden migrierten Benachrichtigungen nun an ein breiteres Publikum als zuvor gerichtet sein und unerwartet an eine große Anzahl von Benutzern gesendet werden.
In diesem Fall ist die Ursache möglicherweise eine migrierte Benachrichtigung zu gelöschten oder inaktiven Kursen. Auf eine solche Benachrichtigung werden keine Inhaltsfilter angewandt (da der gesamte Zielinhalt gelöscht oder deaktiviert wurde).
- Bei Legacy-Benachrichtigungen wird eine Benachrichtigung ohne Inhaltsfilter nicht versandt.
- Mit dem neuen Benachrichtigungsdienst wird eine Benachrichtigung ohne Inhaltsfilter (falls von einem Superadmin gespeichert) für alle Kurse und Lernpläne auf der Plattform ausgelöst.
Empfohlene Aktion: Überprüfen Sie alle migrierten Benachrichtigungen, die zuvor möglicherweise an gelöschte oder inaktive Kurse gerichtet waren. Diese Benachrichtigungen könnten nun als global (ungefiltert) interpretiert und dabei an ein breiteres Publikum als beabsichtigt zugestellt werden.
Weitere Informationen erhalten Sie im Community-Beitrag zu diesem Thema (öffnet in einer neuen Registerkarte).
Migration von Extended Enterprise-Benachrichtigungen
Wenn Sie Extended Enterprise-Benachrichtigungen migriert haben, können Sie je nach deren Konfiguration von der folgenden Änderung der Empfänger und Auslöser betroffen sein:
In den Legacy-Benachrichtigungen waren die Auslöser und die Empfänger einer Benachrichtigung automatisch auf Benutzer des Extended Enterprise-Clients beschränkt, in dem diese Benachrichtigung konfiguriert und gespeichert wurde. Dies geschah auch dann, wenn kein Zweigfilter gesetzt war.
Infolgedessen konnten Sie Folgendes konfigurieren:
- Mehrere Versionen derselben Benachrichtigung, die jeweils auf die Benutzer eines anderen Extended Enterprise-Clients ausgerichtet waren.
- Dies konnte ohne einen Zweigfilter erreicht werden, indem jede Benachrichtigung einfach im entsprechenden Extended Enterprise-Client gespeichert wurde.
Mit dem neuen Benachrichtigungsdienst sind die Auslöser und Empfänger einer Benachrichtigung nicht mehr auf den Extended Enterprise-Client beschränkt, in dem die Benachrichtigung gespeichert ist. Wenn Sie also wie oben beschrieben konfigurierte Benachrichtigungen migriert haben, erhalten einige Benutzer jetzt möglicherweise doppelte Benachrichtigungen.
Sie können dies auf zwei Arten korrigieren:
- Methode 1: Hinzufügen von Zweigfiltern Behalten Sie zwar die mehreren Versionen derselben Benachrichtigung bei, fügen Sie aber in jede Version den entsprechenden Zweigfilter ein, der dem Extended Enterprise-Client entspricht, auf den sie abzielen soll.
- Methode 2: Verwenden einer einzigen Benachrichtigung Ersetzen Sie die mehreren Versionen derselben Benachrichtigung durch eine einzige Benachrichtigung, die für Empfänger aus allen Extended Enterprise-Clients funktioniert. Denken Sie daran, dass alle Shortcode-Links automatisch die richtige Basis-URL für jeden Empfänger verwenden. Sie können auch den {{extend_enterprise_logo}}-Shortcode verwenden, um dynamisch das richtige Plattformlogo einzufügen.
Beispiel: Bei Legacy-Benachrichtigungen haben Sie konfiguriert:
- Benutzer wurde in einen Kurs eingeschrieben ohne Zweigfilter, gespeichert auf der Domain A: Die Benachrichtigung wird nur von Benutzern ausgelöst, die zur Domain A gehören, und nur an Empfänger gesendet, die zur Domain A gehören
- Benutzer wurde in einen Kurs eingeschrieben ohne Zweigfilter, gespeichert auf der Domain B: Die Benachrichtigung wird nur von Benutzern ausgelöst, die zur Domain B gehören, und nur an Empfänger gesendet, die zur Domain B gehören
Nach der Umstellung auf den neuen Benachrichtigungsdienst können diese beiden Benachrichtigungen von einem Benutzer ausgelöst werden, der zu einer beliebigen Domain gehört, und werden an Empfänger gesendet, die zu einer beliebigen Domain gehören. So wird ein Benutzer, der sich in einen Kurs einschreibt, beide Benachrichtigungen (A und B) auslösen und erhalten.