Dashboard Konfiguration

Personalisierung von Dashboards

Über die Schaltfläche Dashboard anpassen können Agenten die Ansichten in ihren Dashboards und in den Komplexsuchen personalisieren. Dabei können sie Widgets ein- und ausblenden und die in den Dashboard-Tabellen anzuzeigenden Informationen an ihren persönlichen Bedarf anpassen. Diese Ansichten sind nutzergebunden, wirken sich nicht systemweit aus und können bei Bedarf zurückgesetzt werden.

Als Administrator können Sie die Basis für diese Auswahlen schaffen. Diese gilt für alle Agenten gleichermaßen. Über die GUI-Konfiguration können Sie konfigurieren, welche Widgets mit welchen Inhalten allen Agenten standardmäßig zur Verfügung stehen. Und Sie können die in den Dashboard-Tabellen anzuzeigenden Inhalte definieren. Der Agent kann dann für sich festlegen, welche Widgets davon sein persönliches Dashboard enthalten soll und welche Tabellenspalten er davon mit welchen Eigenschaften benötigt.

Die im Dashboard zur Verfügung stehenden Widgets können Sie im SysConfig-Schlüssel des jeweiligen Contexts (home, faq, cmdb usw.) definieren, indem Sie weitere Widgets ins Dashboard integrieren oder enthaltene Widgets entfernen. Die in den Widgets anzuzeigenden Inhalte werden im SysConfig-Schlüssel des jeweiligen Widgets definiert.

Die grundlegende Konfiguration einer Dashboard-Tabelle definieren Sie im Schlüssel der jeweiligen Tabelle. Dort können Sie bspw. weitere Tabellenspalten einfügen, nicht benötigte Tabellenspalten entfernen oder die anzuzeigenden Daten festlegen, indem Sie die Suche in der Tabelle modifizieren.

Dashboard Personalisierung aktivieren

Initial ist das Anpassen des Dashboards für Agenten nur im Home Dashboard möglich. Für die anderen Dashboards sowie für die Komplexsuchen ist diese Möglichkeit deaktiviert. Bei Bedarf können Sie die Dashboard-Personalisierung für jedes Dashboard und jede Komplexsuche aktivieren.

Hinweis

Die Bereitstellung erfolgt für alle Agenten. Es erfolgt keine Differenzierung anhand von Berechtigungen.

Die Aktivierung der Dashboard-Personalisierung erfolgt im SysConfig-Schlüssel des jeweiligen Dashboards bzw. der jeweiligen Komplexsuche (Menü System > GUI Konfiguration > Agentenportal).

Navigieren Sie im Explorer zu System > GUI Konfiguration > Agentenportal.
Suchen und öffnen Sie den entsprechenden SysConfig-Schlüssel (s. Tabelle unten)
Setzen Sie den Parameter customizable auf true.
Speichern Sie Ihre Änderungen mit Speichern.
Klicken Sie in der Übersicht auf Lade Frontend-Konfigurationen neu, um die Ansicht im Frontend zu aktualisieren.

Danach können Agenten die Schaltfläche Dashboard anpassen im entsprechenden Dashboard oder in der Komplexsuche verwenden.

Nachfolgend eine Übersicht der betreffenden Konfigurationsschlüssel:

Dashboard	Konfigurationsschlüssel
Home Dashboard	home
Ticket Dashboard	Ticket Dashboard Configuration
Asset Dashboard	cmdb
Standort Dashboard	CMDBLocation
Organisationen Dashboard	organisations
Serviceverträge	servicecontracts / Service Contract Context
FAQ Dashboard	faq
Berichte Dashboard	reporting
News Dashboard	news

Komplexsuche	Konfigurationsschlüssel
Ticket	Ticket Search
Asset	Config Item Search
Organisation	Organisation Search
Kontakt	Contact Search
FAQ	FAQ Search

Dashboard-Einstellungen eines Nutzers zurücksetzen

Sie können für jeden einzelnen Agenten die in seinen Dashboards und Komplexsuchen vorgenommenen Einstellungen zurücksetzen. Dabei werden alle seine Widgets in allen Dashboards sowie in allen Komplexsuchen zurückgesetzt. Es greifen dann wieder die in den SysConfig-Schlüsseln hinterlegten Konfigurationen.

