AllergenLink

Der Importendpunkt „AllergenLink“ ermöglicht die schnelle Zuordnung von Waren zu Allergen 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.

1. Standardallergengruppen
2. API-Links
3. AllergenLink Feldhandbuch
   1. Primärschlüssel
   2. Zusätzliche Felder
4. Beispieldatensatz
5. Methodik
   1. 1. JSON – Importieren
      2. CSV – Importieren

Die Standarddatenbank von V5 enthält eine Reihe der gängigsten Allergengruppen, aber dieser Endpunkt kann bei Bedarf zum Erstellen weiterer Gruppen verwendet werden. Die enthaltenen Standardallergengruppen 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.

Weitere Informationen zu den Definitionen dieses „AllergenLinks“ und den zugehörigen Datenbankklassen finden Sie unter dem folgenden Link:

AllergenLink 

Allergen

Für beide Importmethoden lauten die Primärschlüssel:

Allergen_Allergen – der Name der Allergengruppe (z. B. Weizen, Gluten usw.).

Warennummer – Der eindeutige Code der Ware, der der Allergengruppe zugeordnet werden soll.

Weitere Optionen, die wir hier aus der Datenbankklasse „Allergen“ hinzufügen können, sind:

Allergen_TextColor – Ermöglicht die Eingabe einer RGB-Nummer, um der Allergengruppe eine Farbe zuzuweisen. Beachten Sie, dass diese für alle Waren innerhalb derselben Allergengruppe 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).

Für diesen Beitrag betrachten wir einen einfachen Beispieldatensatz mit 5 Zutaten, die bei der Produktion verwendet werden könnten:

Daher werden wir diesen Waren hier die folgenden Standardallergengruppen zuweisen. Für den CSV-Import werden wir gleichzeitig auch Textfarben zuweisen:

• Mehl – Weizen (rot) und Gluten (lila)
• Käse – Milchprodukte (gelb)
• Eier – Ei (grün)
• Sojabohnen – Soja (blau)
• Mandeln – Baumnüsse (orange)

'AllergenLink' Import Endpunkt/URI –

http://host:port/V5-API/api/integrate/import/allergen_link

Endpunktbeschreibung

Proben:

Mithilfe des Endpunkts „AllergenLink“ 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 Allergengruppe zugeordnet wurden, in diesem Fall die Mandeln unter „Baumnüsse“.

Für CSV-Importe müssen wir zuerst eine Header-Datei für unsere Importe erstellen.

Dateiname der Kopf-/Spaltendefinition: „allergenLink.csvh“

Fertige Header-Dateien sollten abgelegt werden in: „ \SG Control Center\gateway\import\column_defs“

CSV-Dateiname importieren: „allergenLink-datetime.csv“

CSVs für den Import sollten abgelegt werden in: „ \SG Control Center\gateway\import”

Proben:

Header-Datei:

Nachfolgend sehen Sie ein Beispiel für eine Header-Datei. Hier ordnen wir unsere Waren den definierten Allergengruppen 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 ziehen und sobald der Import abgeschlossen ist, können wir bereits sehen, dass die Textfarben der Allergengruppen aktualisiert wurden:

Und wenn wir jede Gruppe untersuchen, sehen wir, dass unsere gewünschten Allergene hinzugefügt wurden: