Das Chart-Widget
Konfigurationsschlüssel | home |
Chart-Widgets können Statistiken grafisch darstellen. Die Darstellung kann als Balken-, Torten- oder Liniendiagramm erfolgen.
Abb.: Die initialen Chart-Widgets im Home Dashboard
Als Datenbasis für das Chart-Widget dient eine Berichtsdefinition. Deren zuletzt erstellter Bericht wird in der Statistik angezeigt. Voraussetzung dafür ist, dass in der Berichtsdefinition als Ausgabeformat CSV festgelegt ist. In KIX Pro ist auch JSON möglich. Andere Ausgabeformate können vom Chart-Widget nicht verarbeitet werden.
Das periodische Erstellen der Berichte und damit die Aktualisierung der Statistiken erfolgt durch den initialen Job Periodic Reports. Auf diese Weise werden auch die Charts im Home Dashboard erzeugt.
Die Statistik wird nicht angezeigt, wenn der Bericht nicht ausgewertet werden kann. Der Inhalt im Widget ist dann leer. Es wird lediglich der Hinweis "No report available" angezeigt. Gründe dafür können sein:
Es existiert kein Bericht zur gewählten Berichtsdefinition
Die Berechtigungen für den Bericht fehlen
Die Berichtsdaten konnten nicht ausgewertet werden
Der Bericht liegt nicht im CSV-Format (oder JSON) vor
Die initialen Chart-Widgets sind in die Konfiguration des Home Dashboards eingebettet (SysConfig-Schlüssel Home). Sie befinden sich innerhalb des Konfigurationsblocks "content:[...]".
Jedes Chart-Widget besteht aus einem Widget-Rahmen und der Widget-Konfiguration, welche wiederum die Konfiguration des Chart-Widgets nebst Angaben zur Datenbasis (Berichtsdefinition) und zur Formatierung des Charts (CSV Mapping) beinhaltet.
Abb.: Konfiguration des Chart-Widgets Anzahl offener Tickets nach Prioritäten im Konfigurationsschlüssel des Home Dashboards
Die Konfiguration des Chart-Widgets benötigt folgende Parameter:
Abb.: Konfigurationsparameter im Chart-Widget
Parameter | Beschreibung |
|---|---|
reportDefinitionID | Die ID der Berichtsdefinition (Datenbasis des Charts) Das Ändern der ID ist nicht erforderlich, um auf einen anderen Bericht zu verweisen. Alle vom Chart-Widget lesbaren Berichte können in der Personalisierung des Dashboards ausgewählt werden. |
reportOutputFormat | Das Ausgabeformat des zu verwendenden Berichts gemäß Berichtsdefinition. |
useReportTitle | Verwendung des Namens der Berichtsdefinition als Widget-Titel, sonst Titel aus Widget-Konfiguration |
formatConfiguration | Spezifische Konfiguration für das Ausgabeformat Die Angaben erfordern detaillierte Kenntnisse der Berichtsdefinition (z. B. Ergebnis des Berichts, welche Daten in welcher Form enthalten sind). Nachfolgend für CSV:
|
Tipp
Die Parameter (Attribute) der Widget-Konfiguration finden Sie unter: Allgemeine Widget-Attribute
Die Chart-Konfiguration definiert die Darstellung des Charts. Nachfolgend aufgeführt sind die initial verwendeten Konfigurationsparameter. Weitere Parameter finden Sie auf unter: https://www.chartjs.org/docs/latest/configuration/.
Abb.: Parameter der Chart Konfiguration
Parameter | Beschreibung |
|---|---|
type | Festlegung des Diagrammtyps
|
options | Enthält Optionen zur Anzeige der Legende im Widget und zur Skalierung der X/Y-Achsen. Weitere Parameter sind möglich.
|
Konfigurationsschlüssel | default-color-configuration |
Sie können die in den Diagrammen verwendeten Farben individuell festlegen, um sie bswp. an Ihre Corporate Identity oder an die Farben der Ticketpriorität anzupassen.
Öffnen Sie dazu den oben erwähnten Konfigurationsschlüssel. Ändern Sie die Farbangaben nach Bedarf und/oder reduzieren Sie die verwendeten Farben. Sie können die Farben als Hexadezimalzahlen (#8D23A8) oder die CSS-Farbnamen ( z. B.: lightcoral) angeben.
Die Verwendung von Farben wird in der angegebenen Reihenfolge von oben nach unten priorisiert.
Abb.: Geänderte Farbangaben für Charts
Die Anzeige und Darstellung der Chart-Widgets kann jeder Agent für sich selbst über die Personalisierung des Home Dashboards festlegen. Nach Klick auf stehen sowohl die Konfigurationsparameter für das Widget als auch die für das Chart zur Verfügung (s. auch: Personalisieren von Dashboards)
Abb.: Konfigurationsparameter des Widgets mit Auswahl der Berichtsdefinition als Datenbasis für das Chart
Abb.: Die Konfiguration der Darstellung des Charts
Sie können eigene Berichte erstellen und als Statistik in einem Chart-Widget bereitstellen. Konfigurieren Sie dazu eine Berichtsdefinition mit Ausgabeformat CSV.
Soll der Bericht in regelmäßigen Zeitabständen automatisch erstellt und aktualisiert werden, aktivieren Sie in der Berichtsdefinition die Checkbox Periodische Erstellung.
Initial erfolgt die Erstellung periodischer Berichte durch den Job Periodic Reports. Alternativ können Sie einen eigenen Job dafür anlegen.
Ist die Checkbox nicht aktiviert, muss der Bericht manuell oder durch einen anderen event- oder zeitbasierten Job erzeugt und aktualisiert werden.
Geben Sie in der Berichtsdefinition unter Max. Reports an, wie viele Berichte vorgehalten werden sollen. Dadurch werden überzählige, ältere Berichte automatisch gelöscht.
Welcher Bericht in welchem Chart-Widget angezeigt wird und wie die grafische Darstellung erfolgt, ist in der Konfiguration des jeweiligen Widgets definiert.
Über die Personalisierung des Home Dashboards können Agenten die initialen Chart-Widgets individuell anpassen. Jeder Agent kann für sich festlegen, welchen Bericht er als Statistik angezeigt bekommen möchte und wie die Darstellung erfolgen soll.
Somit müssen Sie lediglich eine oder mehrere Berichtsdefinition(en) mit Ausgabeformat CSV oder JSON und möglichst periodischer Erstellung anlegen, damit Agenten den Bericht als Statistik im Home Dashboard auswählen können.