Skip to main content

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:

  • teamansicht_liste.png Listenansicht

  • kanban_board.png Kanban-Ansicht

  • teamansicht_kalender.png Kalender-Ansicht

  • teamansicht_maps.png Landkarte

Teamansichtsmodi.png

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 tickets:

  • Abschnitt content[...]: enthält die in der Listenansicht angezeigten Widgets

  • Abschnitt others[]: enthält die Konfigurationsblöcke für die Kanban-, Kalender- und Karten- Ansicht sowie den Konfigurationsblock zum de-/aktivieren der Ansichtsmodi.

Teamansichtsmodi_SysConfigKey.png

Abb.: Konfigurationsblöcke der Teamansichtsmodi

Hinweis

Klicken Sie nach dem Speichern Ihrer Änderungen am Konfigurationsschlüssel auf Lade Frontend-Konfigurationen neu.

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.

Teamansichtsmodi_de-aktivieren.png

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.

Teamansichtsmodi_de-aktivieren_SysConfig.png

Abb.: De-/aktivierung Teamansichtsmodi im SysConfig-Schlüssel tickets

SF-Teamansichtsmodus_Liste.png Die Listen-Ansicht ist die Standardansicht im Ticket Dashboard. Hier sind die Tickets in einer Tabelle aufgelistet.

Teamansichtsmodus_Liste.png

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:

teamansicht_kanban.png 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.

Teamansichtsmodus_Kanban.png

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:

  • team-backlog (Team Backlog)

  • wip (In Bearbeitung)

  • pending (Wartend)

  • closed (kürzlich geschlossen)

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ü Ticket > Status).

"columns": [
   {
      "id": "team-backlog",
      "dropState": "new"
   },
   {
      "id": "wip",
      "dropState": "open"
   },
   {
      "id": "pending",
      "dropState": "pending reminder"
   }
]

teamansicht_kalender.png 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.

Teamansichtsmoudus_Kalender2.png

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"
]

Teamansichtsmodus_Maps.png 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.

Teamansichtsmoudus_Karte2.png

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.

  • Default: 51.324572, 10.519871(Mitte von Deutschland)

  • Beispiel: 49.939680368625325, 10.314198730887163 (Europa)

initialZoom

Initiale Zoomstufe, mit der die Karte geladen wird.

  • Default: 6

  • Beispiel: 5

addressDefinition

Definiert einen Adress-String für die Ticketmarker

Aufgrund dieser Informationen wird der Ort des Tickets in der Karte angezeigt.

  • Default: Adresse der am Ticket gesetzten Organisation:

    <KIX_ORG_Street>, <KIX_ORG_Zip>, <KIX_ORG_City>"

  • Beispiel Alternative: <KIX_TICKET_DynamicField_Einsatzort>

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.

  • Default: "ContactID", "StateID", "QueueID", "ResponsibleID", "Changed"

  • Beispiel: "ContactID", "StateID", "ResponsibleID", "DynamicField.PlannedEffort", "DynamicField.DFxyz"

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

  • url: URL der API mit Platzhalter <SEARCH_VALUE>, in welchem der definierte Adress-String eingesetzt wird

  • latProperty: Array, das den Property-Pfad zu Latitude- Eigenschaft in der Antwort des Geo- Daten-Provides beschreibt.

  • lonProperty: Array, das den Property-Pfad zu Latitude- Eigenschaft in der Antwort des Geo- Daten-Provides beschreibt.

  • useTimeout: true , wenn nur 1 Anfrage pro Sekunde an den Geodaten-Provider gesendet werden soll.

"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ü System > SysConfig 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)