Page tree
Skip to end of metadata
Go to start of metadata

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.

Alla pagina vengono passati anche gli argomenti "IdOptin" e "hashal 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 generare l'URL

 Può essere referenziata direttamente dal "src" di un tag HTML di tipo "img":

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 />

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)

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

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)

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

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  (smile)
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 : 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
  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 LatestShippedOrderId 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.

  • No labels