10.5 Infonachrichten & Splash-Screens — Benutzer informieren

10.5 Infonachrichten & Splash-Screens — Benutzer informieren

Zeigen Sie wichtige Mitteilungen beim Login oder innerhalb der Anwendung an — ideal für Wartungshinweise, Neuigkeiten oder Schulungshinweise.

1

Überblick

Infonachrichten und Splash-Screens ermöglichen es Ihnen, Ihre Benutzer gezielt über wichtige Sachverhalte zu informieren. Sie können:

  • Einen Splash-Screen beim Login anzeigen, der vor dem Anwendungsstart erscheint
  • Einen Banner innerhalb der Anwendung einblenden, der dauerhaft sichtbar ist
  • Eine Popup-Benachrichtigung auslösen, die einmalig nach dem Login angezeigt wird
  • Nachrichten zeitgesteuert aktivieren und deaktivieren
  • Die Zielgruppe einschränken (alle Benutzer, bestimmte Rollen, bestimmte URLs)
Unser Beispiel für diese Anleitung
Wartungshinweis am Wochenende

Sie möchten einen Splash-Screen einrichten, der beim Login anzeigt: „Am Samstag von 8–12 Uhr findet eine Wartung statt. Die Anwendung ist in dieser Zeit nicht erreichbar.“ Der Hinweis soll ab Donnerstag erscheinen und am Samstag automatisch enden.

2

Nachrichtentypen im Überblick

UDM unterstützt drei verschiedene Anzeigetypen für Infonachrichten:

Typ Anzeige Typische Verwendung
Splash-Screen Vollflächig beim Login, bevor die Anwendung geladen wird Wartungsankündigungen, Willkommensnachrichten, wichtige Änderungen
Banner Schmaler Hinweisbalken am oberen Rand innerhalb der Anwendung Laufende Hinweise, Systemstatus, Schulungshinweise
Popup-Benachrichtigung Dialog-Fenster, das einmalig nach dem Login erscheint Neuigkeiten, Release-Informationen, einmalige Hinweise
Hinweis Der Splash-Screen wird vor dem Laden der Blazor-Anwendung angezeigt und ist daher auch bei langsamen Verbindungen sofort sichtbar. Banner und Popup-Benachrichtigungen werden erst nach dem vollständigen Laden der Anwendung eingeblendet.
3

Schritt 1: Infonachricht / Splash-Screen anlegen

Navigieren Sie im Admin-Client zum Bereich „Verwaltung“ und klicken Sie auf die Karte „Splash-Screens“. Sie sehen die Liste aller vorhandenen Konfigurationen.

Klicken Sie auf „Neu“, um eine neue Nachricht anzulegen.

4

Schritt 2: Inhalt eingeben (Text oder HTML)

Im Detail-Dialog geben Sie den Inhalt Ihrer Nachricht ein. Sie können einfachen Text oder HTML-Formatierungen verwenden.

  1. Überschrift (HeadlineHtml) eingeben

    Geben Sie die Hauptüberschrift ein. HTML-Tags sind erlaubt, z. B. <b>Wartungshinweis</b>.

    In unserem Beispiel: Geplante <b>Wartung</b> am Samstag

  2. Untertitel (SubtitleHtml) eingeben

    Ergänzen Sie bei Bedarf einen Untertitel mit weiteren Details.

    In unserem Beispiel: Am Samstag von 8&ndash;12 Uhr findet eine Wartung statt.

  3. Optisches Erscheinungsbild anpassen

    Konfigurieren Sie optional Hintergrundfarbe, Spinner-Farbe, Logo und Hintergrundbild. Falls Sie nichts angeben, werden die Standardwerte des Systems verwendet.

Tipp Verwenden Sie HTML-Tags sparsam. Eine einfache <b>-Auszeichnung für Schlüsselwörter genügt in den meisten Fällen. Über das Feld „CustomCss“ können Sie bei Bedarf auch fortgeschrittene Gestaltung vornehmen.
AdminClient → Infonachricht konfigurieren
Inhalt
Titel (TitleHtml)
Wartung am Samstag
Untertitel
Am Samstag von 8–12 Uhr findet eine Wartung statt.
Anzeige
Anzeige-Modus
Splash beim Login
Sichtbar von
02.05.2026 00:00
Sichtbar bis
04.05.2026 12:00
Hintergrundfarbe
#1f3a5f
Aktiv
an
UserClient → Splash beim Login (Vorschau)
⚠
Wartung am Samstag
02.05. – 04.05.2026
Am Samstag von 8–12 Uhr findet eine Wartung statt. Bitte speichern Sie offene Vorgaenge rechtzeitig. geplant Splash
5

Schritt 3: Zeitraum festlegen (von/bis)

Legen Sie fest, wann die Nachricht angezeigt werden soll. Beide Felder sind optional:

Feld Beschreibung
Gültig ab Datum und Uhrzeit, ab wann die Nachricht angezeigt wird. Leer = sofort aktiv.
Gültig bis Datum und Uhrzeit, bis wann die Nachricht angezeigt wird. Leer = unbegrenzt.
Aktiv Schalter zum manuellen Aktivieren/Deaktivieren — unabhängig vom Zeitraum.

In unserem Beispiel: Gültig ab = Donnerstag 08:00 Uhr, Gültig bis = Samstag 12:00 Uhr, Aktiv = Ja.

Hinweis Eine Nachricht wird nur angezeigt, wenn beide Bedingungen erfüllt sind: Der Zeitraum muss passen und der Aktiv-Schalter muss auf „Ja“ stehen.
6

