Skip to main content

Konfiguration der Teamansichtsmodi

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.

De-/aktivieren von Teamansichtsmodi

Sie können die Bereitstellung der Teamansichtsmodi global steuern. Nicht benötigte Teamansichtsmodi können Sie deaktivieren und bei Bedarf wieder aktivieren. Die Schaltflächen deaktivierter Teamansichtsmodi sind ausgeblendet und stehen den Agenten somit nicht zur Verfügung.

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.

  1. Navigieren Sie im Explorer des Admin Moduls zu System → GUI Konfiguration → Agentenportal.

  2. Suchen und öffnen Sie den Konfigurationsschlüssel tickets (Ticket Dashboard Configuration)

    Der Schlüssel enthält die Konfiguration des Ticket Dashboards.

  3. Navigieren Sie im Code zum Abschnitt others[].

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

    Ansicht des Konfigurationsschlüssel "tickets" für die Konfiguration der Teamansichtsmodi. Markiert ist der Codeabschnitt "others". In diesem Abschnitt werden die einzelnen Modi konfiguriert.

    Abb.: Konfigurationsblöcke der Teamansichtsmodi

  4. Navigieren Sie zum Codeabschnitt "instanceId":"ticket-views".

    In diesem Abschnitt können Sie die einzelnen Ansichtsmodi de-/aktivieren.

    Codeabschnitt "ticket-views" im Konfigurationsschlüssel Konfigurationsschlüssel "tickets". Markiert sind die einzelnen Abschnitte zum de-/aktivieren der Ansichtsmodi

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

  5. De-/aktivieren Sie die Ansichtsmodi nach Bedarf.

    Setzen Sie dazu den Parameter valid auf true (aktiviert) oder false (deaktiviert).

    • ticket-view-list:Konfiguration der Landkarten-Ansicht
    • ticket-view-kanban:Konfiguration der Kanban-Ansicht
    • ticket-view-calendar:Konfiguration der Kalenderansicht
    • ticket-view-maps:Konfiguration der Listenansicht

  6. Speichern Sie Ihre Änderungen mit Klick auf Speichern.

  7. Klicken Sie auf Lade Frontend-Konfigurationen neu, um die Ansicht im Frontend zu aktualisieren.

Danach sind die Teamansichtsmodi für alle Agenten aktiviert bzw. deaktiviert.

Listenansicht konfigurieren

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"

Die Listen-Ansicht ist fest im System implementiert. Anpassungen sind nur begrenzt möglich. Siehe auch:

Kanban-Ansicht konfigurieren

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"...}.

  1. Navigieren Sie im Explorer des Admin Moduls zu System → GUI Konfiguration → Agentenportal.

  2. Suchen und öffnen Sie den Konfigurationsschlüssel tickets (Ticket Dashboard Configuration)

    Der Schlüssel enthält die Konfiguration des Ticket Dashboards.

  3. Navigieren Sie im Code zum Abschnitt others[].

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

    Ansicht des Konfigurationsschlüssel "tickets" für die Konfiguration der Teamansichtsmodi. Markiert ist der Codeabschnitt "others". In diesem Abschnitt werden die einzelnen Modi konfiguriert.

    Abb.: Konfigurationsblöcke der Teamansichtsmodi

  4. Navigieren Sie zum Codeabschnitt "instanceId":"kanban".

    In diesem Abschnitt können Sie Einstellungen für die Kanban-Ansicht konfigurieren.

  5. Im Parameter cardProperties[...] können Sie festlegen, welche Ticketeigenschaften im Overlay des Ticketmarkers 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.

    Standard:"ContactID", "StateID", "QueueID", "ResponsibleID", "Changed"
    Beispiel:"ContactID", "StateID", "ResponsibleID", "DynamicFields.PlannedEffort", "Dyna micFields.DFxyz"

  6. Im Parameter columns[...] können Sie die Spalten des Kanban-Boards festlegen.

    Sie können dem Kanban-Board weitere Spalten hinzufügen und den Status ändern.

    Jede id definiert eine Spalte im Kanban-Board. Möglich sind:

    • team-backlog (Team Backlog)

    • wip (In Bearbeitung)

    • pending (Wartend)

    • closed (kürzlich geschlossen)

    Der Parameter 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).

    Beispiel: 

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

  7. Speichern Sie Ihre Änderungen mit Klick auf Speichern.

  8. Klicken Sie auf Lade Frontend-Konfigurationen neu, um die Ansicht im Frontend zu aktualisieren.

Danach sind Ihre Anpassungen global wirksam.

Kalender-Ansicht konfigurieren

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.

  1. Navigieren Sie im Explorer des Admin Moduls zu System → GUI Konfiguration → Agentenportal.

  2. Suchen und öffnen Sie den Konfigurationsschlüssel tickets (Ticket Dashboard Configuration)

    Der Schlüssel enthält die Konfiguration des Ticket Dashboards.

  3. Navigieren Sie im Code zum Abschnitt others[].

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

    Ansicht des Konfigurationsschlüssel "tickets" für die Konfiguration der Teamansichtsmodi. Markiert ist der Codeabschnitt "others". In diesem Abschnitt werden die einzelnen Modi konfiguriert.

    Abb.: Konfigurationsblöcke der Teamansichtsmodi

  4. Navigieren Sie zum Codeabschnitt "instanceId":"calendar".

    In diesem Abschnitt können Sie Einstellungen für die Kalenderansicht konfigurieren.

  5. Im Parameter properties:[...] können Sie festlegen, welche Ticketeigenschaften 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.

    Beispiel: 

    "properties": [
   "ContactID",
   "StateID",
   "QueueID",
   "DynamicFields.PlanBegin",
   "DynamicFields.PlanEnd",
   "DynamicFields.PlannedEffort",
   "DynamicFields.DFxyz"
]

  6. Speichern Sie Ihre Änderungen mit Klick auf Speichern.

  7. Klicken Sie auf Lade Frontend-Konfigurationen neu, um die Ansicht im Frontend zu aktualisieren.

Danach sind Ihre Anpassungen global wirksam.

Kartenansicht konfigurieren

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"...}.

  1. Navigieren Sie im Explorer des Admin Moduls zu System → GUI Konfiguration → Agentenportal.

  2. Suchen und öffnen Sie den Konfigurationsschlüssel tickets (Ticket Dashboard Configuration)

    Der Schlüssel enthält die Konfiguration des Ticket Dashboards.

  3. Navigieren Sie im Code zum Abschnitt others[].

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

    Ansicht des Konfigurationsschlüssel "tickets" für die Konfiguration der Teamansichtsmodi. Markiert ist der Codeabschnitt "others". In diesem Abschnitt werden die einzelnen Modi konfiguriert.

    Abb.: Konfigurationsblöcke der Teamansichtsmodi

  4. Navigieren Sie zum Codeabschnitt "instanceId":"maps".

    In diesem Abschnitt können Sie Einstellungen für die Karten-Ansicht konfigurieren.

  5. Ändern Sie die Parameter nach Bedarf.

  6. Speichern Sie Ihre Änderungen mit Klick auf Speichern.

  7. Klicken Sie auf Lade Frontend-Konfigurationen neu, um die Ansicht im Frontend zu aktualisieren.

Danach sind Ihre Anpassungen global wirksam.

Parameter

Beschreibung

Werte

initialCoordinates

Initiale Koordinationsdaten, mit der die Karte geladen wird.

Standard:51.324572, 10.519871(Mitte von Deutschland)
Beispiel:49.939680368625325, 10.314198730887163 (Europa)

initialZoom

Initiale Zoomstufe, mit der die Karte geladen wird.

Standard:6
Beispiel:5

addressDefinition

Definiert einen Adress-String für die Ticketmarker

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

Standard: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 vollständig unterstützt.

Aktuell werden nur Layer für Ticket Ownerunterstü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.

Standard:"ContactID", "StateID", "QueueID", "ResponsibleID", "Changed"
Beispiel:"ContactID", "StateID", "ResponsibleID", "DynamicFields.PlannedEffort", "Dyna micFields.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.

Standard:"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:

KIXMobileApp::GeoPosition::ChangeThreshold

Meldung von Positionsdaten

Legt fest, ab welcher Positionsänderung die App die neue Position sendet (Entfernung in Metern).

Mögliche Werte:

  • Natürliche Zahlen > 0

  • Bei ungültigen Eingaben wird der Standardwert verwendet

  • Default: 1000

KIXMobileApp::GeoPosition::EnabledByDefault

Meldung von Positionsdaten

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)

In diesem Abschnitt: