Collegamento campo personalizzato

L'endpoint di importazione 'CustomFieldLink' può essere utilizzato per assegnare rapidamente messaggi di etichetta personalizzati alle merci (solitamente formule di prodotti finiti) che possono essere stampati sulle etichette dei prodotti prodotto per prodotto.

Ulteriori informazioni su come funziona e diversi esempi di utilizzo dei campi personalizzati sono disponibili Qui..

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

1. Layout del centro di controllo
2. Collegamenti API
3. Guida sul campo CustomFieldLink
   1. Chiavi primarie
   2. Campi obbligatori
4. Esempio di set di dati
5. Metodologia
   1. 1. JSON – Importa
      2. CSV – Importa

Per quanto riguarda il modo in cui possiamo correlare i dettagli dei campi personalizzati a ciò che vediamo nel Centro di controllo, utilizzeremo l'API V5 e Gateway per popolare sia il pannello superiore "CustomField" per nominare i nostri campi personalizzati e immettere i dettagli dei parametri delle etichette, sia il pannello inferiore "CustomFieldLink" per assegnare prodotti al campo personalizzato e immettere informazioni specifiche sulla formula che possono poi essere richiamate nel set di parametri delle etichette nel pannello superiore.

Per saperne di più sulle definizioni di questa classe 'CustomFieldLink', consultare il seguente link:

Collegamento campo personalizzato 

Per l'importazione tramite l'endpoint 'CustomFieldLink', le chiavi primarie sono:

Nome_campo – Il nome univoco per il campo personalizzato che stiamo aggiungendo o assegnando alla nostra formula. Possiamo vederlo sopra come 'Distributed By'.

Codice_merci – Il codice univoco della formula della merce/prodotto da assegnare al gruppo di campi personalizzati.

Possiamo aggiungere altri dati necessari per arricchire l'importazione da entrambi i 'Campo personalizzato' e 'Collegamento campo personalizzato' classi di database. Queste sono:

Da CustomField:

Field_LabelParameter - Necessario se si crea un nuovo gruppo Custom Field, questo è il parametro che verrà utilizzato sulle etichette per richiamare i dati personalizzati da questo gruppo. Nell'esempio di Control Center sopra possiamo vedere che questo è 'DIST'.

Campo_ValorePredefinito - Il valore predefinito che verrà richiamato quando si usa il parametro etichetta, a condizione che non ci sia un valore specifico di merce/formula per sovrascriverlo nel pannello inferiore, 'CustomFieldLink'. Nell'esempio di Control Center sopra possiamo vedere che questo è 'SG Systems LLC'.

Da CustomFieldLink:

Dati – Le informazioni da richiamare sull'etichetta per quella specifica merce/formula quando il parametro etichetta del gruppo di campi personalizzati viene utilizzato su un'etichetta.

Per questo pezzo esamineremo un semplice set di dati di esempio con 3 diverse formule di prodotto che possiamo assegnare al 'Distributed By' già creato, assegnando a ciascuna un messaggio di distribuzione univoco. Aggiungeremo anche un nuovo gruppo Custom Field chiamato 'Preparation Instructions', con il parametro etichetta 'PREP'.

Quindi aggiungeremo i seguenti dati al sistema:

• P006:
  • Distribuito da: Distribuzione ABC.
  • Istruzioni per la preparazione: Lavare prima dell'uso.
• P007:
  • Distribuito da: Distributori di Dave
  • Istruzioni per la preparazione: Lavare prima dell'uso.
• P008:
  • Distribuito da: Distribuzione SGS.
  • Istruzioni per la preparazione: Lavare prima dell'uso.

'CustomFieldLink' importa Endpoint/URI –

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

Descrizione dell'endpoint

Campioni:

Utilizzando l'endpoint 'CustomFieldLink', possiamo strutturare un file di importazione per le aggiunte di cui sopra nel seguente modo:

Quindi, nota qui che, poiché stavamo creando il gruppo 'Preparation Instructions', dovevamo includere il parametro label in questa importazione. Per il gruppo 'Distributed By' non ne abbiamo bisogno e possiamo semplicemente fare riferimento al nome del gruppo nella nostra importazione.

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

Una volta pubblicato il tutto nel sistema, possiamo vedere che le nostre formule di esempio sono state aggiunte al gruppo "Distribuito da", con il loro messaggio univoco nella colonna "Dati" del pannello inferiore:

E possiamo anche vedere che il nostro nuovo gruppo è stato creato per avere le stesse "Istruzioni di preparazione" per tutti e 3:

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

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

I file di intestazione completati devono essere inseriti in: “ \SG Control Center\gateway\import\def_colonna”

Importa nome file CSV: “customFieldLink-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 campi personalizzati definiti e aggiungeremo anche un nuovo gruppo come definito sopra:

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:

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

A differenza della nostra importazione JSON, a causa del meccanismo di importazione CSV, in questo caso dovremmo includere il parametro etichetta 'DIST' per il gruppo 'Distribuito da'.

Possiamo quindi trascinare questo file nella nostra cartella di importazione come definito sopra e, una volta completata l'importazione, possiamo vedere che i gruppi di campi personalizzati sono stati aggiornati/aggiunti di conseguenza:

E: