Page Comparison

...

...

...

...

...

...

...

...

...

...

Introduzione

La console 8.4 tra le varie funzioni, offre la possibilità di generare Generare un'immagine per un codice a barre e di associarla è necessario associarla a un campo della console. Questa 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 sui cui parleremo sotto (barcode.aspx), andrà ad eseguire il render e a stampare mostrare l'immagine del codice a barre, a partire da una sequenza numerica /alfa numerica recuperata dinamicamente su da un campo anagrafico in piattaforma MailUp.

Alla pagina vengono passati anche i riferimenti "IdOptin" eargomenti "hash", passati alla pagina.Questa pagina per stampare correttamente il codice a barre, richiede la sequenza numerica, precedentemente salvata  in uno dei campi di informazioni personali della console . Questo requisito è stato introdotto al fine di impedire l'utilizzo fraudolento delle URL e dei relativi codici a barre generati.

Barcode.aspx risiede nella "frontend" root di ogni console 8.3 o versione successiva piattaforma e non memorizzao salva nessuna delle immagini barcode sullo spazio fisico della "console"piattaforma. Questo al fine di evitare il sovraccarico del serveserver.  

...

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

Complete Url With Params
<img completa con Parametri

​<img src="http://<ConsoleHost>/frontend/Barcode.aspx?idoptin=[_idoptin]&hash=[_hash]&BarcodeHeight=60&SymbologyId=144&NarrowBarWidth=2&bearerbarsmode=0&BitmapTargetFormat=1&Ratio=0&TargetDynField=[LatestShippedOrderID]idultimoordine&FontHeight=0,2 /">
Note : the above sample requests a i2of5 formatted barcode

...

REQUEST PARAMETERS ( Table 1)

...

Name

...

Mandatory?

...

Description

...

IdOptIn

...

y

...

Recipient User Id

...

Hash

...

y

...

Recipient hash unique value

...

BarcodeHeight

...

y

...

Barcode image height in pixels

...

SymbologyId

...

y

...

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à:

Image Added

Anchor
URL URL

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 : 

   Code Block
   <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.

Image Added

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

Image Added

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:

Image Added

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)

...

Anchor
tabella2 tabella2

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.

...

BUILD UP YOUR BARCODE URL

Since there's no built in functionality helping you to display a barcode inside the markup, you'll need to build yourself the URL.
No panic, it takes two minutes . Ok, maybe only three 
Please follow the brief guide prepared to build your own Barcode Image URL :

1. Open any text editor you're comfortable to work with ( we recommend Notepad++ but Windows Notepad will be fine either way)
2. Paste in the editable window the following 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. Now replace those parts of the query string marked in red with actual information : <consolehost> must be replace with your console URL ( for instance a8g5c.mailup.com ) and LatestShippedOrderId with the Dynamic Field you've defined holding ( and filled in with ) the barcode numeric number.
4. Select it entirely ( CTRL + A ) and copy it to clipboard ( CTRL +C )
5. Now open your web browser and Log into your MailUp console
6. Click on Messages–> Email–> New–> Create New Email as below

Image Removed

1. Type in subject textbox and jump to the HTML editor area, then click on the HTML tab at the bottom of it and click on the "<> HTML" tab as shown in the below screen shot

Image Removed

1. Write a plain and empty HTML Img tag such as <img src="" /> in the writable area of the editor as below

Image Removed

1. Now it's time to fill the Image tag "src "property with the actual barcode module path : barcode image path must always display an absolute path : <img src="PASTE HERE YOUR BARCODE URL PREVIOUSLY COPIED FROM NOTEPAD" />
2. Click on Save. Now you should be seeing the barcode rendered in the preview window as below

Image Removed

RENDERING FAILURE

...