Konfiguration der Teamansichtsmodi
Konfigurationsschlüssel | tickets |
Im Ticket Dashboard werden die Tickets sortiert nach Teams angezeigt. Agenten in KIX Pro können hier zwischen verschiedenen Ansichtsmodi wählen:
Listenansicht
Kanban-Ansicht
Kalender-Ansicht
Landkarte

Abb.: Teamansichtsmodi im Ticket Dashboard
Als Administrator können Sie die Bereitstellung der Ansichtsmodi de-/aktivieren und deren Inhalte konfigurieren. Dies erfolgt im SysConfig-Schlüssel
:Abschnitt
content[...]
: enthält die in der Listenansicht angezeigten WidgetsAbschnitt
others[]
: enthält die Konfigurationsblöcke für die Kanban-, Kalender- und Karten- Ansicht sowie den Konfigurationsblock zum de-/aktivieren der Ansichtsmodi.

Abb.: Konfigurationsblöcke der Teamansichtsmodi
Hinweis
Klicken Sie nach dem Speichern Ihrer Änderungen am Konfigurationsschlüssel auf
.Sie können die Bereitstellung der Teamansichtsmodi global via SysConfig steuern. Nicht benötigte Teamansichtsmodi können somit deaktiviert und bei Bedarf wieder aktiviert werden. Die Schaltflächen deaktivierter Teamansichtsmodi sind ausgeblendet und können somit nicht ausgewählt werden.

Abb.: Bereitstellung Teamansichtsmodi (alle und teilweise)
Der Abschnitt ticket-views
im Codeblock others[...]
enthält den Parameter widgets
. Hier können Sie für jeden Ansichtsmodus festlegen, ob dieser zur Verfügung steht. Setzen Sie dazu den Parameter valid
auf true
oder false
.

Abb.: De-/aktivierung Teamansichtsmodi im SysConfig-Schlüssel
Die Listen-Ansicht ist die Standardansicht im Ticket Dashboard. Hier sind die Tickets in einer Tabelle aufgelistet.

Abb.: Ansicht im Modus "Liste"
Im Abschnitt content[..]
sind die Chart- Widgets und Tickettabelle eingebunden. Deren Inhalte können Sie im SysConfig-Schlüssel des jeweiligen Widgets (s. Parameter instanceID
) konfigurieren. Näheres dazu finden Sie unter:
Die Kanban-Ansicht ermöglicht eine visuelle Trennung der Tickets nach Bearbeitungsstatus . Die Tickets werden als einzelne Karten dargestellt, welche von Ihnen per Drag & Drop in eine andere Spalte des Kanban-Boards verschoben werden können. Der Bearbeitungsstatus des Tickets ändert sich dabei automatisch.

Abb.: Ansicht im Modus "Kanban"
Die Karten zeigen verschiedene, konfigurierbare Ticketinformationen an. Als Administrator können Sie festlegen, welche Ticketinformationen in den Karten angezeigt werden sollen. Die Konfiguration der Karteninhalte erfolgt im Abschnitt others[...]
im Konfigurationsblock {"instanceID": "kanban"...}
.
Parameter | Beschreibung | Werte |
---|---|---|
cardProperties | Ticketeigenschaften, die im Overlay des Ticketmarkers angezeigt werden sollen. Sie können nicht benötigte Informationen aus der Karte entfernen bzw. weitere Ticketinformationen hinzufügen, z. B. den geplanten Zeitaufwand oder andere Dynamische Felder. | Default: "ContactID", "StateID", "QueueID", "ResponsibleID", "Changed" Beispiel: "ContactID", "StateID", "ResponsibleID", "DynamicFields.PlannedEffort", "Dyna micFields.DFxyz" |
columns | Spalten des Kanbanboards Default: Team Backlog, In Bearbeitung (WIP), Wartend Sie können dem Kanban-Board weitere Spalten hinzufügen und den Status ändern. id: Definiert je eine Spalte im Kanban-Board. Möglich sind:
dropState: Definiert den Status, den das Ticket erhalten soll, wenn das Ticket in die entsprechende Spalte verschoben wird. Möglich sind alle im System angelegten Status (Menü ). | "columns": [ { "id": "team-backlog", "dropState": "new" }, { "id": "wip", "dropState": "open" }, { "id": "pending", "dropState": "pending reminder" } ] |
In der Kalender-Ansicht werden die Tickets entsprechend ihres Fälligkeitsdatums angezeigt. Wenn Sie ein Ticket im Kalender anklicken, öffnet sich ein Overlay mit einer Karte, welche detaillierte Informationen zum Ticket enthält.
Für die Anzeige der Tickets im Kalender werden standardmäßig die unter Plan Beginn und Plan Ende hinterlegten Datumsangaben genutzt.

Abb.: Ansicht im Modus "Kalender"
Sie können den Karteninhalt des Overlays konfigurieren. Die Konfiguration erfolgt im Abschnitt others[...]
im Konfigurationsblock {"instanceID": "calendar"...}
.
Parameter | Beschreibung | Beispiel |
---|---|---|
properties | Ticketeigenschaften, welche im Karteninhalt (Overlay) angezeigt werden sollen. Sie können nicht benötigte Informationen der Karte entfernen bzw. weitere Ticketinformationen hinzufügen, z. B. den geplanten Zeitaufwand oder eigene Dynamische Felder. | "properties": [ "ContactID", "StateID", "QueueID", "DynamicFields.PlanBegin", "DynamicFields.PlanEnd", "DynamicFields.PlannedEffort", "DynamicFields.DFxyz" ] |
Die Kartenansicht visualisiert die Einsatzorte für Tickets sowie die aktuelle Position der Agenten. Sie ermöglicht damit die Planung und Steuerung von Außeneinsätzen. Eingehende Meldungen/Tickets können so direkt an den Servicemitarbeiter gegeben werden, welcher sich in der Nähe des Einsatzortes befindet. Dadurch werden effektive Reaktionszeiten verkürzt und Fahrtzeiten reduziert.
Ändern sich die Daten bspw. bei Positionsänderung des Agenten, wird die Karte automatisch aktualisiert. Dazu muss der Agent die Field Agent App mit eingeschaltetem Geo-Tracking auf seinem Mobilgerät verwenden.

Abb.: Ansicht im Modus "Karte"
Die Karte verwendet Open Street Maps zur Darstellung. Als Geodaten-Provider zum Auflösen von Adressangaben in Geo-Koordinaten wird https://nominatim.org verwendet. Die vorgegebenen Grundlagen sind:
für die Darstellung eines Tickets in der Karte: die Adressdaten der am jeweiligen Ticket hinterlegten Organisation.
für die Darstellung der Agentenposition: die Adresse des Agentennutzers.
Die Adressdaten sind in der Konfiguration als KIX Platzhalter angegeben. Sie haben dadurch die Möglichkeit, auch alternative Quellen für Adressdaten wie bspw. Dynamische Felder, Adresse des Agentennutzers, o. ä. zu verwenden. Soll bspw. die Anschrift eines Assets verwendet werden, kann diese mittels eines Automatisierungsjobs und der Macro Action "Asset Attribute abrufen" in ein Dynamisches Feld ins Ticket gesetzt werden. In der Kartenkonfiguration können Sie dann via Platzhalter auf dieses Dynamische Feld referenzieren.
Beschränkung des Vorgabe-Geodaten-Providers
Die Auflösung von Geodaten bei Verwendung eines nominatim.org-Services ist auf eine maximale Anzahl von Requests pro Zeiteinheit und IP-Adresse begrenzt (siehe https://operations.osmfoundation.org/policies/nominatim/).
Ein produktiver Einsatz wird nicht empfohlen. Es besteht das Risiko einer zeitweisen Sperre für Adressanfragen wodurch die Kartenfunktion nicht mehr zur Verfügung steht. Wir empfehlen die Verwendung eines alternativen Geodatenproviders wie https://opencagedata.com.
Die Konfiguration der Geo-Positionen erfolgt im Abschnitt others[...]
im Konfigurationsblock {"instanceID": "maps"...}
.
Parameter | Beschreibung | Werte |
---|---|---|
initialCoordinates | Initiale Koordinationsdaten, mit der die Karte geladen wird. |
|
initialZoom | Initiale Zoomstufe, mit der die Karte geladen wird. |
|
addressDefinition | Definiert einen Adress-String für die Ticketmarker Aufgrund dieser Informationen wird der Ort des Tickets in der Karte angezeigt. |
|
layerGroups | Wird aktuell noch nicht unterstützt. Aktuell werden nur Layer für Ticket Owner unterstützt. | "OrganisationID", "OwnerID" |
markerProperties | Ticketeigenschaften, die im Overlay des Ticketmarkers angezeigt werden sollen. Sie können dem Overlay weitere Ticketinformationen hinzufügen bzw. nicht benötigte Informationen entfernen, z. B. den geplanten Zeitaufwand oder andere Dynamische Felder. |
|
geoDataProvider | Angabe eines alternativen Geodatenservers für KIX Cloud Instanzen, zur Auflösung von Adressdaten und der Darstellung von Einsatzorten (Tickets) und Agentenpositionen in der Kartendarstellung. Zum Beispiel: https://opencagedata.com
| "geoDataProvider": { "url": "https://api.opencagedata.com/geocode/v1/json?q=&key=YOUR_API_TOKEN_HERE", "latProperty": ["results", "0", "geometry", "lat"], "lonProperty": ["results", "0", "geometry", "lng"], "useTimeout": true } |
geoPositonTTL | Ablaufzeit des Positionsdaten (in Minuten) Die Field Agent App meldet die Geopositionen mit einem Zeitstempel. Hier definieren Sie, nach wieviel Minuten der Zeitstempel als "abgelaufen" gilt und die Positionsdaten verfallen. Die Position des Agenten wird in der Karte angezeigt, solange der Zeitstempel noch nicht abgelaufen ist. Ändert der Agent seine Position, wird diese inkl. eines neuen Zeitstempels übermittelt. Grundlage für die Meldung der Positionsänderung sind die Angaben in den Konfigurationsschlüssen (s. Aktualisierung von Geopositionsdaten). Nach Ablauf des Zeitstempels resultiert die Agentenposition aus dessen Adresse anhand seiner hinterlegten Kontakt- oder Organisationsdaten. | Default: "geoPositionTTL": 480 |
Tipp
Können Geopositionsdaten nicht aufgelöst werden oder liefert der Geodaten-Provider einen Fehler, können Sie über die Browser-Konsole nach den Gründen recherchieren (Taste F12 - Entwicklerwerkzeuge). Sie erhalten dort einen einen entsprechenden Log-Eintrag.
Aktualisierung von Geopositionsdaten
Nutzt ein Servicemitarbeiter die Field Agent App, so kann die App die Geopositionsdaten des mobilen Geräts an das Agentenportal übermitteln. KIX kann anhand der übertragenen Positionsdaten die Agentenposition in der Map-Ansicht des Homedashboards darstellen.
Sie können das Sendeverhalten der App im Menü
steuern. Dies erfolgt in folgenden Konfigurationsschlüsseln:Legt fest, ab welcher Positionsänderung die App die neue Position sendet (Entfernung in Metern).
Werte:
Natürliche Zahlen > 0
Bei ungültigen Eingaben wird der Standardwert verwendet
Default: 1000
Legt fest, ob die Meldung der Position nach erstmaliger Anmeldung des Nutzers an der App aktiv oder inaktiv ist.
Für die weitere Nutzung gelten die Einstellungen in der App.
Mögliche Werte:
aktiv
inaktiv (Default)