Formule

L'integrazione delle Formule tra V5 Traceability e il sistema ERP del cliente consente di importare formule/ricette/distinta base, dove possono poi essere programmate tramite ordini di lavoro per produrre lotti or prodotti utilizzando il terminale V5.

Per ulteriori informazioni su come funziona il modulo di formulazione in V5 Traceability, consultare la nostra guida al modulo Qui..

1. Layout del centro di controllo
2. Collegamenti API
3. Modello di integrazione
4. Guida al campo delle formule
   1. Chiavi primarie
   2. Campi obbligatori
   3. Campi preferiti
   4. Campi aggiuntivi
5. Metodologia
   1. JSON – Importa
   2. JSON – Esporta
   3. CSV – Importa
   4. CSV – Esporta
   5. Proteggi le formule

In termini di come possiamo mettere in relazione i dettagli della formula con ciò che vediamo nel Centro di controllo, utilizzeremo l'API V5 e il Gateway per popolare sia la parte superiore ‘Formula’ pannello per inserire i dati dell'intestazione della formula, nonché quello inferiore ‘Formula Step’ pannello per popolare i dettagli del passaggio della formula.

 

A seconda del nostro metodo di integrazione, utilizzeremo il file ‘Formula’ e ‘FormulaStep’ endpoint per popolare entrambi questi pannelli e completare la configurazione della nostra formula.

Per ulteriori informazioni sulle definizioni di queste classi di database, consultare i seguenti collegamenti:

Formula

FormulaPasso

È possibile scaricare il modello di integrazione per le Formule Qui..

Le chiavi primarie sono l'identificatore univoco per ogni tabella all'interno dell'API V5. Per Formula, questo è:

commodity.code – Il codice merceologico sottostante della formula. Il numero della formula/ricetta.

Per FormulaStep, le chiavi primarie sono:

formula.commodity.code – Lo stesso codice merceologico per la formula stessa come descritto sopra.

sequence – Utilizzato per determinare l'ordine dei singoli passaggi della formula all'interno dell'impostazione di una formula, ovvero 1, 2, 3 ecc.

Altri campi richiesti da SG per compilare una riga di formula valida nel Centro di controllo sono:

Per Formula:

type - Il tipo di formula. Dovrebbe essere 0 (per una formula batch) o 1 (per una formula di prodotto).

defaultSize - il 'Dimensione base’ della formula in questione.

commodity.units.code – L'unità di peso in cui deve essere prodotta la formula. Se non specificato, ciò creerà la formula nell'unità di misura predefinita del database.

Per FormulaStep:

type - la formula passo Digitare.

I tipi di passaggi sono i seguenti:

0 – Pesare
1 – Inserimento chiave
2 – Domanda
3 – Messaggio
4 – Cambio Contenitore
5 – Componente del Prodotto
6 – Confezione del Prodotto
7 – Sottomix
8 – Collazione
9 - Dispersione sfusa
10 – Opzionale
11 – Scansione
12 - Rivedere
13 – Sospendere

I campi preferiti servono per aggiungere ulteriori informazioni rispetto alla formula in questione e, sebbene non obbligatori, sono utili quando si tratta di funzionalità aggiunte all'interno di Tracciabilità V5.

Per Formula questi campi sono:

commodity.units.code – L'unità di peso in cui deve essere prodotta la formula. Se non specificato, ciò creerà la formula nell'unità di misura predefinita del database.

minimumProducts - La dimensione minima del lotto che può essere prodotto

maximumProducts – La dimensione massima del lotto che può essere prodotto.

Per FormulaStep questi campi sono:

sequence – la sequenza della fase della formula, ovvero in quale ordine deve essere elaborata durante la produzione.

commodity.code – la merce/ingrediente da utilizzare per la fase specifica

targetQty – il peso target per la fase specifica

unit.code – l'unità di misura di quella particolare fase

question.question– Se questo passaggio deve essere una domanda o un messaggio, è possibile inserirlo utilizzando questo campo.

Possiamo, come abbiamo visto nelle sezioni delle chiavi primarie e dei campi obbligatori, spostarci tra questi 2 'formula' e 'formulaStep' e quindi possiamo includere i punti dati di cui sopra da utilizzare con entrambe le classi, a condizione che possiamo raggiungere quella classe con successo.

È possibile includere anche campi aggiuntivi, ad esempio for FormulaStep:

upperTol - La tolleranza superiore per quel particolare passaggio, ovvero il limite massimo in cui il peso può superare la quantità target, affinché sia ​​accettabile quando viene prodotta la formula.

lowerTol – La tolleranza inferiore per quel particolare passaggio, ovvero il limite massimo in cui il peso può essere inferiore alla quantità target per essere accettabile quando viene prodotta la formula.

schedule – Se il passaggio deve essere pianificato quando viene prodotta la formula. Utile per i passaggi che sono submix e devono essere prodotti contemporaneamente a una formula principale.

Come discusso in precedenza, potremmo comunque utilizzare questi punti dati quando utilizziamo il file ‘formula’ punto finale, semplicemente attraversando il ‘formulaStep’ classe aggiungendo ‘formulaStep’ a ciascuno di quanto sopra.

A seconda della nostra metodologia di integrazione per le formule, generalmente utilizzeremmo endpoint diversi; Per l'integrazione API generalmente utilizzeremmo ‘Formula’e per CSV ‘FormulaStep’. Possiamo dare un'occhiata a entrambi ora e vedere perché è così.

Formula:

Possiamo utilizzare il ‘Formula’ endpoint per creare nuove formule per la produzione in Tracciabilità V5. Come vedremo, l'utilizzo di questo endpoint ci consente facilmente di acquisire sia l'intestazione della formula che le informazioni sul passaggio in 1 file.

‘Formula’ importa endpoint/URI –

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

Descrizione dell'endpoint

Per questo esempio importare utilizzando il file ‘Formula’ endpoint, possiamo strutturare un file di importazione di base per una singola formula con 2 passaggi della formula come di seguito:

Questo file JSON di esempio può essere scaricato Qui..

Utilizzando il manuale dell'API, possiamo tracciare i percorsi che stiamo utilizzando per raggiungere le varie classi che dobbiamo utilizzare per questa importazione. Nel ‘Formula’ class possiamo vedere che tutto ciò che stiamo usando qui è il file ‘type’ e ‘productionLocation’. Da qui dobbiamo definire la nostra formula di informazioni sulle materie prime, cosa che possiamo fare attraversando ‘Formula’ a ‘Commodity’. Qui possiamo inserire le informazioni sulla merce per la formula stessa (il suo codice, descrizione ecc.).

Per definire quindi i passaggi della formula, dobbiamo prima passare al ‘FormulaStep’ classe, dove possiamo definire il tipo di passo, la quantità target, le tolleranze ecc. Da qui, passeremo nuovamente alla ‘Commodity’ classe, tranne che qui, a causa del percorso che abbiamo intrapreso per raggiungere la classe, definiremo le informazioni sulla merce per l'ingrediente da utilizzare per uno specifico passaggio della formula, piuttosto che le informazioni di intestazione che abbiamo già definito sopra.

Da qui attraverseremmo quindi da entrambi i ‘Commodity’ lezioni per arrivare al ‘WeightUnit’ classe, dove possiamo definire l'UM sia per la formula stessa, sia per ogni singolo passaggio. Quindi, anche se stiamo usando la stessa classe per questo, l'abbiamo raggiunta in 2 modi diversi, il che si riflette nelle definizioni che possiamo vedere (commodity.units.code vs formulaStep.commodity.units.code), permettendoci di utilizzare diverse UoM, se lo desideriamo.

Possiamo vedere un riepilogo del pathfinding richiesto per produrre il file JSON sopra qui:

Possiamo costruire il resto dei nostri punti dati richiesti utilizzando un metodo di ricerca del percorso simile.

Se eseguiamo il file JSON sopra, vedremo che questa nuova formula, insieme ai suoi passaggi, è ora visibile nella scheda "Formule" nel Centro di controllo.

Passo della formula:

‘FormulaStep’ importa endpoint/URI –

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

Descrizione dell'endpoint

Per questo esempio importare utilizzando il file ‘FormulaStep’ endpoint, esamineremo l'importazione della stessa formula che abbiamo fatto sopra, ma cambieremo semplicemente il suo nome. Utilizzando questo endpoint possiamo strutturare questo file come di seguito:

Possiamo anche utilizzare il ‘FormulaStep’ endpoint per creare nuove formule per la produzione in V5 Traceability. Funzionerebbe in gran parte allo stesso modo dell'utilizzo ‘Formula’ sopra, ma dovremmo effettivamente attraversare le classi del database al contrario, quindi invece di andare da ‘Formula’ a ‘FormulaStep’, verremmo da ‘FormulaStep’ a ‘Formula’. Possiamo vedere come funzionerebbe di seguito:

Questo file JSON di esempio può essere scaricato Qui..

Come possiamo vedere qui, stiamo inserendo le stesse informazioni in termini di passaggi e stiamo semplicemente cambiando il nome della formula. Nota qui la traversata da ‘formulaStep’ classe al ‘formula’ classe e il fatto che queste informazioni devono essere annidate per ogni passaggio della formula.

Se ora eseguiamo questo file JSON di esempio, la nostra formula duplicata verrà ora creata con le stesse impostazioni che abbiamo visto quando utilizzavamo il file ‘Formula’ punto finale.

In termini di ricezione di file relativi a formule/ricette dall'API V5, qui non stiamo realmente monitorando i dati di consumo, quindi esporteremo semplicemente la configurazione/impostazione di una formula. Ci sono ancora alcune opzioni per questo se controlliamo quelle disponibili ‘IntegrationExport’ servizi:

Formula:

Esporta endpoint/URI –

http://host:port/V5-API/api/integrate/export/formula/{code}

Descrizione dell'endpoint

Questo endpoint esporterà un file JSON con tutte le informazioni correlate per una formula specifica. Se eseguiamo questa richiesta GET per la formula che abbiamo creato tramite il file ‘Formula’ endpoint, otterremo un file di ritorno simile a questo:

È possibile scaricare un file JSON di esempio Qui..

All Formulas:

Esporta endpoint/URI –

http://host:port/V5-API/api/integrate/export/formulas

Descrizione dell'endpoint

Questo endpoint esporterà un file JSON che include un elenco di tutte le formule contenute nel sistema. Tieni presente che ciò restituirà solo i dati di intestazione per ciascuna formula. Per recuperare i passaggi della formula, vedere di seguito.

È possibile scaricare un file JSON di esempio di questo tipo Qui..

Passaggio della formula:

Esporta endpoint/URI –

http://host:port/V5-API/api/integrate/export/formula_step/{code}/{sequence}

Descrizione dell'endpoint

Questo endpoint può essere configurato per restituire dati per un passaggio specifico di una formula specifica. Specifichiamo quale passaggio vogliamo recuperare utilizzando il relativo numero di sequenza. Se raggiungiamo questo endpoint per recuperare il passaggio 1 della prima formula di esempio che abbiamo creato sopra, otterremo un risultato simile a questo:

Questo file JSON di esempio può essere scaricato Qui..

Passaggi della formula:

Esporta endpoint/URI –

http://host:port/V5-API/api/integrate/export/formula_steps/{all}

Descrizione dell'endpoint

Questo endpoint fornisce un elenco di tutti i passaggi della formula all'interno del sistema. Possiamo modificare il rendimento utilizzando uno dei due ‘/true’ or ‘/false’ al posto di ‘/{all}’ nell'URI sopra. ‘True’ esporterà un elenco di tutti i passaggi nel sistema, mentre ‘false’ restituirà un elenco di passaggi non contrassegnati come già esportati.

Il layout sarebbe molto simile all'esempio sopra, solo con più passaggi presenti. Un esempio di a ‘true’ è possibile scaricare un'esportazione di questo tipo Qui..

Nota: una volta importate, le formule possono essere protette da qualsiasi modifica selezionando la casella "Esente da importazione" nell'intestazione della formula in Control centerQuesto si applica solo alla metodologia CSV.

Abbiamo visto negli esempi JSON precedenti che possiamo utilizzare sia il file ‘formula’ e ‘formulaStep’ endpoint per quella particolare metodologia. Tuttavia, per le importazioni CSV utilizzeremo solo il file ‘formulaStep’ punto finale.

Nome file definizione intestazione/colonna: “formulaStep.csvh”

I file di intestazione completati devono essere inseriti in: “<installdir>\SG Control Center\gateway\import\column_defs”

Importa nome file CSV: “formulaStep-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 abbiano luogo le integrazioni CSV, ma di seguito possiamo vedere un esempio di base che possiamo utilizzare per i lavori:

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.

Ancora una volta creeremo una formula duplicata delle 2 che abbiamo creato tramite il metodo JSON sopra. Un esempio di file di importazione CSV per una formula potrebbe assomigliare a questo:

Questo file di importazione di esempio può essere scaricato Qui..

Una volta completata l'importazione, possiamo vedere che questa formula aggiuntiva è stata aggiunta al Centro di controllo con gli stessi passaggi delle formule che abbiamo creato utilizzando le importazioni JSON sopra.

Per le nostre esportazioni CSV, utilizzeremo semplicemente lo stesso ‘formulaStep’ file di intestazione/endpoint come sopra per le importazioni. Questo può essere scaricato Qui..

Nome file definizione intestazione/colonna: “formulaStep.csvh”

I file di intestazione completati devono essere inseriti in: “<installdir>\SG Control Center\gateway\export\order”

Esporta nome file CSV: “FormulaStep-datetime.csv”

I CSV per le esportazioni verranno generati in: “<installdir>\SG Control Center\gateway\export”

Questo è l'unico modo per recuperare i dati della formula da V5 Traceability sotto forma di CSV.

Questa esportazione dovrà essere abilitata anche nella sezione Gateway del Centro di controllo. Possiamo scegliere qui di esportare ‘Formulas’.

File di intestazione:

Per questo esempio possiamo utilizzare per l'esportazione l'intestazione precedentemente utilizzata per l'importazione. Se lo si desidera, è possibile aggiungere ulteriori punti dati a questo.

File di esportazione CSV:

Abilitando questa esportazione utilizzando l'intestazione utilizzata in precedenza si otterrebbe un file di esportazione per le nostre 3 nuove formule che sarebbe simile a questo:

Caratteristica esclusiva del meccanismo di importazione CSV è la presenza di una casella di controllo "Protetto" accanto all'intestazione della formula nel Centro di controllo:

Se questa opzione è selezionata, la formula sarà protetta da eventuali modifiche apportate dalle successive importazioni CSV di formulaStep.

Come indicato sopra, questa è una caratteristica esclusiva della metodologia di importazione CSV: selezionando questa casella non verrà protetta una formula dagli aggiornamenti tramite JSON/API.