CustomFieldLink

Mit dem Importendpunkt „CustomFieldLink“ können Waren (normalerweise Fertigproduktformeln) schnell benutzerdefinierte Etikettennachrichten zugewiesen werden, die produktbezogen auf Produktetiketten gedruckt werden können.

Weitere Informationen zur Funktionsweise und verschiedene Beispiele für die Verwendung von benutzerdefinierten Feldern finden Sie werden auf dieser Seite erläutert.

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. Layout des Kontrollzentrums
2. API-Links
3. CustomFieldLink-Feldhandbuch
   1. Primärschlüssel
   2. Benötigte Felder
4. Beispieldatensatz
5. Methodik
   1. 1. JSON – Importieren
      2. CSV – Importieren

Um die Details benutzerdefinierter Felder mit dem in Control Center angezeigten Inhalt in Beziehung zu setzen, verwenden wir die V5-API und das Gateway, um sowohl das obere „CustomField“-Bedienfeld zu füllen, in dem wir unsere benutzerdefinierten Felder benennen und Details zu den Beschriftungsparametern eingeben können, als auch das untere „CustomFieldLink“-Bedienfeld, um dem benutzerdefinierten Feld Waren zuzuweisen und formelspezifische Informationen einzugeben, die dann für den Beschriftungsparametersatz im oberen Bedienfeld abgerufen werden können.

Weitere Informationen zu den Definitionen dieser „CustomFieldLink“-Klasse finden Sie unter dem folgenden Link:

CustomFieldLink 

Für den Import über den Endpunkt „CustomFieldLink“ lauten die Primärschlüssel:

Feldname – Der eindeutige Name für das benutzerdefinierte Feld, das wir entweder hinzufügen oder dem wir unsere Formel zuweisen. Wir können dies oben als „Verteilt von“ sehen.

Warennummer – Der eindeutige Code der Waren-/Produktformel, der der benutzerdefinierten Feldgruppe zugewiesen werden soll.

Wir können weitere notwendige Daten hinzufügen, um den Import sowohl aus dem 'Benutzerdefinierte Feld'Und'CustomFieldLink' Datenbankklassen. Diese sind:

Aus CustomField:

Feldbezeichnungsparameter - Erforderlich, wenn eine neue benutzerdefinierte Feldgruppe erstellt wird. Dies ist der Parameter, der auf Etiketten verwendet wird, um benutzerdefinierte Daten aus dieser Gruppe abzurufen. Im Control Center-Beispiel oben sehen wir, dass dies „DIST“ ist.

Feld_Standardwert - Der Standardwert, der abgerufen wird, wenn der Label-Parameter verwendet wird, vorausgesetzt, dass im unteren Bereich „CustomFieldLink“ kein waren-/formelspezifischer Wert vorhanden ist, der diesen überschreibt. Im Control Center-Beispiel oben sehen wir, dass dies „SG Systems LLC“ ist.

Von CustomFieldLink:

Datum – Die Informationen, die auf dem Etikett für diese bestimmte Ware/Formel abgerufen werden sollen, wenn der Etikettparameter der benutzerdefinierten Feldgruppe auf einem Etikett verwendet wird.

Für diesen Teil werden wir uns einen einfachen Beispieldatensatz mit 3 verschiedenen Produktformeln ansehen, die wir dem bereits erstellten Feld „Verteilt von“ zuweisen können, wobei wir jedem eine eindeutige Verteilungsnachricht geben. Wir werden auch eine neue benutzerdefinierte Feldgruppe namens „Vorbereitungsanweisungen“ mit dem Bezeichnungsparameter „PREP“ hinzufügen.

Daher werden wir dem System die folgenden Daten hinzufügen:

• P006:
  • Vertrieben von: ABC-Verteilung.
  • Vorbereitungsanleitung: Vor Gebrauch waschen.
• P007:
  • Vertrieben von: Daves Vertriebspartner
  • Vorbereitungsanleitung: Vor Gebrauch waschen.
• P008:
  • Vertrieben von: SGS-Verteilung.
  • Vorbereitungsanleitung: Vor Gebrauch waschen.

'CustomFieldLink' Import-Endpunkt/URI –

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

Endpunktbeschreibung

Proben:

Mithilfe des Endpunkts „CustomFieldLink“ können wir eine Importdatei für die oben genannten Ergänzungen wie folgt strukturieren:

Beachten Sie hier, dass wir den Label-Parameter in diesen Import einschließen mussten, da wir die Gruppe „Vorbereitungsanweisungen“ erstellt haben. Für die Gruppe „Verteilt von“ benötigen wir dies nicht und können in unserem Import einfach auf den Namen der Gruppe verweisen.

Diese JSON-Beispieldatei kann heruntergeladen werden werden auf dieser Seite erläutert.

Und nachdem wir dies im System veröffentlicht haben, können wir sehen, dass unsere Beispielformeln der Gruppe „Verteilt von“ hinzugefügt wurden, mit ihrer eindeutigen Nachricht in der Spalte „Daten“ des unteren Bereichs:

Und wir können auch sehen, dass unsere neue Gruppe so erstellt wurde, dass für alle drei die gleichen „Vorbereitungsanweisungen“ gelten:

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

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

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

CSV-Dateiname importieren: „customFieldLink-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 werden wir unsere Waren den definierten benutzerdefinierten Feldgruppen zuordnen und außerdem eine neue Gruppe hinzufügen, wie oben definiert:

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:

Diese Beispielimportdatei kann heruntergeladen werden werden auf dieser Seite erläutert.

Im Unterschied zu unserem JSON-Import müssten wir in diesem Fall aufgrund des CSV-Importmechanismus den Label-Parameter „DIST“ für die Gruppe „Verteilt von“ einschließen.

Wir können diese Datei dann wie oben definiert in unseren Importordner ablegen. Sobald der Import abgeschlossen ist, können wir sehen, dass die benutzerdefinierten Feldgruppen entsprechend aktualisiert/hinzugefügt wurden:

Und: