HazardLink

L'endpoint di importazione 'HazardLink' può essere utilizzato per assegnare rapidamente le merci ai gruppi di pericolo all'interno del sistema di tracciabilità V5.

Questa guida si concentrerà su come utilizzare questo endpoint, sia tramite importazione CSV che tramite JSON tramite l'API V5.

1. Gruppi di pericolo predefiniti
2. Collegamenti API
3. Guida sul campo HazardLink
   1. Chiavi primarie
   2. Campi aggiuntivi
4. Esempio di set di dati
5. Metodologia
   1. 1. JSON – Importa
      2. CSV – Importa

Il database V5 predefinito presenta un certo numero dei gruppi di pericoli più comuni, ma questo endpoint può essere utilizzato per crearne altri se necessario. I gruppi di pericoli standard inclusi possono essere visualizzati nello screenshot qui sotto:

Questo endpoint non è destinato alla creazione di beni; tale operazione deve essere sempre eseguita tramite l' endpoint ' Commodity '.

Per saperne di più sulle definizioni di questo 'HazardLink' e sulle classi di database correlate, consultare il seguente collegamento:

HazardLink 

Pericolo

Per entrambe le metodologie di importazione, le chiavi primarie sono:

Pericolo_Pericolo – il nome del gruppo di pericolo (ad esempio occhiali di sicurezza, cuffie antirumore, ecc.).

Commodity_Code – Il codice univoco della merce da assegnare al gruppo di rischio.

Altre opzioni che possiamo aggiungere dalla classe del database 'Hazard' sono:

Hazard_WarningText – Il testo da visualizzare a un operatore di terminale o WMS quando viene movimentata la merce associata a un pericolo. Necessario solo in caso di creazione di nuovi gruppi di pericolo.

Hazard_TextColor – Consente di inserire un valore numerico RGB per assegnare un colore al gruppo di pericolo. Si noti che questo valore deve essere lo stesso per tutte le merci all'interno dello stesso gruppo di pericolo. Si noti inoltre che, quando si importano i colori utilizzando questo metodo, i valori numerici RGB non devono essere separati da virgole (ad esempio 219 125 33 invece di 219, 125, 33).

Si noti che questa opzione non è disponibile per la metodologia JSON, a meno che non si crei un nuovo gruppo di pericoli tramite questo endpoint. Se è richiesta la modifica dei colori dei gruppi esistenti, si consiglia di utilizzare l'endpoint CSV.

Per questo articolo esamineremo un semplice set di dati di esempio contenente 2 ingredienti che potrebbero essere utilizzati durante la produzione:

• Alcool benzilico – Maschera di sicurezza (arancione) e guanti di sicurezza (rossi)
• Glicole propilenico – Occhiali di sicurezza (blu) e guanti di sicurezza (rossi)

Endpoint/URI di importazione 'HazardLink' –

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

Descrizione dell'endpoint

Campioni:

Utilizzando l'endpoint 'HazardLink', 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, possiamo vedere che tutti i nostri prodotti sono stati assegnati al gruppo di pericolo corretto; in questo caso possiamo vedere entrambi i prodotti aggiunti al gruppo di pericolo "Guanti di sicurezza".

Per le importazioni CSV dobbiamo prima creare un file di intestazione per le nostre importazioni.

Nome del file di definizione dell'intestazione/colonna: "hazardLink.csvh"

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

Nome del file CSV da importare: "hazardLink-datetime.csv"

I file CSV da importare devono essere posizionati nella seguente cartella: “<installdir>\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 pericolo definiti e aggiungeremo anche un colore ai gruppi:

Per ulteriori informazioni sulla struttura di questi file, consultare la pagina principale sull'integrazione . È possibile scaricare un file di intestazione di esempio 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 una volta che non sono necessarie le 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 vedere che i colori del testo del gruppo di pericolo sono stati aggiornati e, come sopra, i 2 ingredienti sono ora aggiunti al gruppo "Guanti di sicurezza":