Introduzione
Puoi ora generare un'immagine codice a barre, 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 frontend di cui parleremo sotto (barcode.aspx), andrà ad eseguire il render e a stampare 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 gli argomenti "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.
Note | ||
---|---|---|
| ||
Dall'editor della piattaforma, il codice a barre sarà visualizzato con il suo valore di default. |
Come creare un barcode
- 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 non è già presente, importare nei campi anagrafici in piattaforma, il valore alfanumerico da codificare dal barcode
- generare l'url, come spiegato qui di seguito
Come generare l'URL
Può essere referenziata direttamente dal "src" di un tag HTML di tipo "img":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=14&NarrowBarWidth=2&bearerbarsmode=0&BitmapTargetFormat=1&Ratio=0&TargetDynField=LatestShippedOrderID&FontHeight=0,2 />
Note |
---|
L'esempio sopra, richiede un codice a barre i2of5 formattato ( SymbologyId = 14 ), e imposta un'immagine di 60px di altezza con un font di 0.2. Ciascuna simbologia richiede delle impostazioni specifiche (a partire dalla lunghezza della sequenza numerica) |
...
Note |
---|
Non dimenticare di sostituire <consolehost> con l'URL reale della tua piattaforma MailUp e di riempire il campo destinatario LatestShippedOrderID con un vero codice a barre numerico. Il campo symbology 14 lo puoi riempire con una lunghezza qualsiasi (purchè sia pari) |
Esempio di Output di un codice a barre
Qui sotto un esempo di Interleaved 2 of 5 realizzato da una sequenza a 14 digits
Parametri richiesti ( Tabella 1)
...
Nome
...
Obbligatorio?
...
Descrizione
...
IdOptIn
...
y
...
User Id destinatario
...
Hash
...
y
...
Hash destinatario
...
BarcodeHeight
...
y
...
Altezza (in px) dell'immagine codice a barre
...
SymbologyId
...
y
...
Id rappresentante il formato codice a barre ( 14 = ITF )
...
TargetDynField
...
y
...
Il campo dinamico contenente la sequenza numerica barcode
...
NarrowBarWidth
...
n
...
Larghezza (in pixel) della narrow bar
...
BearerBarsmode
...
n
...
Imposta la modalità di visualizzazione delle barre di tolleranza ( 0 = Nessuno, 1 = Orizzontale, 2 = Intera )
...
BearerBarsSize
...
n
...
Larghezza (in pixel) della barre di tolleranza ( si applica solo se BearerBarsmode > 0 )
...
Ratio
...
n
...
Il numero di volte che la wide bar sarà visualizzata per ciascuna narrow bar
...
ChecksumAdd
...
n
...
Questo Boolean definisce se la sequenza numerica deve essere completata con una cifra di controllo calcolata ( default è false )
...
IsNumberVisible
...
...
Se true, visualizza la sequenza numerica di ingresso sotto il codice a barre
...
FontHeight
...
n
...
Altezza font in punti, usare la virgola come separatore
Symbology format Id reference (Tabella 2)
SymbologyId | Symbology name |
---|---|
1 | Codabar |
2 | Code11 |
3 | Code128 |
4 | Code39 |
5 | Code39Ext |
6 | Code93 |
7 | Code93Ext |
8 | Deutsche Post Ident Code |
9 | Deutsche Post Leit Code |
10 | Ean218 |
11 | Ean13 |
12 | Ean14 |
13 | Ean8 |
14 | Interleaved 2 of 5 |
15 | ITF14 |
16 | Msi |
17 | Numly |
18 | Opc |
19 | Planet |
20 | Postnet |
21 | Pzn |
22 | Royal Mail 4 state |
23 | Royal Tnt Post Kix |
24 | Industrial 2 of 5 |
25 | Singapore post 4 State |
26 | SSCC18 |
27 | Swiss Post Parcel |
28 | UPCA |
29 | UPCE |
30 | USP Sack label |
31 | USP Tray label |
Come costruire l'URL del tuo codice a barre
...
- 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)
Copia questo snippet :
Code Block http://<ConsoleHost>/frontend/Barcode.aspx?idoptin=[_idoptin]&hash=[_hash]&BarcodeHeight=60&SymbologyId=14&NarrowBarWidth=2&bearerbarsmode=0&BitmapTargetFormat=1&Ratio=0&TargetDynField=LatestShippedOrderID&FontHeight=0,2
- 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 LatestShippedOrderId con il Campo dinamico da te scelto ( e riempito con ) il codice a barre numerico.
- Seleziona tutto ( CTRL + A ) e copia nel foglio appunti ( CTRL +C )
- Adesso apri il tuo browser e accedi alla tua piattaforma MailUp
- Clicca su Messaggi > Email > Elenco > Crea e seleziona la modalità di creazione "DA EDITOR HTML"
- Dall'editor passa alla modalità HTML cliccando su "</> HTML" come mostrato nella figura 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:
...
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
Anchor | ||||
---|---|---|---|---|
|
Parametri dell'URL ( Tabella 1)
Nome | Obbligatorio? | Descrizione |
---|---|---|
IdOptIn | y | User Id destinatario |
Hash | y | Hash destinatario |
BarcodeHeight | y | Altezza (in px) dell'immagine codice a barre |
SymbologyId | y | Id rappresentante il formato codice a barre ( 14 = ITF ) |
TargetDynField | y | Il campo dinamico contenente la sequenza numerica barcode |
NarrowBarWidth | n | Larghezza (in pixel) della narrow bar |
BearerBarsmode | n | Imposta la modalità di visualizzazione delle barre di tolleranza ( 0 = Nessuno, 1 = Orizzontale, 2 = Intera ) |
BearerBarsSize | n | Larghezza (in pixel) della barre di tolleranza ( si applica solo se BearerBarsmode > 0 ) |
Ratio | n | Il numero di volte che la wide bar sarà visualizzata per ciascuna narrow bar |
ChecksumAdd | n | Questo Boolean definisce se la sequenza numerica deve essere completata con una cifra di controllo calcolata ( default è false ) |
IsNumberVisible | n | Se true, visualizza la sequenza numerica di ingresso sotto il codice a barre |
FontHeight | n | Altezza font in punti, usare la virgola come separatore |
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.
SymbologyId | Symbology name | Descrizione | Esempio |
---|---|---|---|
1 | Codabar | Valid characters are: '0123456789-$:/.+ABCD'. The number should start and stop with one of the 'ABCD' characters. | A1234567890A |
2 | Code11 | Valid characters are: '0123456789-'. | 1234567890 |
3 | Code128 | Use GS1-128 (UCC/EAN-128) symbology if you plan to use, application identifiers such as '(10)1234(01)56789'. | Hello 123 |
4 | Code39 | Valid characters are capital letters and numbers. Start and stop characters ('*') are added automatically. | HELLO 123 |
5 | Code39Ext | Start and stop characters ('*') are added automatically. | Hello 123 |
6 | Code93 | Valid characters are capital letters and numbers. Start and stop characters ('*') are added automatically. | HELLO 123 |
7 | Code93Ext | Start and stop characters ('*') are added automatically. | Hello 123 |
8 | Deutsche Post Ident Code | 11 digits + checksum | 12345678901 |
9 | Deutsche Post Leit Code | 13 digits + checksum | 1234567890123 |
10 | Ean218 | ||
11 | Ean13 | 12 digits + checksum, Use the following format to add supplement: '123456789012,34'. | 123456789012,34 |
12 | Ean14 | 13 digits + checksum | 1234567890123 |
13 | Ean8 | 7 digits + checksum | 1234567 |
14 | Interleaved 2 of 5 | Valid characters are: '0123456789', length (including checksum) must be even. | 123456789 |
15 | ITF14 | 13 digits long + checksum | 1234567890123 |
16 | Msi | Valid characters are: '0123456789' | 1234567890 |
17 | Numly | 19 digits | 1234567890123456789 |
18 | Opc | 9 digits + checksum | 123456789 |
19 | Planet | Valid characters are: '0123456789' | 1234567890 |
20 | Postnet | Valid characters are: '0123456789' | 1234567890 |
21 | Pzn | 6 digits + checksum | 123456 |
22 | Royal Mail 4 state | Valid characters are capital letters and numbers. | 1234567890 |
23 | Royal Tnt Post Kix | Valid characters are capital letters and numbers. | 1234567890 |
24 | Industrial 2 of 5 | Valid characters are: '0123456789' | 1234567890 |
25 | Singapore post 4 State | Valid characters are capital letters and numbers. | 1234567890 |
26 | SSCC18 | 17 digits long + checksum | 12345678901234567 |
27 | Swiss Post Parcel | 18 digits long | 123456789012345678 |
28 | UPCA | 11 digits + checksum | 12345678901 |
29 | UPCE | 8 digits | 12345678 |
30 | USP Sack label | 8 digits long | 12345678 |
31 | USP Tray label | 10 digits long | 1234567890 |