Group Widget
Das Group Widget ist eine eingebettete Mini-Oberfläche, die — unabhängig von der Admin- oder Benutzer-Ansicht — den Live-Zustand einer einzelnen Gruppe anzeigt. Im Unterschied zu den anderen Einstiegspunkten verzichtet das Widget vollständig auf Tab-Navigation, Filter-Leisten und Begleit-UI: es zeigt sofort und in voller Fenstergröße die Gruppen-Mitgliederzustände der gewählten Gruppe.
Wofür ist das Widget gedacht?
Typische Einsatzszenarien:
- Einbettung in eine interne Wiki- oder Confluence-Seite, in der ein Team sich selbst beobachten möchte.
- Anzeige auf einem TV-Display oder Wallboard im Servicebüro, mit fester Gruppe per URL-Parameter.
- Integration in andere STARFACE-Module oder Dashboards (z. B. neben Insight-Analytics-Dashboards in einem Custom-Portal).
- Als eingebettetes iFrame in einer dritten Anwendung, die nur diese eine Gruppe braucht.
Aufbau der Anzeige
Das Widget zeigt eine einzige Komponente: die Group Member States-Liste der ausgewählten Gruppe.
Pro Mitglied erscheint dabei in einer Zeile:
- Name des Benutzers
- Telefoniestatus (Frei / Im Gespräch / Klingelt / Abgemeldet)
- Anmeldestatus in der Gruppe
- DND-/Umleitungs-Indikatoren
- ggf. Microsoft-Präsenz (sofern eine Anbindung besteht)
Eine ausführliche Symbol-Übersicht finden Sie unter Live-Monitor § Mitgliederstatus — das Widget verwendet dieselbe Komponente.
Gruppenauswahl
Die Gruppe, deren Mitglieder angezeigt werden, kann auf zwei Wegen festgelegt werden:
Variante 1: Interaktive Auswahl
Wenn das Widget ohne URL-Parameter geöffnet wird, erscheint in der ersten Spalte ein eingebauter Gruppen-Selektor. Der Benutzer wählt die anzuzeigende Gruppe manuell aus dem Dropdown.
Beim ersten Öffnen wird automatisch die alphabetisch erste Gruppe vorausgewählt.
Variante 2: Feste Gruppe per URL
Soll das Widget eine feste Gruppe anzeigen (z. B. weil es als TV-Wallboard für genau ein Team läuft), übergeben Sie die Gruppen-ID per URL-Parameter:
https://<starface-fqdn>/modules/<moduleId>/<instanceName>/group-widget?groupAccountId=<accountId>
groupAccountId— die Account-ID der STARFACE-Gruppe (zu finden im STARFACE-Admin unter Gruppen).
Bei festem Parameter wird der Dropdown durch den Gruppen-Namen als Text ersetzt — die Anzeige ist damit nicht mehr versehentlich umschaltbar, was für Wallboard-Szenarien gewünscht ist.
Aufrufen / Einbetten
Direkt im Browser öffnen
Rufen Sie eine der oben genannten URLs auf. Die Authentifizierung erfolgt mit den STARFACE-Zugangsdaten des aufrufenden Benutzers.
Als iFrame einbetten
<iframe
src="https://<starface-fqdn>/modules/<moduleId>/<instanceName>/group-widget?groupAccountId=<accountId>"
style="border: 0; width: 100%; height: 100%;"
allowfullscreen
></iframe>
Damit der iFrame-Aufruf ohne erneute Anmeldung funktioniert, sollte die einbettende Anwendung in derselben Domain oder via STARFACE-SSO authentifiziert sein. Bei eingebettetem Aufruf von einer fremden Domain blockieren manche Browser Drittanbieter-Cookies — das Widget zeigt dann die STARFACE-Anmeldeseite.
Auf einem TV-Display
Für die Anzeige auf einem TV-Display empfiehlt sich ein dedizierter, schlanker Browser im Kiosk-Modus (z. B. ChromeOS Signage, Mini-PCs mit ChromeOS oder Raspberry-Pi-basierte Lösungen wie WallboardOS):
- STARFACE-Benutzer mit Live-Daten-Berechtigung anlegen.
- Im Kiosk-Browser die Widget-URL mit
groupAccountIdöffnen. - Das Display wird die Gruppen-Mitgliederzustände dauerhaft und in Echtzeit anzeigen.
Berechtigungen
Damit das Widget Daten anzeigt, muss der aufrufende STARFACE-Benutzer für die ausgewählte Gruppe die Berechtigung Live-Daten abrufen (kombiniert mit Historische Daten abrufen) besitzen — siehe Einstellungen § Berechtigungen.
Wird ein Benutzer ohne entsprechende Berechtigung verwendet, zeigt das Widget die Gruppen-Liste leer oder eingeschränkt an.
Der Aufruf des Group Widgets benötigt — wie alle Insight Analytics-Funktionen ab der Pro-Edition — eine zugewiesene Lizenz für den aufrufenden Benutzer. Verwenden Sie für reine Wallboard-Setups einen dedizierten STARFACE-Benutzer (z. B. wallboard@firma.de), der genau diese eine Lizenz belegt.
In der Small Business Edition ist das Group Widget für alle Anlagenbenutzer ohne Berechtigungssteuerung nutzbar.
Unterschiede zu Live-Monitor und Historie
| Aspekt | Live-Monitor-Tab | Group Widget |
|---|---|---|
| Tab-Leiste | Sichtbar | Nicht sichtbar |
| KPI-Kacheln (Free Agents, Anruf-Chart, Warteschlange) | Sichtbar | Nicht sichtbar |
| Eingehende Anrufer-Liste | Sichtbar | Nicht sichtbar |
| Verlorene-Anrufer-Liste | Sichtbar | Nicht sichtbar |
| Mitgliederstatus | Sichtbar | Einzige sichtbare Komponente |
| Gruppen-Auswahl | Dropdown, frei wechselbar | Dropdown oder URL-Parameter |
| Einbettbarkeit (iFrame) | Theoretisch möglich, optisch überladen | Optimiert für Embedding |
Wenn Sie eine vollständige Wallboard-Übersicht inkl. KPI-Kacheln und Anruf-Chart benötigen, wählen Sie statt des Widgets die Ausdocken-Funktion des Live-Monitors. Für minimalistische, einbettungsfreundliche Live-Anzeigen ist das Group Widget die bessere Wahl.