Schritt 4: Zielgruppe wählen

Bestimmen Sie, für welche Benutzer die Nachricht sichtbar ist. UDM verwendet hierfür ein URL-Pattern, das gegen die Zugriffs-URL der Benutzer abgeglichen wird.

URL-Pattern Wirkung
* Alle Benutzer auf allen URLs (Wildcard)
kunde-a.udm.de Nur Benutzer, die über diese spezifische URL zugreifen
*/public Alle Benutzer, deren URL den Pfad /public enthält

In unserem Beispiel: Wir verwenden *, da der Wartungshinweis alle Benutzer betrifft.

Tipp: Priorität bei mehreren Konfigurationen Wenn mehrere Splash-Screens gleichzeitig aktiv sind, bestimmt das Feld „Sortierung“ (SortOrder) die Priorität. Ein niedrigerer Wert bedeutet höhere Priorität. Zusätzlich gilt: Exakter Host-Match > Pfad-Pattern > Wildcard.
7

Schritt 5: Anzeige-Typ festlegen

Wählen Sie, wie die Nachricht dem Benutzer präsentiert werden soll:

  1. Einmalige Anzeige

    Die Nachricht wird jedem Benutzer genau einmal angezeigt. Sobald der Benutzer die Nachricht gesehen oder bestätigt hat, erscheint sie nicht erneut. Ideal für Release-Hinweise oder einmalige Ankündigungen.

  2. Wiederkehrende Anzeige

    Die Nachricht wird bei jedem Login erneut angezeigt, solange sie aktiv und im gültigen Zeitraum ist. Ideal für Wartungshinweise, die nicht übersehen werden dürfen.

In unserem Beispiel: Wir wählen „Wiederkehrend“, damit der Wartungshinweis bei jedem Login bis Samstag angezeigt wird.

8

Schritt 6: Speichern und Verteilung

Klicken Sie auf „Speichern“. Nach dem Speichern passiert Folgendes automatisch:

  1. Die Konfiguration wird in der Datenbank gespeichert.
  2. Alle verbundenen Clients werden per SignalR benachrichtigt.
  3. Der interne Splash-Cache wird auf allen Clients aktualisiert.
  4. Beim nächsten Login sehen die betroffenen Benutzer die neue Nachricht.
Sofortige Verteilung Sie müssen keinen Server-Neustart durchführen. Die Änderungen werden in Echtzeit an alle aktiven Clients verteilt. Benutzer, die bereits angemeldet sind, sehen den aktualisierten Splash-Screen beim nächsten Login.
9

Konfigurationsfelder im Detail

Feld Beschreibung
URL-Pattern Host- oder Pfad-Muster für die Zielgruppe. * für alle. Pflicht
HeadlineHtml Hauptüberschrift, darf HTML enthalten. Optional
SubtitleHtml Untertitel, darf HTML enthalten. Optional
Hintergrundfarbe CSS-Farbwert, z. B. #ffffff oder rgb(255,255,255). Optional
Spinner-Farbe Farbe des Lade-Spinners. Optional
CustomCss Freies CSS für erweiterte Gestaltung. Optional
Logo Bild-Upload für ein individuelles Logo. Optional
Hintergrundbild Bild-Upload für den Hintergrund. Optional
Sortierung Priorität bei mehreren aktiven Konfigurationen. Niedrig = hoch. Optional
Aktiv Manueller Ein-/Aus-Schalter. Pflicht
Achtung: Standardwerte Wenn kein Splash-Screen konfiguriert ist oder keine Konfiguration zur URL passt, greift der Fallback aus den Systemeinstellungen (appsettings.json). Änderungen an den Fallback-Werten erfordern einen Server-Neustart.
Tipp: Kundenspezifische Splash-Screens Nutzen Sie unterschiedliche URL-Patterns, um verschiedenen Kundengruppen individuelle Splash-Screens anzuzeigen. So kann z. B. kunde-a.udm.de ein anderes Logo und andere Farben erhalten als kunde-b.udm.de.
10

Häufige Fragen

Frage Antwort
Kann ich mehrere Splash-Screens gleichzeitig aktiv haben? Ja. Pro URL wird jedoch nur eine Konfiguration angezeigt — diejenige mit der höchsten Priorität (niedrigster SortOrder). Exakte Host-Matches haben Vorrang vor Wildcards.
Muss ich den Server neu starten? Nein. Änderungen werden per SignalR in Echtzeit an alle Clients verteilt. Nur Änderungen an den Fallback-Werten in der appsettings.json erfordern einen Neustart.
Welche Bildformate werden für Logo und Hintergrund unterstützt? PNG, JPEG und SVG. Die Bilder werden intern als Base64-Data-URI gecacht, sodass kein zusätzlicher HTTP-Request entsteht.
Wie deaktiviere ich einen Splash-Screen sofort? Setzen Sie den Aktiv-Schalter auf „Nein“ und speichern Sie. Die Änderung wirkt sofort für alle neuen Logins.
Kann ich HTML im Inhalt verwenden? Ja. Die Felder HeadlineHtml und SubtitleHtml akzeptieren HTML-Tags. Verwenden Sie z. B. <b>, <br> oder <span style="..."> für Formatierungen.
Was passiert, wenn der Zeitraum abgelaufen ist? Die Nachricht wird automatisch nicht mehr angezeigt. Sie bleibt in der Liste erhalten und kann später mit neuem Zeitraum reaktiviert werden.