Jobs/Produktionsaufträge
Ihr Leitfaden zur V5-Integration!
Die Integration von Aufträgen/Produktionsaufträgen zwischen V5 Traceability und dem ERP-System eines Kunden ermöglicht die Planung von Arbeitsaufträgen für Chargen- und Produktformeln innerhalb von V5 Traceability. Mithilfe dieser Angaben können diese Aufträge dann vom V5-Terminal verarbeitet werden.
Inhaltsverzeichnis
1. Layout des Kontrollzentrums
Im Hinblick darauf, wie wir Jobdetails mit dem verknüpfen können, was wir im Control Center sehen, werden wir die V5-API hauptsächlich verwenden, um das obere „Job“-Panel zu füllen, um diese Details zu importieren und zu exportieren, mit Informationen im unteren „Job Line“-Panel wird basierend auf der Formel-/Rezepteinrichtung automatisch ausgefüllt.
Mit dem V5-Gateway können wir die Daten hier einfach mit dem füllen ‘Job’ Endpunkt. Es kann jedoch ein fortgeschrittenerer Ansatz gewählt werden, der die nutzt ‘PreBatch’ Endpunkt. Wir werden uns im Folgenden mit der Verwendung beider Möglichkeiten befassen.
2. API-Links
3. Integrationsvorlage
Die Integrationsvorlage für Jobs/Produktionsaufträge kann heruntergeladen werden werden auf dieser Seite erläutert.
4. Feldleitfaden für Aufträge/Produktionsaufträge
4.1. Primärschlüssel
Primärschlüssel sind die eindeutige Kennung für jede Tabelle innerhalb der V5-API. Für Job, diese sind:
jobNumber - Der eindeutige Identifikationscode für den Job.
formula.commodity.code – Der eindeutige Identifikationscode für die zu planende Formel.
Für PreBatch, die Primärschlüssel sind:
jobLine.job.jobNumber - Wie oben der eindeutige Identifikationscode für den Job.
BatchSeq – Die Produktionsreihenfolge der Charge für diese bestimmte Auftragslinie.
4.2. Benötigte Felder
Andere Felder werden von SG benötigt, um eine gültige Jobzeile im Control Center auszufüllen. Für Job, das ist:
products - Die Anzahl der Produkte, die pro Charge von der obersten (Job-)Zeile dieses Jobs benötigt werden (bezogen auf die Basis-ME der Formel).
Für PreBatch, das ist:
products - Die Anzahl der Produkte, die die einzelne Charge produzieren soll.
4.3. Bevorzugte Felder
Bevorzugte Felder dienen dazu, weitere Informationen zum jeweiligen Auftrag hinzuzufügen. Sie sind zwar nicht erforderlich, aber nützlich, wenn es um zusätzliche Funktionen in V5 Traceability geht. Für Job, dazu könnten gehören:
batchesRequired - Die Anzahl der für den Auftrag erforderlichen Stapel. Ist diese nicht vorhanden, verwendet das System die oben beschriebene Produktmenge und die Basisgröße + minimale/maximale Produkte um die Anzahl der zu produzierenden Chargen zu berechnen.
status - Der Status, mit dem der Job importiert wird (0 = Ausstehend, 1 = Geplant, 2 = In Bearbeitung, 3 = Abgeschlossen, 4 = Wird getestet, 5 = Angehalten). Jobs würden normalerweise mit dem Status „1“ importiert. es sei denn, sie sollen zu einem späteren Zeitpunkt manuell eingeplant werden und können daher mit dem Status „0“ importiert werden.
Diese Felder könnten auch zutreffen PreBatch Sobald wir zum Jobobjekt innerhalb der API übergegangen sind.
4.4. Weitere Felder
Für die können auch zusätzliche Felder eingebunden werden Job Endpunkt, wie zum Beispiel:
productionDate - Das Datum, an dem der Auftrag erstellt werden soll. Wird als leeres Feld importiert, wenn es nicht vorhanden ist, sodass die Jobs jederzeit von Terminals gesehen werden können.
Für PreBatch, Wir können zu demselben Feld weiter unten wechseln jobLine.job.productionDate. Wir können jedoch auch die verwenden jobLine.productionDate Dieses Feld hat Auswirkungen auf das Produktionsdatum der einzelnen Auftragszeile und nicht auf den gesamten Auftrag selbst, was uns eine genauere Kontrolle über unseren Produktionsprozess ermöglicht.
5. Methodik
Abhängig von der für unsere Integration verwendeten Methode können wir die folgenden Endpunkte verwenden, um Importe zu erleichtern. Dies kann entweder sein:
- ‘Job’ or ‘Prebatch’ Endpunkte für die JSON-Integration.
- ‘Job’ Endpunkt für die CSV-Fileshare-Integration.
Exporte können auf verschiedene Arten abgewickelt werden, die wir im Folgenden alle näher betrachten.
5.1. JSON – Importieren
Arbeit:
Wir können das nutzen ‘Job’ Endpunkt, um neue Jobs für die Produktion in V5 Traceability zu erstellen.
‘Job’ Endpunkt/URI importieren –
http://host:port/V5-API/api/integrate/import/job
Für diesen Beispielimport mit der ‘Job’ Endpunkt können wir eine grundlegende Importdatei für einen einzelnen Job wie folgt strukturieren:
Diese JSON-Beispieldatei kann heruntergeladen werden werden auf dieser Seite erläutert.
Anhand des API-Handbuchs können wir hier sehen, dass wir mehrere der Datenpunkte innerhalb der verwenden ‘Job’ Klasse, um diese Datei zu strukturieren. Um jedoch den Formelcode, den wir erstellen möchten, korrekt abzurufen, müssen wir zuerst zu dem durchlaufen ‘Formula’ Klasse, und verwenden Sie dann die ‘Commodity’ Klasse zum Definieren der ‘Code’ Erstellen Sie einen Datenpunkt, den wir verwenden können, und verschachteln Sie ihn dann entsprechend in der JSON-Datei, wie wir oben sehen können.
Nachfolgend finden Sie eine Zusammenfassung dieses Datenflussprozesses:
Wenn wir die JSON-Datei oben ausführen, sehen wir, dass unser Job jetzt auf der Registerkarte „Produktion“ im Control Center sichtbar ist.
Sie werden feststellen, dass dadurch automatisch die Jobzeilen im unteren Bereich erstellt wurden. Der ‘Job’ Der Endpunkt führt dies automatisch basierend auf dem aus Formelstruktur.
PreBatch:
Wir können oben sehen, dass wir das verwenden können ‘Job’ Endpunkt zur Eingabe einfacher Jobs in den Produktionsplan in V5 Traceability. Wenn wir jedoch eine genauere Kontrolle über die Einrichtung unseres Jobs wünschen, können wir dies nutzen ‘PreBatch’ Stattdessen URI. Dadurch können wir Details wie individuelle Losgröße/Produktanzahl und Produktionsstandort angeben.
‘PreBatch’ Endpunkt/URI importieren –
http://host:port/V5-API/api/integrate/import/pre_batch
Für diesen Beispielimport mit der ‘PreBatch’ Endpunkt können wir eine grundlegende Importdatei für einen einzelnen Auftrag mit mehreren Stapeln wie folgt strukturieren
Diese JSON-Beispieldatei kann heruntergeladen werden werden auf dieser Seite erläutert.
Wenn wir diese Datei untersuchen, können wir sehen, dass wir einen neuen Job (Job-111) mit zwei Chargen einer „Basic Bread Dough“-Formel erstellen, eine für 2 Pfund, die in Fertigung 30 hergestellt werden soll, und eine für 1 Pfund, die hergestellt werden soll hergestellt in der Fertigung 50. Wenn wir uns das API-Handbuch für ansehen ‘PreBatch’ Klasse, dann können wir hier eine ähnliche Traversierungsmethode sehen, die zum Erstellen unserer Datei im Spiel ist.
Wenn wir die obige JSON-Datei ausführen, wird dieser neue Auftrag erstellt. Wenn wir uns dann die Stapelansicht dafür ansehen, sehen wir die Unterschiede in den Stapelgrößen/Produktionsstandorten sowie in unseren voreingestellten Benutzerdefiniert Chargennummern. Auf Wunsch kann hier auch eine Batch-Sequenzierung einbezogen werden.
5.2. JSON – Exportieren
Im Hinblick auf den Rückempfang von Dateien, die sich auf Jobs beziehen, von der V5-API gibt es einige verschiedene Optionen sowohl der IntegrationExport- als auch der ExportTransaction-Klassen, die wir verwenden können und die wir uns hier ansehen werden.
Arbeit:
Einzelner Job-Export-Endpunkt/URI –
http://host:port/V5-API/api/integrate/export/job/{jobNumber}
Dieser Endpunkt exportiert eine JSON-Datei mit allen zugehörigen Informationen für den angegebenen Job. Wenn wir diese Anfrage mit der Jobnummer des gerade importierten Jobs ausführen, erhalten wir eine Datei, die etwa so aussieht:
Eine Beispiel-JSON-Datei dieses Typs kann heruntergeladen werden werden auf dieser Seite erläutert.
Alle Jobs:
Alle Jobs exportieren Endpunkt/URI
http://host:port/V5-API/api/integrate/export/jobs
Dieser Endpunkt exportiert eine JSON-Datei, die eine Liste aller enthält aktiv Jobs im System, definiert als Jobs, die einen anderen Status als „abgeschlossen“ haben oder aus dem Control Center gelöscht wurden.
Wenn wir diese Anfrage ausführen, erhalten wir eine JSON-Rückgabedatei, die weitgehend genauso aufgebaut ist wie der obige Export für einen einzelnen Job, aber wie erwähnt alle aktiven Jobs umfasst.
Beispiel-JSON-Dateien dieses Typs können heruntergeladen werden werden auf dieser Seite erläutert.
können wir auch verwerten Transaktions- und Protokollendpunkte um relevantere Informationen zu Aufträgen und Produktionsaufträgen abzurufen.
Für Systemprotokoll Endpunkte sind dies:
5.3. CSV – Importieren
Dateiname der Kopf-/Spaltendefinition: “job.csvh”
Fertige Header-Dateien sollten abgelegt werden in: “<installdir>\SG Control Center\gateway\import\column_defs”
CSV-Dateiname importieren: “job-datetime.csv”
CSVs für den Import sollten abgelegt werden in: “<installdir>\SG Control Center\gateway\import”
Header-Datei:
Header-Dateien werden im Allgemeinen von SG Systems kompiliert, bevor CSV-Integrationen stattfinden. Wir sehen jedoch ein einfaches Beispiel für eine Datei, die wir für Jobs verwenden können, indem wir die zuvor definierten Dateien verwenden Klassendefinitionenunten:
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:
Anschließend können wir die definierte Reihenfolge der Datenpunkte im Header verwenden, um unsere Importdatei zu strukturieren. SG Systems kann hierfür eine Vorlagendatei bereitstellen, die den Datenpunkt für jede Spalte auflistet, um die Dinge beim Ausfüllen der Liste klarer zu gestalten. Beachten Sie, dass diese erste Zeile vom Control Center ignoriert werden kann und daher bei der Übermittlung zum Import in der Datei beibehalten werden kann.
Eine Beispiel-CSV-Importdatei für Jobs könnte etwa so aussehen:
Diese Beispielimportdatei kann heruntergeladen werden werden auf dieser Seite erläutert.
Nach Abschluss des Imports können wir sehen, dass diese zusätzlichen Jobs neben dem Job, den wir oben mit dem JSON-Import erstellt haben, zum Control Center hinzugefügt wurden.
5.4. CSV – Exportieren
Wie bei JSON-Exporten haben wir hier verschiedene Möglichkeiten. Wir können damit beginnen, einfach eine Liste von Jobs innerhalb des Systems zu exportieren:
Jobs/Zeitplan:
CSV-Dateiname exportieren: “job.csvh”
Fertige Header-Dateien sollten abgelegt werden in: “<installdir>\SG Control Center\gateway\export/order”
CSV-Dateiname exportieren: “job-datetime.csv”
CSVs für Exporte werden generiert in: “<installdir>\SG Control Center\gateway\export”
Wir können die zuvor definierten Klassendefinitionen verwenden, um eine Header-Datei zu strukturieren und zu definieren, welche Daten wir zurückerhalten.
Dieser Export müsste im Gateway-Bereich des Control Centers aktiviert werden. Wir können hier wählen, „Zeitplan“ zu exportieren.
Header-Datei:
In diesem Fall verwenden wir einfach dieselbe Header-Datei, die wir oben für den Import verwendet haben:
CSV-Exportdatei:
Wir würden eine CSV-Rückgabedatei erhalten, die etwa so aussehen würde:
Ein Beispiel dieses Dateityps kann heruntergeladen werden werden auf dieser Seite erläutert. Beachten Sie, dass, wenn im angegebenen Ordner keine Header-Datei vorhanden ist, eine CSV-Datei exportiert wird, die alle Datenpunkte im Ordner enthält ‘Job’ Klasse.
Während dieser Endpunkt nur eine Liste von Jobs exportiert, können wir verschiedene Endpunkte verwenden, um detailliertere Informationen zu Verbrauch und Produktion abzurufen.
Chargenprotokolle:
CSV-Dateiname exportieren: “BatchLog-datetime.csv”
CSVs für Exporte werden generiert in: “<installdir>\SG Control Center\gateway\export”
Der einfachste Weg, Auftragsproduktionsdaten von V5 Traceability in Form einer CSV zurückzuerhalten, besteht darin, einfach „Batch-Protokolle“ zu verwenden und zu verarbeiten.
Auch dieser Export müsste im Gateway-Bereich des Control Centers aktiviert werden. Wir können hier wählen, „Batch-Protokolle“ zu exportieren.
CSV-Exportdatei:
Wir müssten hier keine Header-Datei erstellen, da das V5-Gateway standardmäßig eine festgelegte Liste von Datenpunkten füllt. Wenn dieser Export aktiviert ist, exportiert das System eine ‘BatchLog’ Datei jedes Mal, wenn ein Stapel innerhalb eines Auftrags vom System abgeschlossen wird. Ein einfaches Beispiel hierfür ist unten dargestellt:
Ein Beispiel dieses Dateityps kann heruntergeladen werden werden auf dieser Seite erläutert.
Systemprotokoll:
Wenn wir individuellere oder detailliertere Auftragsproduktionsdaten erhalten möchten (‘CONSUMED’/’PRODUCE’) Zurück von V5 Traceability können wir jedoch davon Gebrauch machen ‘SystemLog’ Endpunkt, um dies zu tun.
Dateiname der Kopf-/Spaltendefinition: “SystemLog.csvh”
Fertige Header-Dateien sollten abgelegt werden in: “<installdir>\SG Control Center\gateway\export\order”
CSV-Dateiname exportieren: “SystemLog-datetime.csv”
CSVs für Exporte werden generiert in: “<installdir>\SG Control Center\gateway\export”
Für diese Art von Export unter Verwendung dieses Endpunkts würden wir unseren Header mithilfe von strukturieren ‘SystemLog’ Datenbankklassendefinitionen.
Wie bei den anderen Beispielen oben müsste dieser Export im Gateway-Bereich des Control Centers aktiviert werden:
Header-Datei:
Von hier aus können wir unseren Header danach strukturieren, welche Transaktionsdaten zu Aufträgen wir zurück an das ERP erhalten möchten. Für unsere Zwecke hier könnte das so aussehen:
Diese Beispiel-Header-Datei kann heruntergeladen werden werden auf dieser Seite erläutert.
CSV-Exportdatei:
Wenn wir dann einen einfachen Batch ausführen, sieht der Systemprotokollexport dafür etwa so aus:
Dieser Beispielexport kann heruntergeladen werden werden auf dieser Seite erläutert.