Das Zurücksetzen einzelner Dashboards oder Komplexsuchen ist aktuell noch nicht möglich.

Wählen Sie dazu unter Nutzerverwaltung > Nutzer den/die entsprechenden Nutzer aus und klicken Sie auf die Schaltfläche Nutzer-Widgets zurücksetzen. In der Detailansicht eines Nutzers können Sie die Widget-Einstellungen ebenfalls zurücksetzen.

Danach findet der Agent seine Dashboards gemäß der Standardkonfiguration vor und kann sie erneut anpassen.

Abb.: Widget-Einstellungen des Nutzers zurücksetzen.

Konfiguration von Dashboard Tabellen

Konfigurationsschlüssel

home-dashboard-ticket-table-new

Sie können die Tabellen im Home- oder Ticketdashboard nach Bedarf anpassen, indem Sie bspw. zusätzliche Tabellenspalten einfügen oder nicht benötigte Tabellenspalten entfernen. Die Anpassung der Tabellen erfolgt über die Konfigurationsschlüssel im Menü System > GUI Konfiguration > Agentenportal.

Im nachfolgenden Beispiel wird die Tabelle Neue Tickets im Home-Dashboard um die Tabellenspalte Kontakt erweitert, in welcher der Name des Kundenkontakts angezeigt wird. Hierfür wird der Konfigurationsschlüssel home-dashboard-ticket-table-new entsprechend geändert. Möchten Sie eine andere Tabelle konfigurieren, wählen Sie bitte den entsprechenden SysConfig-Schlüssel aus und ändern Sie diesen.

Einer Dashboard-Tabelle eine Spalte hinzufügen

Navigieren Sie zum Menü System > SysConfig.
Navigieren Sie im Explorer zu System > GUI Konfiguration > Agentenportal.
Suchen und öffnen Sie den Konfigurationsschlüssel home-dashboard-ticket-table-new
In diesem Konfigurationsschlüssel ist der Aufbau der Tabelle definiert.
Optional: Kopieren Sie den Quellcode im Feld Wert in einen externen JSON-Editor, um ihn besser editieren zu können.
Fügen Sie den nachfolgenden Codeblock unter tableColumns[...] in den Editor ein.
Platzieren Sie ihn an gewünschter Stelle zwischen zwei bereits vorhandene Tabellenspalten. Die Reihenfolge Ihrer Platzierung legt fest, an welcher Stelle in der Tabelle die Spalte eingefügt wird.
Tipp: Jede Tablellenspalte beginnt und endet mit je einer geschweiften Klammer.
Konfigurieren Sie den eingefügten Codeblock nach Bedarf:
- Tragen Sie unter property das Ticketattribut ein, welches in der Tabellenspalte angezeigt werden soll.
  Hier: das Attribut ContactID für den Kundenkontakt.
  Übersicht der Ticketattribute siehe:Ticket-Attribute
- Möchten Sie ein Dynamisches Feld einbinden, verwenden Sie die Syntax: DynamicFields.FieldName.
  Es ist der unter System > Dynamische Felder definierte Name anzugeben.
- Möchten Sie den Fortschrittsbalken eines Dynamischen Feldes vom Typ Checklist in der Tabellenspalte anzeigen, tragen Sie unter componentID den Wert dynamic-field-checklist-cell ein.
- Ist Ihnen der Datentyp des einzubindenden Attributs nicht bekannt, notieren Sie unter dataType den Wert null.
- Eine Übersicht der verwendeten Attribute finden Sie unter: TableColumns Configuration
```
{
    "id": null,
    "name": null,
    "type": null,
    "property": "ContactID", #in der Spalte anzuzeigendes Ticketattribut
    "showText": true,
    "showIcon": false,
    "showColumnTitle": true,
    "showColumnIcon": true,
    "size": 225,
    "sortable": true,
    "filterable": true,
    "hasListFilter": false,
    "dataType": "STRING",
    "resizable": true,
    "componentId": null, # oder Wert für einen Fortschrittsbalken: "dynamic-field-checklist-cell"
    "defaultText": null,
    "translatable": true,
    "titleTranslatable": true,
    "useObjectServiceForFilter": false
},
```
Optional: Minimieren Sie den Quellcode im JSON-Editor und kopieren Sie ihn zurück ins Feld Wert des Konfigurationsschlüssels.
Speichern Sie Ihre Änderungen abschließend mit Speichern.
Klicken Sie im Header der SysConfig auf Lade Frontend-Konfigurationen neu, um die Ansicht im Frontend zu aktualisieren.

Der Name des Kundenkontakts wird nun in der Dashboard-Tabelle angezeigt. Agenten müssen dazu ggf. einen Browser-Refresh vornehmen.

Abb.: Eine zusätzliche Spalte in der Tabelle Neue Tickets im Home Dashboard

Eine Spalte aus einer Dashboard-Tabelle entfernen

Navigieren Sie zum Menü System > SysConfig.
Navigieren Sie zu Menü System > GUI Konfiguration > Agentenportal.
Suchen und öffnen Sie den Konfigurationsschlüssel der Tabelle, die Sie bearbeiten möchten, z. B. home-dashboard-ticket-table-new.
Sie können das Sternchen (*) als Wildcard für die Suche verwenden.
Optional: Kopieren Sie den Quellcode im Feld Wert in einen externen JSON-Editor, um ihn besser editieren zu können.
Entfernen Sie die nicht benötigte Tabellenspalte aus dem Quellcode.
Eine Tabellenspalte beginnt und endet mit je einer geschweiften Klammer.
Klicken Sie abschließend auf Speichern.
Klicken Sie auf Lade Frontend-Konfigurationen neu, um die Ansicht im Frontend zu aktualisieren.

Die Spalte ist nun aus der Tabelle entfernt.

Dem Dashboard ein Widget hinzufügen

Agenten können über die Personalisierung von Dashboards festlegen, welche Widgets in ihrem persönlichen Dashboard angezeigt werden sollen. Sie können den Dashboards individuelle Widgets hinzufügen, die den Agenten dann ebenfalls zur Auswahl stehen. Im nachfolgenden Beispiel wird ein Widget dem Home Dashboard hinzugefügt.

Abb.: Auswahl der im Home-Dashboard anzuzeigenden (Tabellen-)Widgets

So integrieren Sie ein weiteres Widget ins Home-Dashboard:

Navigieren Sie im Explorer zu System > GUI Konfiguration > Agentenportal.
Öffnen Sie den SysConfig-Schlüssel home.
Fügen Sie einen der unten aufgeführten Codeblöcke in den Editor ein.
Platzieren Sie ihn bspw. zwischen 2 bestehende Widgets. Die Einfügeposition bestimmt, wo das Widget standardmäßig im Dashboard angezeigt wird.
Die Position kann vom Agent beim Anpassen des Dashboards individuell verändert werden.
Passen Sie die Beispiele an Ihren Bedarf an, indem Sie die
1. ID und Name des Object-Info-Widgets entsprechend des anzuzeigenden Widgets ändern
2. ID, Name und Parameter der Tabellenkonfiguration entsprechend Ihres Bedarfs anpassen
3. Kommentare aus den Beispielen entfernen.
Speichern Sie Ihre Änderungen mit Speichern.
Klicken Sie in der Übersicht auf Lade Frontend-Konfigurationen neu, um die Ansicht im Frontend zu aktualisieren.

Das Widget ist nun im Dashboard enthalten. Ggf. müssen Agenten ihre Browseranzeige aktualisieren.

gui-konfig_bsp_DashboardWidget-hinzufuege_individuelleDashboardTabelle.png

Abb.: Ein ins Home Dashboard integriertes Tabellen-Widget

Beispiel: Codeblock zum Einfügen eines Objekt-Info-Widgets

{
  "instanceId": "name-des-info-widgets",
  "configurationId": "name-des-info-widgets",
  "configuration": null,
  "permissions": [
    {
      "target": "tickets",
      "permissions": [
        2
      ],
      "OR": false,
      "value": 2
    }
  ],
  "size": "small"
},

Beispiel: Codeblock zum Einfügen eines Tabellenwidgets

{ //Instanz des eigenen Tabellenwidgets anlegen
  "instanceId": "home-dashboard-custom-ticket-list",
  "configurationId": null,
  "configuration": {
    "id": "home-dashboard-custom-ticket-list",
    "name": "Custom Ticket List",
    "type": "Widget",
    "widgetId": "table-widget",
    "title": "Custom Ticket List",
    "actions": [
      "bulk-action",
      "csv-export-action"
    ],
    "subConfigurationDefinition": null,
    "configuration": {
      "id": "home-dashboard-ticket-custom-ticket-table-widget",
      "name": "Custom Tickets Table Widget",
      "type": "TableWidget",
      "objectType": "Ticket",
      "sort": [
        "TicketNumber",
        "Up"
      ],
      "subConfigurationDefinition": null,
      //Tabellenkonfiguration
      "tableConfiguration": {
        "id": "home-dashboard-ticket-table-new",
        "name": "New Tickets Table",
        "type": "Table",
        "objectType": "Ticket",
        //Definition der zu ladenden Inhalte
        "loadingOptions": {
          "filter": [
            {
              "property": "StateType",
              "operator": "EQ",
              "type": "String",
              "filterType": "OR",
              "value": "Open"
            }
          ],
          "limit": 30,
          "includes": [
            "Watchers",
            "DynamicFields"
          ]
        },
        "displayLimit": 10,
        //Definition der Tabellenspalten
        "tableColumns": [
          {
            "id": null,
            "name": null,
            "type": null,
            "property": "PriorityID",
            "showText": false,
            "showIcon": true,
            "showColumnTitle": true,
            "showColumnIcon": false,
            "size": 65,
            "sortable": true,
            "filterable": true,
            "hasListFilter": true,
            "dataType": "STRING",
            "resizable": true,
            "componentId": null,
            "defaultText": null,
            "translatable": true,
            "titleTranslatable": true,
            "useObjectServiceForFilter": false
          },
          {
            "id": null,
            "name": null,
            "type": null,
            "property": "TicketNumber",
            "showText": true,
            "showIcon": false,
            "showColumnTitle": true,
            "showColumnIcon": true,
            "size": 135,
            "sortable": true,
            "filterable": true,
            "hasListFilter": false,
            "dataType": "STRING",
            "resizable": true,
            "componentId": null,
            "defaultText": null,
            "translatable": true,
            "titleTranslatable": true,
            "useObjectServiceForFilter": false
          },
          {
            "id": null,
            "name": null,
            "type": null,
            "property": "Title",
            "showText": true,
            "showIcon": false,
            "showColumnTitle": true,
            "showColumnIcon": true,
            "size": 463,
            "sortable": true,
            "filterable": true,
            "hasListFilter": false,
            "dataType": "STRING",
            "resizable": true,
            "componentId": null,
            "defaultText": null,
            "translatable": true,
            "titleTranslatable": true,
            "useObjectServiceForFilter": false
          },
          {
            "id": null,
            "name": null,
            "type": null,
            "property": "QueueID",
            "showText": true,
            "showIcon": false,
            "showColumnTitle": true,
            "showColumnIcon": true,
            "size": 175,
            "sortable": true,
            "filterable": true,
            "hasListFilter": true,
            "dataType": "STRING",
            "resizable": true,
            "componentId": null,
            "defaultText": null,
            "translatable": true,
            "titleTranslatable": true,
            "useObjectServiceForFilter": false
          },
          {
            "id": null,
            "name": null,
            "type": null,
            "property": "DynamicFields.AffectedAsset",
            "showText": true,
            "showIcon": false,
            "showColumnTitle": true,
            "showColumnIcon": false,
            "size": 200,
            "sortable": true,
            "filterable": true,
            "hasListFilter": true,
            "dataType": "STRING",
            "resizable": true,
            "componentId": "label-list-cell-content",
            "defaultText": null,
            "translatable": true,
            "titleTranslatable": true,
            "useObjectServiceForFilter": false
          }
        ],
        "tableColumnConfigurations": null,
        "enableSelection": true,
        "toggle": true,
        "toggleOptions": {
          "componentId": "ticket-article-details",
          "inputPropertyName": "article",
          "actions": [],
          "toggleFirst": true,
          "data": {},
          "toggleAll": false
        },
        "headerHeight": 2.25,
        "rowHeight": 1.75,
        "emptyResultHint": "Translatable#No tickets available.",
        "fixedFirstColumn": false
      },
      "headerComponents": null,
      "showFilter": true,
      "shortTable": false,
      "predefinedTableFilters": [],
      "cache": false,
      "resetFilterOnReload": true
    },
    "minimized": false,
    "minimizable": true,
    "icon": "kix-icon-ticket",
    "contextDependent": false
  },
  "permissions": [
    {
      "target": "tickets",
      "permissions": [
        2
      ],
      "OR": false,
      "value": 2
    }
  ],
  "size": "large"
}

Komplett-Beispiel: Home-Dashboard mit zusätzlichem Tabellenwidget "home-dashboard-custom-ticket-list"

{
  "id": "home",
  "name": "home",
  "type": "Context",
  "contextId": "home",
  "sidebars": [
    {
      "instanceId": "home-dashboard-notes-widget",
      "configurationId": "home-dashboard-notes-widget",
      "permissions": [],
      "size": "large"
    }
  ],
  "explorer": [],
  "lanes": [],
  "content": [
    {
      "instanceId": "home-dashboard-ticket-chart-widget-priorities",
      "configurationId": "home-dashboard-ticket-chart-widget-priorities",
      "configuration": null,
      "permissions": [
        {
          "target": "tickets",
          "permissions": [
            2
          ],
          "OR": false,
          "value": 2
        }
      ],
      "size": "small"
    },
    {
      "instanceId": "home-dashboard-ticket-chart-widget-states",
      "configurationId": "home-dashboard-ticket-chart-widget-states",
      "configuration": null,
      "permissions": [
        {
          "target": "tickets",
          "permissions": [
            2
          ],
          "OR": false,
          "value": 2
        }
      ],
      "size": "small"
    },
    {
      "instanceId": "home-dashboard-ticket-chart-widget-new",
      "configurationId": "home-dashboard-ticket-chart-widget-new",
      "configuration": null,
      "permissions": [
        {
          "target": "tickets",
          "permissions": [
            2
          ],
          "OR": false,
          "value": 2
        }
      ],
      "size": "small"
    },
    { //eigenes Tabellenwidget
      "instanceId": "home-dashboard-custom-ticket-list",
      "configurationId": null,
      "configuration": {
        "id": "home-dashboard-custom-ticket-list",
        "name": "Custom Ticket List",
        "type": "Widget",
        "widgetId": "table-widget",
        "title": "Custom Ticket List",
        "actions": [
          "bulk-action",
          "csv-export-action"
        ],
        "subConfigurationDefinition": null,
        "configuration": {
          "id": "home-dashboard-ticket-custom-ticket-table-widget",
          "name": "Custom Tickets Table Widget",
          "type": "TableWidget",
          "objectType": "Ticket",
          "sort": [
            "TicketNumber",
            "Up"
          ],
          "subConfigurationDefinition": null,
          "tableConfiguration": {
            "id": "home-dashboard-ticket-table-new",
            "name": "New Tickets Table",
            "type": "Table",
            "objectType": "Ticket",
            "loadingOptions": {
              "filter": [
                {
                  "property": "StateType",
                  "operator": "EQ",
                  "type": "String",
                  "filterType": "OR",
                  "value": "Open"
                }
              ],
              "limit": 30,
              "includes": [
                "Watchers",
                "DynamicFields"
              ]
            },
            "displayLimit": 10,
            "tableColumns": [
              {
                "id": null,
                "name": null,
                "type": null,
                "property": "PriorityID",
                "showText": false,
                "showIcon": true,
                "showColumnTitle": true,
                "showColumnIcon": false,
                "size": 65,
                "sortable": true,
                "filterable": true,
                "hasListFilter": true,
                "dataType": "STRING",
                "resizable": true,
                "componentId": null,
                "defaultText": null,
                "translatable": true,
                "titleTranslatable": true,
                "useObjectServiceForFilter": false
              },
              {
                "id": null,
                "name": null,
                "type": null,
                "property": "TicketNumber",
                "showText": true,
                "showIcon": false,
                "showColumnTitle": true,
                "showColumnIcon": true,
                "size": 135,
                "sortable": true,
                "filterable": true,
                "hasListFilter": false,
                "dataType": "STRING",
                "resizable": true,
                "componentId": null,
                "defaultText": null,
                "translatable": true,
                "titleTranslatable": true,
                "useObjectServiceForFilter": false
              },
              {
                "id": null,
                "name": null,
                "type": null,
                "property": "Title",
                "showText": true,
                "showIcon": false,
                "showColumnTitle": true,
                "showColumnIcon": true,
                "size": 463,
                "sortable": true,
                "filterable": true,
                "hasListFilter": false,
                "dataType": "STRING",
                "resizable": true,
                "componentId": null,
                "defaultText": null,
                "translatable": true,
                "titleTranslatable": true,
                "useObjectServiceForFilter": false
              },
              {
                "id": null,
                "name": null,
                "type": null,
                "property": "QueueID",
                "showText": true,
                "showIcon": false,
                "showColumnTitle": true,
                "showColumnIcon": true,
                "size": 175,
                "sortable": true,
                "filterable": true,
                "hasListFilter": true,
                "dataType": "STRING",
                "resizable": true,
                "componentId": null,
                "defaultText": null,
                "translatable": true,
                "titleTranslatable": true,
                "useObjectServiceForFilter": false
              },
              {
                "id": null,
                "name": null,
                "type": null,
                "property": "DynamicFields.AffectedAsset",
                "showText": true,
                "showIcon": false,
                "showColumnTitle": true,
                "showColumnIcon": false,
                "size": 200,
                "sortable": true,
                "filterable": true,
                "hasListFilter": true,
                "dataType": "STRING",
                "resizable": true,
                "componentId": "label-list-cell-content",
                "defaultText": null,
                "translatable": true,
                "titleTranslatable": true,
                "useObjectServiceForFilter": false
              }
            ],
            "tableColumnConfigurations": null,
            "enableSelection": true,
            "toggle": true,
            "toggleOptions": {
              "componentId": "ticket-article-details",
              "inputPropertyName": "article",
              "actions": [],
              "toggleFirst": true,
              "data": {},
              "toggleAll": false
            },
            "headerHeight": 2.25,
            "rowHeight": 1.75,
            "emptyResultHint": "Translatable#No tickets available.",
            "fixedFirstColumn": false
          },
          "headerComponents": null,
          "showFilter": true,
          "shortTable": false,
          "predefinedTableFilters": [],
          "cache": false,
          "resetFilterOnReload": true
        },
        "minimized": false,
        "minimizable": true,
        "icon": "kix-icon-ticket",
        "contextDependent": false
      },
      "permissions": [
        {
          "target": "tickets",
          "permissions": [
            2
          ],
          "OR": false,
          "value": 2
        }
      ],
      "size": "large"
    },
    {
      "instanceId": "home-dashboard-myOpenTickets-widget",
      "configurationId": "home-dashboard-myOpenTickets-widget",
      "configuration": null,
      "permissions": [
        {
          "target": "tickets",
          "permissions": [
            2
          ],
          "OR": false,
          "value": 2
        }
      ],
      "size": "large"
    },
    {
      "instanceId": "home-dashboard-new-tickets-widget",
      "configurationId": "home-dashboard-new-tickets-widget",
      "configuration": null,
      "permissions": [
        {
          "target": "tickets",
          "permissions": [
            2
          ],
          "OR": false,
          "value": 2
        }
      ],
      "size": "large"
    }
  ],
  "generalActions": [],
  "actions": [],
  "overlays": [],
  "others": [],
  "dialogs": [],
  "customizable": true
}

In diesem Abschnitt: