Serviceaufträge verarbeiten
Nach der Einrichtung und Aktivierung können Serviceaufträge wie nachfolgend beschrieben mit CLAAS DSM synchronisiert werden.
- Funktionsweise der Synchronisation
- Aktionen im Serviceauftrag
- CLAAS-Felder im Arbeitsblatt
- Interne Serviceaufträge / Dummy-Aufträge
- Interface Log
- Servicekommentare
Funktionsweise der Synchronisation
Die Synchronisation zwischen Aptean Equipment DMS und CLAAS DSM funktioniert wie folgt:
- Beim Senden eines Serviceauftrags an CLAAS DSM wird ein Protokolleintrag mit den Informationen aus dem Serviceauftrag und dem Arbeitsblatt erstellt. Dieser Protokolleintrag wird über den Aufgabenwarteschlangeneintrag TSRCI Send Dms Log an CLAAS DSM gesendet.
- Auf CLAAS DSM bearbeiten Techniker den Auftrag und können Artikel hinzufügen oder entfernen, Mengen ändern und Zeiten erfassen. Jede Änderung wird an Aptean Equipment DMS zurückgesendet.
- Eingehende Nachrichten werden über den veröffentlichten Webdienst empfangen und im Interface Log erfasst.
- Der Aufgabenwarteschlangeneintrag TSRCI Main Process Routine verarbeitet diese Protokolleinträge: Eingehende Daten werden zunächst in den CLAAS DSM Line-Puffer geschrieben, der im Arbeitsblatt als Item- und Resource-Zeilen angezeigt wird, und anschließend in die eigentlichen Service- und Ressourcenzeilen des Arbeitsblatts übernommen.
Hinweis
Für eine ausgehende Nachricht wird unmittelbar eine kurze, synchrone Bestätigung zurückgegeben, ob sie erfolgreich empfangen wurde. Die eigentlichen Datenänderungen werden separat und asynchron zurückgesendet, sobald CLAAS DSM den Auftrag verarbeitet hat.
Hinweis
Die Verarbeitung eigenständiger Anwesenheits- und Abwesenheitszeiteinträge von CLAAS DSM, die keinem bestimmten Serviceauftrag zugeordnet sind, setzt voraus, dass orderbase Time Management aktiv ist. Ohne orderbase Time Management protokolliert Aptean Equipment DMS für diese Einträge einen Fehler.
Die ausgetauschten Nachrichten werden nach folgenden, im Interface Log sichtbaren Nachrichtentypen unterschieden:
| Nachrichtentyp | Richtung | Zweck |
|---|---|---|
| If01 | Aptean Equipment DMS → CLAAS DSM | Sendet einen Serviceauftrag mit Arbeitsblatt an CLAAS DSM. |
| If02 | CLAAS DSM → Aptean Equipment DMS | Übermittelt Änderungen, die bei CLAAS DSM an einem bestehenden Serviceauftrag vorgenommen wurden (Artikel, Mengen, Zeiten, Status). |
| If02 Initial WorkOrder | CLAAS DSM → Aptean Equipment DMS | Bestätigt, dass ein Serviceauftrag bei CLAAS DSM angelegt wurde. |
| If03 Work Order / If03 Custom Work Order | CLAAS DSM → Aptean Equipment DMS | Sendet einen Zeiteintrag, der einem Serviceauftrag zugeordnet ist. Erfordert orderbase Time Management. |
| If03 Attendance / If03 Absence | CLAAS DSM → Aptean Equipment DMS | Sendet einen eigenständigen Anwesenheits- oder Abwesenheitszeiteintrag ohne Zuordnung zu einem bestimmten Serviceauftrag. Erfordert orderbase Time Management. |
Aktionen im Serviceauftrag
Auf der Seite Service Order wird in der Menüleiste des Zeileninforegisters die Aktionsgruppe CLAAS DSM hinzugefügt:
| Aktion | Beschreibung |
|---|---|
| Send | Sendet den Serviceauftrag an CLAAS DSM. Der Serviceauftrag wird anschließend für die Bearbeitung in Aptean Equipment DMS gesperrt. |
| Log | Zeigt die bisherigen Interface-Log-Einträge zum Datenaustausch mit CLAAS DSM an. |
| Open DSM Pro | Öffnet den Serviceauftrag auf der Website von CLAAS DSM. |
| Canceled Service Lines | Zeigt Servicezeilen an, die gelöscht wurden, nachdem der Serviceauftrag bereits mit CLAAS DSM synchronisiert wurde. |
| Get Work Order ID | Ruft die bei CLAAS DSM zu hinterlegende CLAAS-Work-Order-ID ab. Siehe Interne Serviceaufträge / Dummy-Aufträge. |
Wichtig
Sobald ein Serviceauftrag gesendet wurde, ist er für die Bearbeitung in Aptean Equipment DMS gesperrt. Weitere Änderungen müssen in CLAAS DSM vorgenommen werden und werden automatisch zurücksynchronisiert.
CLAAS-Felder im Arbeitsblatt
Auf der Seite Service Item Worksheet zeigt das Inforegister CLAAS folgende Felder an:
| Feld | Beschreibung |
|---|---|
| Claas Customer Id | Die bei CLAAS DSM verwendete Kunden-ID. Dient nur zur Information. |
| Claas Machine Id | Die eindeutige, bei CLAAS DSM verwendete Maschinenkennung. Dient nur zur Information. |
| Work Order No. | Die Nummer des Serviceauftrags bei CLAAS DSM. |
| Work Order ID | Die eindeutige (interne) ID, die den Serviceauftrag bei CLAAS DSM identifiziert. |
| Work Order Status | Der Status des Auftrags bei CLAAS DSM: New, Pending, Closed oder Cancelled. |
| Update Required | Zeigt an, dass sich der Serviceauftrag seit der letzten Synchronisation geändert hat und erneut gesendet werden muss. Wird automatisch gesetzt, sobald eine Zeile geändert wird. |
| DSM Lines Exist | Zeigt an, dass eingehende Item- oder Resource-Zeilen von CLAAS DSM noch auf die Verarbeitung in das Arbeitsblatt warten. |
| Processed Lines Reviewed | Ein manuell setzbares Kontrollkästchen, mit dem ein Benutzer bestätigt, die verarbeiteten Zeilen geprüft zu haben und dass alles korrekt ist. Dieses Kennzeichen hat keinen Einfluss auf die Verarbeitung und wird automatisch zurückgesetzt, sobald eine neue Aktualisierung eingeht, unabhängig davon, ob intern oder von CLAAS DSM. |
In der Menüleiste bietet die Aktionsgruppe CLAAS DSM zusätzlich zu den oben beschriebenen Aktionen Send, Log, Open DSM Pro, Canceled Service Lines und Get Work Order ID folgende Aktionen:
| Aktion | Beschreibung |
|---|---|
| Update Service Lines | Überträgt verarbeitete CLAAS-DSM-Zeilen in die Service- und Ressourcenzeilen. Wird normalerweise automatisch über die Aufgabenwarteschlange ausgeführt; nutzen Sie diese Aktion nur zur Fehlersuche. |
| Processed Lines Reviewed | Setzt das Kontrollkästchen Processed Lines Reviewed. |
Eingehende Artikel und Ressourcenzeiten werden zunächst in den Inforegistern Claas Item DSM Lines und Claas Resource DSM Lines angezeigt, bevor sie in die eigentlichen Service- und Ressourcenzeilen verarbeitet werden.
Hinweis
In einem einwandfrei funktionierenden System sind die Inforegister Claas Item DSM Lines und Claas Resource DSM Lines in der Regel leer. Einträge verbleiben hier nur, wenn ein Fehler die weitere Verarbeitung verhindert hat.
Interne Serviceaufträge / Dummy-Aufträge
Nicht jede Arbeit ist einer bestimmten Kundenmaschine zugeordnet, z. B. das Hoffegen oder andere interne Arbeiten. Dafür ermöglicht CLAAS DSM die Einrichtung eines festen internen ("Dummy"-)Auftrags, auf den solche Zeiteinträge gebucht werden können.
Um einen festen internen Serviceauftrag in Aptean Equipment DMS mit der entsprechenden Einstellung bei CLAAS DSM zu verknüpfen, gehen Sie wie folgt vor:
- Legen Sie den internen Serviceauftrag an, z. B. mit einem Dummy-Serviceartikel, der keine reale Maschine darstellt.
- Klicken Sie in der Menüleiste auf Get Work Order ID, um die CLAAS-Work-Order-ID abzurufen, die diesen Serviceauftrag eindeutig identifiziert.
- Tragen Sie diese ID in die entsprechende Einstellung für interne Aufträge bei CLAAS DSM ein.
Hinweis
Diese Verknüpfung muss nur einmal pro internem Serviceauftrag hergestellt werden.
Tipp
Jeder Serviceauftrag sollte nur einen Serviceartikel enthalten. Zwar erlaubt Aptean Equipment DMS technisch mehrere Serviceartikel pro Serviceauftrag, jeder Serviceartikel erhält dabei jedoch eine eigene Work-Order-ID. CLAAS empfiehlt Händlern daher, pro Serviceauftrag nur einen Serviceartikel zu verwenden.
Interface Log
Das CLAAS-spezifische DSM Interface Log erweitert das Standard-Interface-Log um Informationen zum Nachrichtentyp sowie um zusätzliche Aktionen zur Fehlersuche.
Wichtig
Die nachfolgend beschriebenen manuellen Aktionen sind für die Fehlersuche durch Consultants oder den Support vorgesehen. Im Regelbetrieb erfolgen Senden und Verarbeitung automatisch über die im Abschnitt Einrichtung beschriebenen Aufgabenwarteschlangeneinträge.
| Aktion | Beschreibung |
|---|---|
| Process Message | Schreibt eine eingehende CLAAS-DSM-Nachricht in die DSM-Zeilen des Serviceauftrags. |
| Send Data | Sendet die Nachricht an CLAAS DSM. |
| Set Entry Status to Erroneous | Setzt den Status des Protokolleintrags manuell auf Erroneous. |
| Download Message | Lädt die ausgehende oder eingehende Nachricht als JSON-Datei herunter. |
| Download Response | Lädt die Antwort auf eine ausgehende Nachricht als JSON-Datei herunter. |
| Open Service Order | Öffnet den zugehörigen Serviceauftrag. |
| Open Worksheet | Öffnet das zugehörige Arbeitsblatt des Serviceauftrags. |
| Open Interface Card | Öffnet die Schnittstelleneinrichtung. |
| Open Job Queue | Öffnet die Seite Job Queue Entries. |
| Open DSM Pro | Öffnet den zugehörigen Auftrag auf der Website von CLAAS DSM. |
Tritt ein Fehler auf, rufen Sie über Drilldown die Details zum Protokolleintrag auf. Bei Bedarf können Sie die vollständige Nachricht oder Antwort zur weiteren Analyse als JSON-Datei herunterladen.
Servicekommentare
Im Inforegister Comments des Serviceauftrags werden Kommentare der Typen Fault, Resolution und Internal mit den entsprechenden Kommentaren synchronisiert, die Techniker bei CLAAS DSM eintragen. Ein Kontrollkästchen DSM Comment zeigt an, ob eine Kommentarzeile von CLAAS DSM stammt.
Wichtig
Kommentare dieser Typen werden bei jeder eingehenden Aktualisierung von CLAAS DSM durch die aktuellen CLAAS-DSM-Kommentare ersetzt. Erfassen oder bearbeiten Sie diese Kommentare in Aptean Equipment DMS daher nur, bevor der Serviceauftrag zum ersten Mal gesendet wird. Nehmen Sie Änderungen danach in CLAAS DSM vor, damit Ihre Eingaben nicht durch die nächste Synchronisation überschrieben werden.