GefahrenLink
Ihr Leitfaden zur V5-Integration!
Der Importendpunkt „HazardLink“ ermöglicht die schnelle Zuordnung von Waren zu Gefahr Gruppen innerhalb der V5-Rückverfolgbarkeit.
In diesem Handbuch wird die Verwendung dieses Endpunkts sowohl über den CSV-Import als auch über die Verwendung von JSON über die V5-API erläutert.
Inhaltsverzeichnis
1. Standard-Gefahrengruppen
Die Standarddatenbank von V5 enthält eine Reihe der gängigsten Gefahrengruppen, aber dieser Endpunkt kann bei Bedarf zum Erstellen zusätzlicher Gruppen verwendet werden. Die enthaltenen Standardgefahrengruppen sind im folgenden Screenshot zu sehen:
Dieser Endpunkt ist nicht für die Erstellung von Waren vorgesehen. Dies sollte immer über den Endpunkt „Ware'-Endpunkt.
2. API-Links
Weitere Informationen zu den Definitionen dieses „HazardLink“ und den zugehörigen Datenbankklassen finden Sie unter dem folgenden Link:
3. HazardLink-Feldhandbuch
3.1. Primärschlüssel
Für beide Importmethoden lauten die Primärschlüssel:
Gefahr_Gefahr – der Name der Gefahrengruppe (z. B. Schutzbrille, Gehörschutz usw.).
Warennummer – Der eindeutige Code der Ware, der der Gefahrengruppe zugeordnet werden soll.
3.2. Weitere Felder
Weitere Optionen, die wir hier aus der Datenbankklasse „Hazard“ hinzufügen können, sind:
Gefahren_Warntext – Der Text, der einem Terminal- oder WMS-Bediener angezeigt werden soll, wenn die mit einer Gefahr verbundene Ware gehandhabt wird. Nur erforderlich, wenn neue Gefahrengruppen erstellt werden.
Gefahrentextfarbe – Ermöglicht die Eingabe einer RGB-Nummer, um der Gefahrengruppe eine Farbe zuzuweisen. Beachten Sie, dass diese für alle Waren innerhalb derselben Gefahrengruppe gleich sein sollte. Beachten Sie auch hier, dass beim Importieren von Farben mit dieser Methode die RGB-Nummern nicht durch Kommas getrennt werden müssen (z. B. 219 125 33 statt 219, 125, 33).
Beachten Sie, dass diese Option für die JSON-Methode nicht verfügbar ist, es sei denn, Sie erstellen über diesen Endpunkt eine neue Gefahrengruppe. Wenn eine Änderung vorhandener Gruppenfarben erforderlich ist, wird empfohlen, den CSV-Endpunkt zu verwenden.
4. Beispieldatensatz
Für diesen Beitrag betrachten wir einen einfachen Beispieldatensatz mit 2 Zutaten, die bei der Produktion verwendet werden könnten:
- Benzylalkohol – Schutzmaske (Orange) und Schutzhandschuhe (Rot)
- Propylenglykol – Schutzbrille (blau) und Schutzhandschuhe (rot)
5. Methodik
5.1. JSON – Importieren
'HazardLink' Import-Endpunkt/URI –
http://host:port/V5-API/api/integrate/import/hazard_link
Proben:
Mithilfe des Endpunkts „HazardLink“ können wir eine Importdatei für die oben genannten Ergänzungen wie folgt strukturieren:
Diese JSON-Beispieldatei kann heruntergeladen werden werden auf dieser Seite erläutert.
Und sobald wir dies im System gebucht haben, können wir sehen, dass alle unsere Waren der richtigen Gefahrengruppe zugewiesen wurden. In diesem Fall können wir sehen, dass beide Waren der Gefahrengruppe „Schutzhandschuhe“ hinzugefügt wurden.
5.2. CSV – Importieren
Für CSV-Importe müssen wir zuerst eine Header-Datei für unsere Importe erstellen.
Dateiname der Kopf-/Spaltendefinition: „hazardLink.csvh“
Fertige Header-Dateien sollten abgelegt werden in: „ \SG Control Center\gateway\import\column_defs“
CSV-Dateiname importieren: „hazardLink-datetime.csv“
CSVs für den Import sollten abgelegt werden in: „ \SG Control Center\gateway\import”
Proben:
Header-Datei:
Unten sehen Sie ein Beispiel für eine Header-Datei. Hier ordnen wir unsere Waren den definierten Gefahrengruppen zu und fügen den Gruppen auch eine Farbe hinzu:
Weitere Informationen zur Strukturierung dieser Dateien finden Sie im Hauptintegrationsseite. Diese Beispiel-Header-Datei kann heruntergeladen werden werden auf dieser Seite erläutert.
CSV-Importdatei:
Wir können dann die definierte Reihenfolge der Datenpunkte im Header verwenden, um unsere Importdatei zu strukturieren. Beachten Sie, dass diese erste Zeile vom Control Center ignoriert und daher beim Senden zum Import in der Datei beibehalten werden kann. Ein Beispielimport basierend auf unseren oben genannten Anforderungen würde folgendermaßen aussehen:
Beachten Sie erneut, dass wir die Kommas, die normalerweise RGB-Werte trennen, nicht benötigen. Diese Beispiel-Importdatei kann heruntergeladen werden werden auf dieser Seite erläutert.
Wir können diese Datei dann wie oben definiert in unseren Importordner ablegen. Sobald der Import abgeschlossen ist, können wir sehen, dass die Textfarben der Gefahrengruppe aktualisiert wurden und die beiden Zutaten nun wie oben der Gruppe „Sicherheitshandschuhe“ hinzugefügt wurden:
