AllergeneLink
La tua guida all'integrazione V5!
L'endpoint di importazione 'AllergenLink' può essere utilizzato per assegnare rapidamente le merci a allergene gruppi all'interno di V5 Traceability.
Questa guida si concentrerà su come utilizzare questo endpoint, sia tramite importazione CSV che tramite JSON tramite l'API V5.
Sommario
1. Gruppi di allergeni predefiniti
Il database V5 predefinito presenta un certo numero dei gruppi di allergeni più comuni, ma questo endpoint può essere utilizzato per crearne altri se necessario. I gruppi di allergeni standard inclusi possono essere visualizzati nello screenshot qui sotto:
Questo endpoint non è destinato ad essere utilizzato per la creazione di merci, ciò dovrebbe sempre essere fatto tramite 'Merce' punto finale.
2. Collegamenti API
Per saperne di più sulle definizioni di questo 'AllergenLink' e sulle classi di database correlate, consultare il seguente collegamento:
3. Guida sul campo AllergenLink
3.1. Chiavi primarie
Per entrambe le metodologie di importazione, le chiavi primarie sono:
Allergene_allergene – il nome del gruppo allergenico (ad esempio grano, glutine ecc.).
Codice_merci – Il codice univoco della merce da assegnare al Gruppo Allergeni.
3.2. Campi aggiuntivi
Altre opzioni che possiamo aggiungere dalla classe del database "Allergeni" sono:
Allergene_ColoreTesto – Consente l'immissione di un numero RGB per assegnare un colore al gruppo di allergeni. Nota che questo dovrebbe essere lo stesso per tutte le merci all'interno dello stesso gruppo di allergeni. Nota anche che quando si importano colori utilizzando questo metodo, i numeri RGB non devono essere separati da virgole (ad esempio 219 125 33 invece di 219, 125, 33).
4. Esempio di set di dati
Per questo articolo esamineremo un semplice set di dati di esempio contenente 5 ingredienti che potrebbero essere utilizzati durante la produzione:
Quindi qui assegneremo i seguenti gruppi di allergeni predefiniti a queste merci. Per le importazioni CSV assegneremo anche i colori del testo allo stesso tempo:
- Farina – Grano (rosso) e Glutine (viola)
- Formaggio – Latticini (giallo)
- Uova – Uovo (verde)
- Germogli di soia – Soia (blu)
- Mandorle – Noci (arancione)
5. Μεθοδολογία
5.1. JSON – Importa
Endpoint/URI di importazione 'AllergenLink' –
http://host:port/V5-API/api/integrate/import/allergen_link
Campioni:
Utilizzando l'endpoint 'AllergenLink', possiamo strutturare un file di importazione per le aggiunte di cui sopra come segue:
Questo file JSON di esempio può essere scaricato Qui..
Una volta pubblicato questo nel sistema, potremo vedere che tutti i nostri prodotti sono stati assegnati al gruppo di allergeni corretto, in questo caso le mandorle nella categoria "Frutta a guscio".
5.2. CSV – Importa
Per le importazioni CSV dobbiamo prima creare un file di intestazione per le nostre importazioni.
Nome file definizione intestazione/colonna: “allergenLink.csvh”
I file di intestazione completati devono essere inseriti in: “ \SG Control Center\gateway\import\def_colonna”
Importa nome file CSV: “allergenLink-datetime.csv”
I CSV per l'importazione devono essere inseriti in: “ \SG Control Center\gateway\import”
Campioni:
File di intestazione:
Di seguito è possibile vedere un file di intestazione di esempio. Qui assegneremo le nostre merci ai gruppi di allergeni definiti e aggiungeremo anche un colore ai gruppi:
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 usare l'ordine definito dei punti dati nell'intestazione per strutturare il nostro file di importazione. Nota che questa prima riga può essere ignorata da Control Center e quindi può essere mantenuta nel file quando si invia per l'importazione. Un esempio di importazione basato sui nostri requisiti di cui sopra sarebbe simile a questo:
Si noti ancora che non abbiamo bisogno delle virgole che normalmente separano i valori RGB. Questo file di importazione di esempio può essere scaricato Qui..
Possiamo quindi trascinare questo file nella nostra cartella di importazione come definito sopra e, una volta completata l'importazione, possiamo già vedere che i colori del testo del gruppo di allergeni sono stati aggiornati:
E se esaminiamo ogni gruppo vedremo che sono stati aggiunti gli allergeni desiderati:
