Administration
Nachfolgend finden Sie Hinweise für eine reibungslose Kommunikation der KIX Field Agent App (nachfolgend: App) mit dem Service Management System KIX 18.
Erforderliche Berechtigungen
Der Field Service Agent muss im Agentenportal von KIX 18 als Nutzer mit folgenden Rollen/Berechtigungen angelegt sein:
Ticket Agent (MUSS)
FAQ Reader und Asset Reader (SOLL)
Diese Berechtigungen werden von uns empfohlen, damit der Field Service Agent die App optimal nutzen kann.
Die Nutzerverwaltung finden Sie im Agentenportal von KIX 18 im Modul Admin unter .
Aktualisierung von Geopositionsdaten
Die App kann die Geopositionsdaten Ihres mobilen Geräts an KIX übermitteln. Agenten erkennen dadurch, wo sich die Servicemitarbeiter aktuell befinden. So können eingehende Störmeldungen direkt an den Servicemitarbeiter geleitet werden, welcher sich in der Nähe der Störquelle befindet.
Das Sendeverhalten der App kann im Admin Modul des Agentenportals von KIX 18 gesteuert werden. Dies erfolgt im Menü in folgenden Konfigurationsschlüsseln:
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.
Standard: 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.
0 - inaktiv (Standard)
1- aktiv
Tickets
Wichtig
Damit ein Ticket in der App angezeigt wird, MUSS es das Dynamische Feld “MobileProcessingState” gesetzt haben.
In der App werden in den Listen #Meine Tickets und Andere Tickets nur jene Tickets angezeigt, die als Mobilen Bearbeitungsstatus die Werte "assigned", "accepted", "downloaded", "partially executed", "processing", "suspended", "cancelled" oder "completed" gesetzt haben.
Tickets im MobileProcessingState "rejected" werden nicht mehr von der App betrachtet.
Teamzuordnung bei Ticketerstellung
Die ausgewählten Queues sind in den persönlichen Einstellungen des Agenten zu hinterlegen, sonst greifen die Standardeinstellungen (PostmasterDefault-Vorgaben).
QR Code
Der Scan eines QR-Codes kann auf ein oder mehrere Assets referenzieren. So können bspw. Arbeitsplätze, denen mehrere Geräte zugeordnet sind, in der App angezeigt werden. Sind Tickets zu einem dieser Assets vorhanden, wird diese Verknüpfung ebenfalls angezeigt.
Im SysConfig-Schlüssel kann das Auflösungsverhalten des QR-Codes gesteuert werden. Mögliche Werte im Konfigurationsschlüssel:
none/empty: Verhält sich wie ein Alias, d. h. der QR-Code ist nur mit einem Asset verknüpft.
multi: Ermöglicht die Verknüpfung mehrerer Assets, d. h. mehrere Assets können mit dem QR-Code verknüpft werden. Die zugehörigen Tickets werden ebenfalls angezeigt.
Verfügbare Dynamische Felder / Formulardaten
Ab v1.8 der Field Agent App können Dynamische Felder offline verfügbar gemacht oder in der App eingegeben werden. Dies betrifft die Formularfeldtypen Text ein-/mehrzeilig, Datum und Datumzeit, Ein-/Mehrfachauswahlen (Selection) sowie Tabelleneingaben.
Dazu sind jedoch Einstellungen in den entsprechenden Konfigurationsschlüsseln vorzunehmen. Dies erfolgt im Admin Modul des Agentenportals im Menü in folgenden Schlüsseln:
Die App bezieht diese Konfigurationseinstellungen bei der Anmeldung. Nach Änderungen der Konfiguration ist entsprechend eine Ab- und Anmeldung in der App erforderlich.
Dieser Konfigurationsschlüssel definiert eine Liste Dynamischer Felder für Tickets, die in der App im Bereich Formular Daten angezeigt und bearbeitet werden können.
Die Liste enthält die Namen der Dynamischen Felder (z.B. ,"WorkOrder") oder reguläre Ausdrücke, die zu den Namen der Dynamischen Feldern passen (z.B. "Work.*").
Die Dynamischen Felder werden in der App in der Reihenfolge angezeigt, in der sie in diesem Schlüssel definiert sind.
Hinweis: Dynamische Felder, deren Feldtyp nicht von der App unterstützt wird, stehen in der App nicht zur Verfügung.
Beispielkonfiguration:
[ "MobileProcessingChecklist.*", "SomeTextArea", "SomeTextField", "SomeDateField", "SomeDateTimeField", "SomeSelectionField", "SomeTableField" ]
Dieser Konfigurationsschlüssel definiert eine Liste Dynamischer Felder für Tickets, die in der App überhaupt betrachtet werden.
Die Liste enthält die Namen der Dynamischen Felder (z.B. ,"WorkOrder") oder reguläre Ausdrücke, die zu den Namen der Dynamischen Feldern passen (z.B. "Work.*").
Ausgewählte Dynamische Felder wie "MobileProcessingState", "PlanBegin", "PlanEnd" werden fest von der App verwendet und können durch diese Einstellung nicht entfernt oder in ihrem App-Verhalten geändert werden.
Feldtypen, die zur Eingabe verfügbar sind, werden im Bereich Formular Daten angezeigt (siehe Konfigurationsschlüssel KIXMobileApp::TicketDynamicFields::Edit). Andere Feldtypen werden im Bereich Mehr Informationen als reiner Textwert angezeigt.
Beispielkonfiguration:
[ "MobileProcessingState", "RiskAssumptionRemark", "MobileProcessingChecklist.*" ]
Zeiterfassung
Die Zeiterfassung kann an Tickets bei Bedarf auch optional erfolgen. Dazu muss ein Dynamisches Feld mit dem Namen "TimeAccountingRequired" vorhanden sein und den Wert no beinhalten. Ihr Admin kann dies konfigurieren.
Wenn das Feld nicht vorhanden, nicht gesetzt oder mit einem anderen Wert versehen ist, verhält sich die App wie bisher. Die Zeitnahme startet mit Beginn der Bearbeitung des Tickets.
Ist das Feld mit dem Wert no gesetzt, startet die App die Zeiterfassung am Ticket nicht automatisch. Der Agent muss diese bewusst und aktiv starten indem er "Start Zeitnahme" anklickt.
Optional besteht weiterhin die Möglichkeit eine freie Zeitbuchung vorzunehmen.