Deere Parts Price List-Schnittstelle

John Deere stellt Katalogartikel-Preislisten digital in der Landessprache des Händlers zur Verfügung (derzeit z. B. Deutsch, Englisch, Französisch, Italienisch, Niederländisch, Spanisch und Schwedisch). Die Katalogartikelliste umfasst u. a. John Deere-Teilenummern, die zugehörigen Händlerlistenpreise, empfohlene Verkaufspreise, Core-Werte (falls erforderlich), Critical Codes, Paketmengen usw.

In diesem Kapitel finden Sie die folgenden Abschnitte:

Einrichtung

Die Deere Parts Price List-Schnittstelle muss eingerichtet werden, um Ersatzteil-Preislisten in John Deere DBS 365 zu importieren und zu verarbeiten. Bitte führen Sie die Einrichtung in der folgenden Reihenfolge aus:

Deere Parts Price List-Schnittstelleneinrichtung

In einem zweiten Schritt muss die Basiseinrichtung der Schnittstelle vorgenommen werden. Gehen Sie hierzu wie folgt vor:

  • Öffnen Sie die Tabelle Schnittstellenliste in John Deere DBS 365 und wählen Sie den Eintrag PARTSPRICELIST aus.
  • Im Inforegister Allgemein:
    • Aktivieren Sie den Schieberegler Schnittstellenprotokoll, um ein Protokoll aller Deere Parts Price List-Schnittstellenaktivitäten über die Schaltfläche Protokoll in der Menüleiste zu führen.

Tipp

Aktivieren Sie bei Bedarf die automatische Löschung von Zeilen auf der Seite Schnittstellenprotokoll nach einer bestimmten Zeit, indem Sie einen Wert in das Feld Protokolleinträge löschen nach eingeben.
Beispiel: 90T = alle Protokolleinträge, die älter als 90 Tage sind, werden automatisch gelöscht. Informationen zur Eingabe eines Zeitraums finden Sie hier.

  • Das Inforegister Autorisierung kann derzeit ignoriert werden.
  • Geben Sie im Inforegister Parameter die folgenden Daten in das Feld Wert ein, um die Schnittstelle vorzubereiten:
    • ArchivePrefix: Geben Sie den Speicherpfad an, unter dem die Ersatzteil-Preisliste nach dem Import in John Deere DBS 365 archiviert wird.
      Der Wert darf nach der Ersteinrichtung nicht geändert werden!
      Empfohlener Wert: JDPRICELIST
    • CatalogCode: Wählen Sie den individuellen Katalogcode für John Deere aus, mit dem der Ersatzteil-Preislistenimport verwaltet wird. Wenn kein Katalogcode verfügbar ist, erstellen Sie einen neuen Katalog wie hier beschrieben.
    • FileFilter: Geben Sie den individuellen Dateifilter für den Ersatzteil-Preislistenimport ein. Ändern Sie keinesfalls den Standardwert!
      Standardwert: *PARTINFO*
    • TariffCodeDigits: Geben Sie die Anzahl von Ziffern ein, die aus John Deere-Ersatzteildateien extrahiert werden sollen, und beachten sie dabei die folgenden Regeln:
      • Die maximale Anzahl der Ziffern beträgt 10, der Standardwert 8.
      • Wenn die Zollposition länger ist als im Parameter angegeben, wird der Rest der Nummer abgeschnitten.
      • Wenn der Wert 0 eingegeben wird, werden bestehende Zollpositionen nicht überschrieben.

Hinweis

Es ist möglich, dem Parameter FileFilter weitere Teile eines Dateinamens hinzuzufügen, um manuell heruntergeladene Deere Parts Price List-Dateien aus dem John Deere Web Download Center (z. B. de19_dwnld_v2-JJJJ-MM-TT.zip für eine komplette wöchentliche Datei oder de19_dwnld_update_v2-JJJJ-MM-TT.zip für eine wöchentliche Deltadatei für Deutschland) zu verarbeiten. Fügen Sie hierzu einfach das Symbol | und den zu verwendenden Teil des Dateinamens in Asterisken (*) hinzu, z. B.:
*PARTINFO*|*DWNLD_UPDATE*|*DWNLD_V2*

Achten Sie darauf, einen zweiten Dateinamen hinzuzufügen, der sich von Ersatzartikeldateien unterscheidet, um diese nicht ebenfalls zu importieren und zu verarbeiten, wenn dies nicht vorgesehen ist!

Wenn alle Anforderungen erfüllt sind (grüne oder graue Werte im Inforegister Parameter), können Benutzer die Schnittstelle über die Schaltfläche Schnittstelle aktivieren auf der PARTSPRICELIST-Schnittstellenkarte aktivieren.

Fahren Sie mit dem Abschnitt Aufgabenwarteschlangen-Einrichtung fort.

Zurück zum übergeordneten Abschnitt

Aufgabenwarteschlangen-Einrichtung

Diese Aufgabenwarteschlange dient dem Import von Deere Parts Price List-Dateien aus DTF und dem Laden der Daten in die Tabelle Zwischengespeicherte Katalogimportposten. Sie wird automatisch während der Deere Parts Price List-Schnittstelleneinrichtung erstellt, sodass es nicht erforderlich ist, sie manuell zu erstellen. Wird die Deere Parts Price List-Schnittstelle aktiviert, wird ein Schnellhinweis angezeigt, über den die Aufgabenwarteschlange bei Bedarf geöffnet werden kann.

Falls die Aufgabenwarteschlange verändert oder zurückgesetzt wurde, befolgen Sie die nachfolgenden Schritte, um die empfohlenen Einstellungen wiederherzustellen:

  • Öffnen Sie die Tabelle Aufgabenwarteschlangenposten in John Deere DBS 365 über die Schnellsuche (ALT+Q).
  • Klicken Sie auf die Schaltfläche Neu, um einen neuen Aufgabenwarteschlangenposten anzulegen.
  • Nehmen Sie im Inforegister Allgemein auf der Seite Karte für Aufgabenwarteschlangenposten folgende Einstellungen vor:
    • Wählen Sie in dem Feld Art des auszuführenden Objekts den Wert Codeunit aus.
    • Wählen Sie in dem Feld ID des auszuführenden Objekts den Wert 5575179 aus.
    • Optional Geben Sie im Feld Beschreibung eine eindeutige Beschreibung für die Aufgabenwarteschlange ein, z. B. Deere Parts Price List-Import, Import Deere Parts Price List.
    • Optional Geben Sie in dem Feld Früheste(s) Startdatum/-uhrzeit das Datum und die Uhrzeit ein, zu dem/der die Aufgabenwarteschlange das nächste Mal ausgeführt werden soll. Ist kein Wert ausgewählt, wird die Aufgabenwarteschlange ausgeführt, sobald Status = Bereit.
  • Nehmen Sie im Inforegister Wiederholung auf der Seite Karte für Aufgabenwarteschlangenposten folgende Einstellungen vor:
    • Aktivieren Sie die Schieberegler für alle Wochentage.
    • Geben Sie in dem Feld Startzeit eine beliebige Uhrzeit ein. Da mit dieser Aufgabenwarteschlange nur die Tabelle Katalogimport-Zwischenspeicher befüllt wird und keine Produktivdatensätze aktualisiert werden, ist kein spezieller Zeitrahmen erforderlich.
    • Geben Sie in dem Feld Endzeit eine beliebige Uhrzeit ein (s. Startzeit oben).
    • Geben Sie in dem Feld Anzahl der Minuten zwischen Ausführungen eine beliebige Zahl ein (s. Startzeit oben).

Der Aufgabenwarteschlangenposten ist fertiggestellt und weist den Wert Status = Wartend auf.

Zurück zum übergeordneten Abschnitt

Benutzerhandbuch

Nach erfolgreicher Einrichtung kann mit der Deere Parts Price List-Schnittstelle Folgendes erledigt werden:

Deere Parts Price List-Dateien automatisch verarbeiten

In John Deere DBS 365 sollen Deere Parts Price List-Dateien automatisch importiert, verarbeitet und archiviert werden, damit sich weder Benutzer noch Administratoren regelmäßig damit auseinandersetzen müssen. Hierfür wurde der Abschnitt Aufgabenwarteschlangen-Einrichtung erstellt, die das Suchen nach entsprechenden Dateien im DTF-Downloadverzeichnis, das Verschieben der Inhalte in den Katalogpuffer sowie das Archivieren der Datei umfasst.

Die weitere Verarbeitung der in die Tabelle Katalogimport-Zwischenspeicher importierten Inhalte beruht auf den Standardfunktionen der Ausführung und Planung einer Katalogaktualisierung.

VORSICHT!

Die Tabelle Zwischengespeicherte Katalogimportposten wird geleert, bevor eine neue geplante Katalogaktualisierung ausgeführt wird! Vergewissern Sie sich vorher, dass die zuvor zwischengespeicherten Katalogimportposten erfolgreich verarbeitet wurden!

Die folgenden Aktionen werden nach Aktivierung der Aufgabenwarteschlange ausgeführt:

  • Das DTF-Downloadverzeichnis wird regelmäßig (gemäß den Einstellungen in der Aufgabenwarteschlange und den Parametern im Abschnitt Deere Parts Price List-Schnittstelleneinrichtung) auf PARTSPRICELIST-Dateien geprüft.
  • Wenn eine Datei gefunden wird, wird sie ohne Benutzerinteraktion oder Bestätigungsmeldungen verarbeitet, sodass das Endergebnis eine Liste der Datensätze in der Tabelle Katalogimport-Zwischenspeicher ist. Diese müssen wie folgt manuell auf John Deere DBS 365 angewendet werden:
    • Öffnen Sie die Seite Katalogkarte des im Parameter CatalogCode definierten Herstellerkatalogs.
    • Klicken Sie auf Aktualisieren > Aktualisierung ausführen, um alle Datensätze direkt zu aktualisieren, oder Aktualisieren > Aktualisierung planen/verwerfen, um eine Aktualisierung für die Zukunft einzuplanen.
  • Falls ein Fehler bei der Verarbeitung auftritt, wird die Aufgabenwarteschlange nicht angehalten. Der fehlerhafte Posten wird übersprungen und ein Schnittstellen-Protokolleintrag angelegt, in dem der Benutzer über das Problem informiert wird.
  • Die Ersatzteil-Listendatei wird gemäß der Parametereinrichtung im Abschnitt Deere Parts Price List-Schnittstelleneinrichtung in das DTF-Archivverzeichnis verschoben. Zusätzlich wird der archivierten Datei ein Präfix hinzugefügt, um deutlich zu machen, dass es sich um eine archivierte Preislistendatei handelt.

