Lavori/Ordini di produzione
La tua guida all'integrazione V5!
L'integrazione di lavori/ordini di produzione tra V5 Traceability e il sistema ERP di un cliente consente di programmare ordini di lavoro per formule di lotti e prodotti all'interno di V5 Traceability. Questi dettagli consentiranno quindi a questi lavori di essere elaborati dal Terminale V5.
Sommario
1. Layout del centro di controllo
In termini di come possiamo mettere in relazione i dettagli del lavoro con ciò che vediamo nel Centro di controllo, utilizzeremo l'API V5 principalmente per popolare il pannello "Lavoro" superiore per importare ed esportare questi dettagli, con le informazioni nel pannello "Linea di lavoro" inferiore essere popolato automaticamente in base all'impostazione della formula/ricetta.
Utilizzando il Gateway V5 possiamo facilmente popolare i dati qui utilizzando il file ‘Job’ punto finale. Tuttavia, è possibile adottare un approccio più avanzato che utilizzi il file ‘PreBatch’ punto finale. Di seguito esamineremo l'utilizzo di entrambi.
2. Collegamenti API
3. Modello di integrazione
È possibile scaricare il modello di integrazione per Commesse/Ordini di Produzione Qui..
4. Guida sul campo dell'ordine di lavoro/produzione
4.1. Chiavi primarie
Le chiavi primarie sono l'identificatore univoco per ogni tabella all'interno dell'API V5. Per Job, questi sono:
jobNumber - Il codice identificativo univoco della mansione.
formula.commodity.code – Il codice identificativo univoco della formula da schedulare.
Per PreBatch, le chiavi primarie sono:
jobLine.job.jobNumber - Come sopra, il codice identificativo univoco della mansione.
BatchSeq – La sequenza di produzione del lotto per quella particolare linea di lavoro.
4.2. Campi richiesti
Altri campi sono richiesti da SG per compilare una riga di lavoro valida in Control Center. Per Job, questo è:
products - Il numero di prodotti richiesti (correlati all'unità di misura di base della formula) per lotto dalla riga superiore (lavoro) di questo lavoro.
Per PreBatch, questo è:
products - Il numero di prodotti che il singolo lotto dovrebbe produrre.
4.3. Campi preferiti
I campi preferiti servono per aggiungere ulteriori informazioni sul lavoro in questione e, sebbene non siano obbligatori, sono utili quando si tratta di funzionalità aggiunte all'interno di Tracciabilità V5. Per Job, questi potrebbero includere:
batchesRequired - Il numero di batch richiesti per il lavoro. Se questo non è presente allora il sistema utilizzerà la quantità di prodotti (descritta sopra) e il dimensione base + prodotti min/max per calcolare il numero di lotti da produrre.
status - Lo stato con cui il lavoro verrà importato (0 = In sospeso, 1 = Pianificato, 2 = In corso, 3 = Completo, 4 = In prova, 5 = In sospeso), i lavori verrebbero solitamente importati con lo stato '1', a meno che non debbano essere pianificati manualmente in un secondo momento e quindi possano essere importati con lo stato '0'.
Questi campi potrebbero applicarsi anche a PreBatch una volta passati all'oggetto lavoro all'interno dell'API.
4.4. Campi aggiuntivi
È possibile includere anche campi aggiuntivi per il file Job endpoint, come ad esempio:
productionDate - La data in cui deve essere prodotto il lavoro. Verrà importato come vuoto se non presente, consentendo ai terminali di vedere i lavori in ogni momento.
Per PreBatch, possiamo attraversare questo stesso campo sotto jobLine.job.productionDate. Tuttavia, possiamo anche utilizzare il file jobLine.productionDate campo per influenzare la data di produzione della singola linea di lavoro piuttosto che l'intero lavoro stesso, consentendoci un controllo più rigoroso sul nostro processo di produzione.
5. Μεθοδολογία
A seconda del metodo utilizzato per la nostra integrazione, possiamo utilizzare i seguenti endpoint per facilitare le importazioni. Questo può essere:
- ‘Job’ or ‘Prebatch’ endpoint per l'integrazione JSON.
- ‘Job’ endpoint per l'integrazione della condivisione di file CSV.
Le esportazioni possono essere gestite in vari modi, che vedremo di seguito.
5.1. JSON – Importa
Lavoro:
Possiamo utilizzare il ‘Job’ endpoint per creare nuovi lavori per la produzione in V5 Traceability.
‘Job’ importa endpoint/URI –
http://host:port/V5-API/api/integrate/import/job
Per questo esempio importare utilizzando il file ‘Job’ endpoint, possiamo strutturare un file di importazione di base per un singolo lavoro come di seguito:
Questo file JSON di esempio può essere scaricato Qui..
Usando il manuale dell'API, possiamo vedere qui che stiamo utilizzando molti dei punti dati all'interno di ‘Job’ class per strutturare questo file. Tuttavia, per richiamare correttamente il codice della formula che vogliamo produrre dobbiamo prima passare al file ‘Formula’ classe, quindi utilizzare il file ‘Commodity’ classe per definire il ‘Code’ datapoint che possiamo utilizzare, quindi annidarlo in modo appropriato nel file JSON, come possiamo vedere sopra.
Di seguito possiamo vedere un riepilogo di questo processo di flusso di dati:
Se eseguiamo il file JSON sopra, vedremo che il nostro lavoro è ora visibile nella scheda "Produzione" nel Centro di controllo.
Noterai che questo ha creato automaticamente le righe di lavoro nel pannello inferiore. IL ‘Job’ endpoint lo farà automaticamente in base a struttura della formula.
Pre-batch:
Possiamo vedere sopra che possiamo usare il file ‘Job’ endpoint per inserire lavori semplici nel piano di produzione in V5 Traceability. Tuttavia, se desideriamo un controllo più preciso sulla configurazione del nostro lavoro, possiamo utilizzare il file ‘PreBatch’ URI invece. Ciò ci consente di specificare dettagli come la dimensione del singolo lotto/il conteggio dei prodotti e il luogo di produzione.
‘PreBatch’ importa endpoint/URI –
http://host:port/V5-API/api/integrate/import/pre_batch
Per questo esempio importare utilizzando il file ‘PreBatch’ endpoint, possiamo strutturare un file di importazione di base per un singolo lavoro con più batch come di seguito
Questo file JSON di esempio può essere scaricato Qui..
Quindi possiamo vedere esaminando questo file che stiamo creando un nuovo lavoro (Job-111) con 2 lotti di una formula di "Impasto di pane base", uno per 30 libbre, da realizzare nella produzione 1, e uno per 50 libbre, da realizzare made in manufacturing 2. Se guardiamo il manuale API per il ‘PreBatch’ class, allora possiamo vedere un metodo di attraversamento simile in gioco qui per costruire il nostro file.
Se eseguiamo il file JSON di cui sopra, vedremo creato questo nuovo lavoro e poi, se diamo un'occhiata alla visualizzazione batch, vedremo le differenze nelle dimensioni dei batch/località di produzione, nonché le nostre impostazioni personalizzate preimpostate. numeri di lotto. Se lo si desidera, è possibile includere qui anche il sequenziamento batch.
5.2. JSON – Esporta
In termini di ricezione di file relativi ai lavori dall'API V5, ci sono alcune opzioni diverse dalle classi IntegrationExport ed ExportTransaction che possiamo utilizzare, che esamineremo qui.
Lavoro:
Endpoint/URI di esportazione del lavoro individuale –
http://host:port/V5-API/api/integrate/export/job/{jobNumber}
Questo endpoint esporterà un file JSON con tutte le informazioni correlate per il lavoro specificato. Se eseguiamo questa richiesta utilizzando il numero di lavoro per il lavoro che abbiamo appena importato, otterremo un file simile a questo:
È possibile scaricare un file JSON di esempio di questo tipo Qui..
Tutti i lavori:
Tutti i processi esportano endpoint/URI
http://host:port/V5-API/api/integrate/export/jobs
Questo endpoint esporterà un file JSON che include un elenco di tutti attivo lavori nel sistema, definiti come lavori che hanno uno stato diverso da "completato" o che sono stati eliminati da Control Center.
Se eseguiamo questa richiesta, riceveremo un file JSON di ritorno strutturato in modo molto simile all'esportazione di cui sopra per un singolo lavoro, ma come accennato includerà tutti i lavori attivi.
È possibile scaricare un file JSON di esempio di questo tipo Qui..
Possiamo anche utilizzare endpoint transazionali e di registro per recuperare informazioni più rilevanti sui lavori e sugli ordini di produzione.
Per Registro di sistema endpoint, questi sono:
5.3. CSV – Importa
Nome file definizione intestazione/colonna: “job.csvh”
I file di intestazione completati devono essere inseriti in: “<installdir>\SG Control Center\gateway\import\column_defs”
Importa nome file CSV: “job-datetime.csv”
I CSV per l'importazione devono essere inseriti in: “<installdir>\SG Control Center\gateway\import”
File di intestazione:
I file di intestazione verranno generalmente compilati da SG Systems prima che avvengano le integrazioni CSV, ma possiamo vedere un esempio di base di uno che possiamo utilizzare per i lavori, utilizzando il file precedentemente definito definizioni di classe, sotto:
Per ulteriori informazioni su come strutturiamo questi file, consultare il file pagina principale di integrazione. Questo file di intestazione di esempio può essere scaricato Qui..
File di importazione CSV:
Possiamo quindi utilizzare l'ordine definito dei punti dati nell'intestazione per strutturare il nostro file di importazione. SG Systems può fornire un file modello per questo, elencando il punto dati per ogni colonna per rendere le cose più chiare durante la compilazione dell'elenco. Si noti che questa prima riga può essere ignorata da Control Center e quindi può essere conservata nel file durante l'invio per l'importazione.
Un esempio di file di importazione CSV per i lavori potrebbe assomigliare a questo:
Questo file di importazione di esempio può essere scaricato Qui..
Una volta completata l'importazione, possiamo vedere che questi lavori aggiuntivi sono stati aggiunti al Centro di controllo insieme al lavoro che abbiamo creato utilizzando l'importazione JSON sopra.
5.4. CSV – Esporta
Come per le esportazioni JSON, anche qui abbiamo un paio di opzioni diverse. Possiamo iniziare semplicemente esportando un elenco di lavori all'interno del sistema:
Lavori/Programma:
Esporta nome file CSV: “job.csvh”
I file di intestazione completati devono essere inseriti in: “<installdir>\SG Control Center\gateway\export/order”
Esporta nome file CSV: “job-datetime.csv”
I CSV per le esportazioni verranno generati in: “<installdir>\SG Control Center\gateway\export”
Possiamo utilizzare le definizioni di classe definite in precedenza per strutturare un file di intestazione per definire quali dati recupereremo.
Questa esportazione dovrebbe essere abilitata nella sezione Gateway del Centro di controllo. Possiamo scegliere qui di esportare 'Pianificazione'.
File di intestazione:
In questo caso utilizziamo semplicemente lo stesso file di intestazione che abbiamo utilizzato sopra per l'importazione:
File di esportazione CSV:
Otterremmo un file CSV di ritorno simile a questo:
È possibile scaricare un esempio di questo tipo di file Qui.. Tieni presente che se un file di intestazione non è presente nella cartella indicata, verrà esportato un CSV che include tutti i punti dati nel file ‘Job’ classe.
Anche se questo endpoint esporterà solo un elenco di lavori, possiamo utilizzare un paio di endpoint diversi per recuperare informazioni più dettagliate relative al consumo e alla produzione.
Registri batch:
Esporta nome file CSV: “BatchLog-datetime.csv”
I CSV per le esportazioni verranno generati in: “<installdir>\SG Control Center\gateway\export”
Il modo più semplice per recuperare i dati di produzione dei lavori da V5 Traceability sotto forma di CSV è semplicemente utilizzare ed elaborare i "registri batch".
Ancora una volta, anche questa esportazione dovrà essere abilitata nella sezione Gateway del Centro di controllo. Possiamo scegliere qui di esportare i "Registri batch".
File di esportazione CSV:
Non avremmo bisogno di creare un file di intestazione qui poiché il gateway V5 popolerà un elenco prestabilito di punti dati per impostazione predefinita. Con questa esportazione abilitata, il sistema esporterà un file ‘BatchLog’ file ogni volta che un batch all'interno di un lavoro viene completato dal sistema. Un esempio di base di ciò è mostrato di seguito:
È possibile scaricare un esempio di questo tipo di file Qui..
Registro di sistema:
Se desideriamo ricevere dati di produzione del lavoro più personalizzati o dettagliati (‘CONSUMED’/’PRODUCE’) dalla Tracciabilità V5, tuttavia, possiamo utilizzare il file ‘SystemLog’ endpoint per eseguire questa operazione.
Nome file definizione intestazione/colonna: “SystemLog.csvh”
I file di intestazione completati devono essere inseriti in: “<installdir>\SG Control Center\gateway\export\order”
Esporta nome file CSV: “SystemLog-datetime.csv”
I CSV per le esportazioni verranno generati in: “<installdir>\SG Control Center\gateway\export”
Per questo tipo di esportazione utilizzando questo endpoint, struttureremo la nostra intestazione utilizzando il file ‘SystemLog’ definizioni delle classi del database.
Come per gli altri esempi precedenti, questa esportazione dovrebbe essere abilitata nella sezione Gateway del Centro di controllo:
File di intestazione:
Da qui possiamo strutturare la nostra intestazione a seconda dei dati transazionali relativi ai lavori che vogliamo ricevere all'ERP. Per i nostri scopi qui questo potrebbe assomigliare a questo:
Questo file di intestazione di esempio può essere scaricato Qui..
File di esportazione CSV:
Se poi eseguiamo un batch semplice, l'esportazione del registro di sistema sarà simile a questa:
Questo esempio di esportazione può essere scaricato Qui..
