Dieser Artikel wurde mit Unterstützung von KI-Tools bei der Recherche und Texterstellung erstellt. Vor der Veröffentlichung wurde er von unserem Redaktionsteam redaktionell und inhaltlich geprüft und einem Faktencheck unterzogen.

Einrichtung

Dieser Abschnitt beschreibt die Einrichtung der Schnittstelle CLAAS Link-Schnittstelle zur Synchronisation von Serviceaufträgen mit CLAAS DSM.

Voraussetzungen

Um die App CLAAS Link-Schnittstelle zu nutzen, müssen folgende Apps installiert sein:

  • CLAAS Link-Schnittstelle
  • das Basis-Schnittstellenframework (in Aptean Equipment DMS enthalten)
  • Optional orderbase Time Management, einschließlich der Standard-Apps sowie der TRASER Software GmbH-spezifischen Order-Based-Erweiterung, falls Zeiterfassungen der Techniker über orderbase Time Management verarbeitet werden sollen

Hinweis

Die Schnittstelle funktioniert auch ohne orderbase Time Management. Eigenständige Anwesenheits- und Abwesenheitszeiteinträge, die von CLAAS DSM gesendet werden (Nachrichtentypen If03 Attendance und If03 Absence, siehe Serviceaufträge verarbeiten), können jedoch nur verarbeitet werden, wenn orderbase Time Management aktiv ist.

Nach der Installation erscheint die Schnittstelle automatisch in der Interface List mit Interface Type = CLAAS Link Interface und Description = CLAAS Link Interface, genau wie bei anderen Schnittstellen-Apps.

Einrichtung Schnittstelle

Gehen Sie zur Einrichtung der Schnittstelle wie folgt vor:

  • Öffnen Sie die Seite Interface Card über die Schnellsuche (ALT+Q) und öffnen Sie den Eintrag CLAAS Link Interface.
    Weitere Informationen zur Seite Interface Card finden Sie hier.
  • Im Inforegister General:
    • Optional Passen Sie die Description bei Bedarf an, um die Schnittstelle leichter identifizieren zu können.
  • Im Inforegister Authorization:
    • Das Feld Authorization Type ist auf Basic gesetzt, das Feld Authorization Code wird automatisch mit dem Basic Application Endpoint CLAAS gefüllt.
    • Klicken Sie auf das Feld Authorization Code, um den Basic Application Endpoint zu öffnen, und tragen Sie die folgenden, von CLAAS bereitgestellten Werte ein:
      • User Name und Password: identifizieren Ihren Händlerbetrieb bei CLAAS DSM. Es handelt sich um gemeinsam genutzte, technische Zugangsdaten für das gesamte System, nicht um individuelle Zugangsdaten für jeden DSM-Benutzer.
      • URL: die Basis-URL des CLAAS-Webdienstes, über den die Nachrichten ausgetauscht werden.
    • Prüfen Sie über die Aktion Test Connection auf der Seite Basic Application Endpoint, ob die eingetragenen Zugangsdaten und die URL korrekt sind.
  • Das Inforegister Parameters wird von dieser Schnittstelle nicht verwendet und bleibt leer.

Zuordnungseinrichtung

Im Inforegister Mapping Setup werden für diese Schnittstelle folgende Objekte angezeigt:

Name Beschreibung
General Setup Allgemeine Einrichtung der Schnittstelle, einschließlich Buchungsgruppen und Verknüpfung zum CLAAS DSM Pro-Portal.
Resource Setup Standard-Ressource, -Arbeitsart und -Maßeinheit für Fahrtbuchungen.
Unit of Measure Mapping Ordnet Maßeinheiten von Aptean Equipment DMS den Maßeinheiten von CLAAS DSM zu.
Resource Mapping Ordnet Ressourcen (Techniker) von Aptean Equipment DMS der jeweiligen CLAAS-DSM-Ressourcen-ID zu.
Work Type Mapping Ordnet Arbeitsarten von Aptean Equipment DMS den Arbeitsartcodes von CLAAS DSM zu.
Responsibility Center Mapping Ordnet Verantwortungsbereiche von Aptean Equipment DMS den Niederlassungen von CLAAS zu.
Manufacturer Mapping Ordnet Hersteller von Aptean Equipment DMS den Herstellercodes von CLAAS zu.
Counter Type Mapping Ordnet Zählertypen von Aptean Equipment DMS den Zählertypen von CLAAS zu.
Repair Status Mapping List Ordnet Reparaturcodes von Aptean Equipment DMS den Work-Order-Status-Werten von CLAAS zu.

Wichtig

Alle neun oben aufgeführten Objekte sind verpflichtend. Die Schnittstelle kann erst aktiviert werden, wenn jedes Objekt als Completed gekennzeichnet ist.

Hinweis

Werte auf CLAAS-Seite (Arbeitsartcodes, Maßeinheiten, Niederlassungen usw.) werden von CLAAS festgelegt und gepflegt und können sich im Laufe der Zeit ändern. Fragen Sie die aktuellen Werte direkt bei CLAAS an, bevor Sie die Zuordnungstabellen ausfüllen, und prüfen Sie diese regelmäßig.

Tipp

Das Deaktivieren der Schnittstelle führt zu keinem Datenverlust. Noch zu synchronisierende Serviceaufträge verbleiben in der Warteschlange und werden verarbeitet, sobald die Schnittstelle wieder aktiviert wird.

General Setup

Hierbei handelt es sich um einen einzelnen, festen Einrichtungsdatensatz. Füllen Sie folgende Felder aus:

Feld Beschreibung
Code Geben Sie einen Code zur Identifikation dieses Einrichtungsdatensatzes ein.
Use Orderbase Aktivieren Sie dieses Kontrollkästchen, wenn orderbase Time Management zusammen mit dieser Schnittstelle verwendet wird.
DSM Pro Link Geben Sie die von CLAAS bereitgestellte Basis-URL des CLAAS-DSM-Pro-Webportals ein. Diese URL wird von der Aktion Open DSM Pro verwendet, um den aktuellen Serviceauftrag direkt auf der Website von CLAAS zu öffnen.
Gen. Business Posting Group Wählen Sie die Buchungsgruppe (Geschäft) aus, die für die von dieser Schnittstelle erstellten Belege verwendet wird.
Customer Posting Group Wählen Sie die Debitorenbuchungsgruppe aus, die für die von dieser Schnittstelle erstellten Belege verwendet wird.
Attendance Work Type Wählen Sie die Arbeitsart aus, die für von CLAAS DSM empfangene Anwesenheitszeiteinträge verwendet wird.
Absence Work Type Wählen Sie die Arbeitsart aus, die für von CLAAS DSM empfangene Abwesenheitszeiteinträge verwendet wird.
Basket Item Helper Wählen Sie den Artikel aus, der intern von der Schnittstelle während der Verarbeitung verwendet wird.

Resource Setup

Auch hierbei handelt es sich um einen einzelnen, festen Einrichtungsdatensatz und nicht um eine Einrichtung pro Techniker. Er legt die Standardwerte für Fahrtbuchungen fest.

Feld Beschreibung
Resource Travel Code Wählen Sie die Ressource aus, die für Fahrtbuchungen verwendet wird.
Travel Work Type Wählen Sie die Arbeitsart aus, die für Fahrtbuchungen verwendet wird.
Resource Time Code Wählen Sie die Maßeinheit aus, mit der die Zeit der Techniker erfasst wird (z. B. Stunden).

Unit of Measure Mapping

Feld Beschreibung
CLAAS DSM Unit of Measure Geben Sie den von CLAAS bereitgestellten Maßeinheitencode ein, wie er bei CLAAS DSM verwendet wird.
Unit of Measure Code Wählen Sie die entsprechende Maßeinheit von Aptean Equipment DMS aus.

Resource Mapping

Feld Beschreibung
Resource Code Wählen Sie die Ressource (den Techniker) von Aptean Equipment DMS aus.
Claas DSM Resource ID Geben Sie die entsprechende, bei CLAAS DSM verwendete Ressourcen-ID ein, bereitgestellt von CLAAS.

Work Type Mapping

Feld Beschreibung
Work Type Code Wählen Sie die Arbeitsart von Aptean Equipment DMS aus (z. B. Fahrt oder reguläre Arbeitsleistung).
Claas DSM Work Type Code Geben Sie den entsprechenden, bei CLAAS DSM verwendeten Arbeitsartcode ein, bereitgestellt von CLAAS.

Responsibility Center Mapping

Relevant, wenn mehrere Standorte auf demselben Aptean Equipment DMS-Mandanten arbeiten. Jeder Verantwortungsbereich wird genau einer CLAAS-Niederlassung zugeordnet, damit Nachrichten an die richtige Niederlassung bei CLAAS DSM weitergeleitet werden.

Feld Beschreibung
Responsibility Center Code Wählen Sie den Verantwortungsbereich von Aptean Equipment DMS aus.
CLAAS Branch Geben Sie den entsprechenden, bei CLAAS DSM verwendeten Niederlassungscode ein, bereitgestellt von CLAAS.

Hinweis

Im Serviceauftrag wird das Feld Responsibility Center in der Regel automatisch anhand des Standard-Verantwortungsbereichs des Benutzers gefüllt.

Manufacturer Mapping

Feld Beschreibung
Manufacturer No. Wählen Sie den Hersteller von Aptean Equipment DMS aus.
Claas Manufacturer No. Geben Sie die entsprechende, bei CLAAS DSM verwendete Herstellernummer ein.
Claas Manufacturer Name Geben Sie den entsprechenden, bei CLAAS DSM verwendeten Herstellernamen ein.

Counter Type Mapping

Feld Beschreibung
Counter Type Code Wählen Sie den Zählertyp von Aptean Equipment DMS aus.
CLAAS Counter Type Geben Sie den entsprechenden, bei CLAAS DSM verwendeten Zählertyp ein.

Repair Status Mapping List

Feld Beschreibung
Repair Code Wählen Sie den Reparaturcode von Aptean Equipment DMS aus.
Repair Description Nur lesbar. Zeigt die Beschreibung des ausgewählten Reparaturcodes an.
Claas Work Order Status Wählen Sie den entsprechenden Work-Order-Status von CLAAS DSM aus (New, Pending, Closed oder Cancelled).

Einrichtung Aufgabenwarteschlange

Wichtig

Anders als bei anderen Schnittstellen werden die Aufgabenwarteschlangeneinträge für CLAAS Link-Schnittstelle nicht automatisch bei der Aktivierung der Schnittstelle angelegt. Sie müssen wie nachfolgend beschrieben manuell eingerichtet werden.

Richten Sie über die Seite Job Queue Entries (Schnellsuche, ALT+Q) die folgenden zwei Aufgabenwarteschlangeneinträge ein:

Codeunit Zweck Empfohlene Wiederholung
TSRCI Send Dms Log Sendet ausgehende Serviceauftragsnachrichten von Aptean Equipment DMS an CLAAS DSM. Minütlich
TSRCI Main Process Routine Verarbeitet ein- und ausgehende Protokolleinträge: schreibt eingehende Daten in die Puffertabellen und übernimmt sie in das Arbeitsblatt des Serviceauftrags. Minütlich

Tipp

Beide Aufgabenwarteschlangeneinträge verarbeiten pro Durchlauf nur geringe Datenmengen und können bedenkenlos einmal pro Minute ausgeführt werden. Um Systemressourcen zu schonen, können Sie die Ausführung auf Ihre regulären Arbeitszeiten beschränken, anstatt sie rund um die Uhr laufen zu lassen.

Einrichtung Webdienst

Damit Nachrichten von CLAAS DSM empfangen werden können, z. B. Änderungen eines Technikers, muss die Codeunit TSRCI CLAAS Webserv Receiver als Webdienst veröffentlicht werden. Dies ist ein einmaliger technischer Einrichtungsschritt.

  • Öffnen Sie die Seite Web Services über die Schnellsuche (ALT+Q).
  • Erstellen Sie eine neue Zeile:
    • Wählen Sie im Feld Object Type den Wert Codeunit aus.
    • Geben Sie im Feld Object ID den Wert 5575502 ein.
    • Aktivieren Sie das Kontrollkästchen Published.
  • Kopieren Sie die generierte SOAP URL oder OData V4 URL aus der Spalte URL.
  • Übermitteln Sie diese URL an CLAAS oder an das intern für die CLAAS-Integration zuständige Team, damit CLAAS DSM weiß, wohin eingehende Nachrichten gesendet werden müssen.

Aktivierung

Sobald die Autorisierung und alle Zuordnungsobjekte vollständig eingerichtet sind, aktivieren Sie die Schnittstelle wie im Abschnitt Schnittstellen aktivieren beschrieben.

Sie können nun Serviceaufträge verarbeiten und mit CLAAS DSM synchronisieren.