Hinweis

Beim manuellen (Aktualisieren > Aktualisierung ausführen) oder automatischen Aktualisieren von Deere Parts Price List-Dateien werden zunächst die Deere Parts Price List-Daten aus der Tabelle Zwischengespeicherte Katalogimportposten, anschließend die Deere Parts Substitution-Daten aus der Tabelle Zwischengespeicherte Katalog-Ersatzartikelposten, und schließlich die alternativen Ersatztteildaten automatisch verarbeitet, sofern vorhanden.

Zurück zum übergeordneten Abschnitt

Deere Parts Price List-Dateien manuell verarbeiten

Benutzer können eine Preisdatei von John Deere von Beginn an manuell importieren.

Warnung!

Diese Funktion soll den automatischen Import und die Verarbeitung der monatlich von John Deere über die DTF-Integration bereitgestellten Preisdateien ergänzen und zusätzlich zu diesen bestehen. Gehen Sie beim manuellen Importieren von Dateien vorsichtig vor, um fehlerhafte oder beschädigte Daten zu vermeiden.

Hierfür wurde der Seite Katalogkarte des Katalogcodes, der im Parameter CatalogCode im Abschnitt Deere Parts Price List-Schnittstelleneinrichtung definiert wurde, die Schaltfläche Prozess > John Deere-Preisdatei importieren hinzugefügt.

Nachfolgend wird der manuelle Prozess Schritt für Schritt beschrieben:

  • Öffnen Sie die Seite Katalogkarte des im Parameter CatalogCode definierten Herstellerkatalogs.
  • Klicken Sie auf die Schaltfläche Prozess > John Deere-Preisdatei importieren. John Deere DBS 365 zeigt ein Dialogfenster mit der Frage an, ob eine neue DAT-Datei ausgewählt und der Zwischenspeicher gelöscht werden soll.
  • Bestätigen Sie das Dialogfeld, indem Sie auf Ja klicken. Es wird ein Popupfenster geöffnet, in dem entweder eine DAT-, ZIP- (direkt von der John Deere-Website) oder eine DAT.GZ-Datei ausgewählt werden muss.

Tipp

Große oder vollständige Deere Parts Price List-Dateien (>100 MB) müssen aus Kompatibilitätsgründen und zum Vermeiden von Zeitüberschreitungen beim Import nach 65 Sekunden als ZIP-Datei komprimiert werden. TRASER Software GmbH empfiehlt die Verwendung von 7-Zip.

  • Klicken Sie auf Auswählen, um die entsprechende Datei mit den Anfangsbuchstaben PARTINFO auszuwählen, und bestätigen Sie Ihre Auswahl per Klick auf Öffnen im Dateiexplorer.

  • Die Preislistendatei wird importiert und zeigt die Anzahl der Posten, die der Tabelle Katalogimport-Zwischenspeicher hinzugefügt wurden. Bestätigen Sie diese Meldung per Klick auf OK.

    • Das Inforegister Planung auf der Seite Katalogkarte wird mit den neuesten Informationen befüllt, also die Werte Preise gültig ab und Anzahl der gepufferten Katalogimportsätze.
    • Optional Klicken Sie auf den Wert Anzahl der gepufferten Katalogimportsätze, um die Tabelle Zwischengespeicherte Katalogimportposten zu öffnen und die importierten Werte anzuzeigen. Die Tabelle zeigt auch John Deere-spezifische Werte, die von JDPoint bekannt sind, um alle Funktionen und Automatisierungen vollständig zu unterstützen.
  • Weitere Informationen zu manuellen Importoptionen finden Sie hier.

Hinweis

Beim manuellen (Aktualisieren > Aktualisierung ausführen) oder automatischen Aktualisieren von Deere Parts Price List-Dateien werden zunächst die Deere Parts Price List-Daten aus der Tabelle Zwischengespeicherte Katalogimportposten, anschließend die Deere Parts Substitution-Daten aus der Tabelle Zwischengespeicherte Katalog-Ersatzartikelposten, und schließlich die alternativen Ersatzteildaten automatisch verarbeitet, sofern vorhanden.

Zurück zum übergeordneten Abschnitt