eCoupon: codice a barre

Introduzione

Generare un'immagine codice a barre è necessario associarla a un campo della piattaforma: questa funzione è utile quando in una newsletter si vuole inserire un codice a barre ad esempio per uno sconto o una promozione legata a un prodotto (eCoupon), evitando qualsiasi tipo di frode.

La pagina di cui parleremo sotto (barcode.aspx), andrà ad mostrare l'immagine del codice a barre, a partire da una sequenza numerica /alfa numerica recuperata dinamicamente da un campo anagrafico in piattaforma MailUp.

Alla pagina vengono passati anche i riferimenti "IdOptin" e "hash" al fine di impedire l'utilizzo fraudolento delle URL e dei relativi codici a barre generati.

Barcode.aspx risiede nella "frontend" root di ogni piattaforma e non salva nessuna delle immagini barcode sullo spazio fisico della piattaforma. Questo al fine di evitare il sovraccarico del server.  

Come creare un barcode

1. verificare che la simbologia del proprio barcode sia supportata dalla simbologia utilizzata: vedi Tabella 2 oppure utilizza questo link per effettuare un test di rendering https://www.limilabs.com/barcode/demo -  Se deve ad esempio tradurre un testo numerico senza particolari caratteristiche è opportuno utilizzare il codice a barre 128 https://www.cognex.com/it-it/resources/symbologies/1-d-linear-barcodes/code-128-barcodes (Simbologyid 3) codice a barre 39 o codice a barre 93 (Simboligyid da 4 a 7)
2. se non è già presente, importare nei campi anagrafici in piattaforma, il valore alfanumerico da codificare dal barcode
3. generare l'url, come spiegato qui di seguito

Come generare l'URL

Il barcode deve essere inserito nel corpo del messaggio come un'immagine (vedi punto 8 "Come costruire l'URL del tuo codice a barre").

Url di base

http://<consoleurl>/frontend/Barcode.aspx

Url completa con Parametri

​<img src="http://<ConsoleHost>/frontend/Barcode.aspx?idoptin=[_idoptin]&hash=[_hash]&BarcodeHeight=60&SymbologyId=4&NarrowBarWidth=2&bearerbarsmode=0&BitmapTargetFormat=1&Ratio=0&TargetDynField=idultimoordine&FontHeight=0,2">

Esempio di Output di un codice a barre

In questo esempio nel campo idultimoordine è stato aggiunto il valore HELLO 123 - il rispettivo codice a barre che verrà mostrato al destinatario sarà:

Come costruire l'URL del tuo codice a barre

Per il momento non è ancora predisposta, una funzione per aiutarti a visualizzare un codice a barre all'interno del markup newsletter, dovrai quindi costruire tu stesso l'URL.
Non ti preoccupare, ci vorranno soltanto 2 minuti 
Segui questa breve e semplice guida per costruire l'URL del tuo codice a barre:

1. Apri un qualunque editor di testo con cui sei abituato a lavorare  (ti consigliamo Notepad ++, ma il blocco note di Windows va bene lo stesso)

2. Copia questo snippet : 

   <img src="http://<ConsoleHost>/frontend/Barcode.aspx?idoptin=[_idoptin]&hash=[_hash]&BarcodeHeight=60&SymbologyId=4&NarrowBarWidth=2&bearerbarsmode=0&BitmapTargetFormat=1&Ratio=0&TargetDynField=idultimoordine&FontHeight=0,2">

3. Adesso sostituisci le parti della stringa evidenziate in rosso con le informazioni corrette: <consolehost> deve essere sostituito con la URL della tua piattaforma ( per esempio a8g5c.mailup.com ) e idultimoordine con il Campo dinamico da te scelto ( e riempito con ) il codice a barre numerico.
4. Seleziona tutto ( CTRL + A ) e copia nel foglio appunti ( CTRL +C )
5. Adesso apri il tuo browser e accedi alla tua piattaforma MailUp
6. Clicca su Messaggi > Email > Elenco > Crea e seleziona la modalità di creazione "DA EDITOR HTML"
7. Dall'editor passa alla modalità HTML cliccando su "</> HTML" come mostrato nella figura sotto.

   8. Inserisci un HTML tag vuoto come quello che segue: <img src="" /> nell'area testo dell'editor come mostrato qui sotto.

9. Ora è il momento di riempire il tag image "src" con il path del codice a barre, il path del codice a barre deve essere sempre assoluto: <img src="INCOLLA QUI L'URL DEL TUO CODICE A BARRE PRECEDENTEMENTE COPIATO DA NOTEPAD" />

10. Clicca su salva. A questo punto dovresti vedere il render del codice a barre nella preview del tuo messaggio come mostrato sotto:

Fallimento del rendering del codice a barre 

L'applicazione può ricevere una formato sequenza errato di una certa simbology: non visualizzerai nessun messaggio di errore, ma visualizzerai invece un'immagine pixel così che l'immagine chiamata non apparirà come rotta. Ti consigliamo di effettuare un test per il formato https://www.limilabs.com/barcode/demo

Parametri dell'URL ( Tabella 1)

Symbology format Id reference (Tabella 2)

I codici della simbologia definiscono che tipo di barcode si sta realizzando e quindi anche i valori che possono essere codificati.