Proiectarea etichetelor Zebra (ZPL)

Imprimantele de etichete Zebra nu înțeleg documentele normale. În schimb, ele citesc un set mic de comenzi text numite ZPL (Zebra Programming Language). Un design ZPL este doar un bloc de text care spune imprimantei ce să pună pe etichetă și unde: o linie de text aici, un preț acolo, un cod QR într-un colț.

Această pagină explică ZPL de la zero astfel încât să puteți citi, edita și construi propriile etichete de produs fără ajutor. Proiectați eticheta dumneavoastră în Configurare ‣ Imprimante, în câmpul Design personalizat etichetă produs Zebra (consultați Configurarea imprimantei).

Sfat

Rareori porniți de la o pagină goală. Gem Logic oferă fiecărei etichete un design implicit funcțional. Cea mai rapidă modalitate de a învăța este să deschideți acel design implicit, să schimbați un singur lucru, să salvați și să priviți imaginea de previzualizare. Repetați până când arată corect.

Pornire rapidă

  1. Accesați Configurare ‣ Imprimante și găsiți câmpul Design personalizat etichetă produs Zebra.

  2. Faceți o mică modificare (de exemplu, mutați o linie sau măriți prețul).

  3. Dați clic pe Salvează. Gem Logic generează automat o imagine de previzualizare a etichetei.

  4. Uitați-vă la previzualizare. Dacă este greșită, ajustați și salvați din nou.

Nimic nu este trimis la o imprimantă reală în timp ce experimentați — previzualizarea este generată din designul dumneavoastră, astfel încât puteți itera în siguranță înainte de a imprima o singură etichetă.

Cum este construită o etichetă ZPL

Fiecare etichetă începe cu ^XA și se termină cu ^XZ. Tot ce se află între ele descrie eticheta. O comandă începe întotdeauna cu un semn circumflex ^ (sau uneori o tildă ~).

^XA            (start of the label)
... commands that build the label ...
^XZ            (end of the label)

În interior, modelul cel mai comun este „mergeți la o poziție, apoi imprimați ceva acolo”:

^FO50,30^FDHello^FS

Acea singură linie înseamnă: mergeți la poziția 50,30 și imprimați textul „Hello”. Detaliat:

  • ^FO50,30 — Field Origin: deplasare la x=50, y=30 (colțul din stânga sus al ceea ce urmează).

  • ^FDHello — Field Data: conținutul efectiv de imprimat.

  • ^FS — Field Separator: marchează sfârșitul acestei componente. Închideți întotdeauna un câmp cu ^FS.

Aceasta reprezintă 90% din proiectarea etichetelor: o serie de linii „poziție + conținut” suprapuse.

Dimensiunea etichetei, puncte și milimetri

Imprimantele Zebra măsoară totul în puncte, nu în milimetri. Majoritatea imprimantelor de etichete printează la 203 DPI, ceea ce înseamnă:

  • 1 mm ≈ 8 puncte

  • 1 inch = 203 puncte

Astfel, o etichetă care este lată de 56 mm și înaltă de 13 mm are aproximativ 448 puncte lățime și 104 puncte înălțime.

Două comenzi stabilesc zona printabilă:

  • ^PW — Print Width, lățimea de printare, în puncte.

  • ^LL — Label Length, lungimea etichetei (înălțimea), în puncte.

^PW448        (label is 448 dots wide ≈ 56 mm)
^LL104        (label is 104 dots tall ≈ 13 mm)

Important

Dimensiunea fizică a etichetei provine și din câmpurile Lățime etichetă produs și Lungime etichetă produs de lângă design. Mențineți-le sincronizate cu stocul dumneavoastră real de etichete. Variabila {label_length} este completată automat din câmpul de lungime, motiv pentru care designul implicit folosește ^LL{label_length}.

Poziționarea: grila de coordonate

Gândiți-vă la etichetă ca la o grilă. Punctul 0,0 este colțul din stânga sus. Primul număr este x (cât de departe spre dreapta) și al doilea este y (cât de departe în jos), ambele în puncte.

^FO0,0        top-left corner
^FO200,0      200 dots to the right, same height
^FO0,40       left edge, 40 dots down

Pentru a muta un element, modificați numerele sale ^FO. x mai mare = mai spre dreapta; y mai mare = mai în jos. Astfel puteți plasa SKU-ul pe o linie și metalul pe următoarea: dați-le același x, dar un y mai mare pe a doua linie.

Adăugarea și dimensionarea textului

Înainte de a printa text, de obicei alegeți o dimensiune de font. Cea mai simplă metodă este ^CF0,h (Change default Font, modificare font implicit), unde h este înălțimea caracterelor în puncte:

^CF0,28               use ~28-dot-tall text from here on
^FO50,30^FDPrice^FS   print "Price" at 50,30 in that size

Fiecare ^FD ... ^FS după un ^CF folosește acea dimensiune până când setați una diferită. Astfel, pentru a amesteca dimensiuni pe o etichetă, setați ^CF0,28 înainte de textul mare și ^CF0,14 înainte de textul mic.

Sfat

Pentru a adăuga o linie nouă de text, nu apăsați Enter — adăugați un alt câmp poziționat mai jos. Copiați o linie existentă, dați-i o valoare y mai mare și modificați conținutul acesteia.

Inserarea datelor produsului

Un design de etichetă este reutilizat pentru fiecare produs, deci nu introduceți SKU-ul sau prețul manual. În schimb, inserați variabile între acolade, iar Gem Logic le înlocuiește cu datele reale ale fiecărui produs la printarea etichetei.

^FO1,8^FD{item_sku}^FS          prints this product's SKU
^FO180,50^FD{currency}{price}^FS prints e.g. €129

Aceleași variabile sunt afișate ca insigne clicabile direct sub câmpul de design în aplicație, astfel încât să puteți vedea care sunt disponibile în timp ce editați.

Variabile disponibile

Produs

  • {brand}: nume brand

  • {product_title}: titlu produs

  • {item_sku}: SKU produs

  • {ean_code}: cod de bare EAN (folosit pentru codul QR)

  • {price} și {currency}: preț și simbol valută

  • {serial_number}: număr de serie

  • {year_of_manufacture}: an de fabricație

  • {supplier_product_reference}: referință produs furnizor

  • {supplier_reference}: referință furnizor

Materiale și pietre prețioase

  • {material_1} până la {material_5}: descriere completă material (greutate, nume și detalii piatră prețioasă)

  • {material_only_1} până la {material_only_5}: doar nume material sau piatră prețioasă

Atribute

  • {attribute_1} până la {attribute_5}: atribut sub forma nume: valoare

  • {attribute_name_1} până la {attribute_name_5}: doar nume atribut

  • {attribute_value_1} până la {attribute_value_5}: doar valoare atribut

Dimensiuni

  • {weight}, {length}, {width}, {height}, {diameter}, {size}, {thickness}, {quality}

Colecții

  • {collections}: colecțiile cărora le aparține produsul

Categorii

  • {categories}: categoriile cărora le aparține produsul, separate prin virgulă

Țara de origine

  • {country_of_origin}: țara din care provine produsul

Claritate

  • {clarity}: claritatea pietrei prețioase a produsului

Cod de cost

  • {encoded_cost}: costul de achiziție convertit în codul dumneavoastră privat de cost (literele sunt setate în Configurare ‣ Setări generale), astfel încât costul real nu este lizibil pe etichetă.

RFID (necesar doar pentru etichetele cu tag-uri RFID)

  • {item_sku_epc_hex}: SKU-ul codificat ca valoare EPC pentru cipul RFID

  • {item_sku_epc_word_count}: lungimea EPC, utilizată de comanda RFID ZPL

Aspect

  • {label_length}: completat automat din setarea lungimii etichetei

Coduri QR și coduri de bare

Un cod QR este adăugat cu ^BQN urmat de un câmp de date care începe cu QA,:

^FO0,30^BQN,2,2^FDQA,{ean_code}^FS

  • ^FO0,30 — unde se plasează codul QR.

  • ^BQN,2,2 — un cod QR. Ultimul număr este dimensiunea (mărire). Măriți-l (3, 4, 5…) pentru un cod mai mare, mai ușor de scanat; micșorați-l pentru a economisi spațiu.

  • ^FDQA,{ean_code}^FS — datele din interiorul codului. Aici codifică codul EAN al produsului.

Pentru un cod de bare 1D clasic în schimb, utilizați ^BCN (Code 128):

^FO20,20^BCN,60,Y,N,N^FD{ean_code}^FS

60 este înălțimea codului de bare în puncte, iar Y imprimă numărul lizibil dedesubt.

Designul implicit, explicat

Acesta este designul de start pe care Gem Logic vi-l oferă, adnotat linie cu linie. Lectura lui este cea mai rapidă modalitate de a înțelege cum se îmbină piesele.

^XA
^MD20
^CI28
^LL{label_length}
^LH0,0
^CF0,18
^FO180,8^FD{brand}^FS
^CF0,14
^FO50,45^FD{material_2}^FS
^FO50,60^FD{material_3}^FS
^FO180,27^FD{material_1}^FS
^CF0,28
^FO180,50^FD{currency}{price}^FS
^CF0,16
^FO1,8^FD{item_sku}^FS
^FO1,23^FD{supplier_product_reference}^FS
^FO50,60^FD{supplier_reference}^FS
^FO0,30^BQN,2,2
^FDQA,{ean_code}^FS
^XZ

Linie cu linie:

  • ^XA — începutul etichetei.

  • ^MD20 — intensitatea imprimării. Ridicați-o dacă etichetele par decolorate, coborâți-o dacă textul este mânjit.

  • ^CI28 — codarea caracterelor, astfel încât € și diacriticele se imprimă corect.

  • ^LL{label_length} — înălțimea etichetei, completată automat din setarea lungimii.

  • ^LH0,0 — poziția de origine: originea este colțul din stânga sus.

  • ^CF0,18 — dimensiunea textului ~18 puncte pentru liniile ce urmează.

  • ^FO180,8^FD{brand}^FS — marca, aproape de vârf.

  • ^CF0,14 — text mai mic de aici încolo.

  • ^FO50,45^FD{material_2}^FS, ^FO50,60^FD{material_3}^FS, ^FO180,27^FD{material_1}^FS — cele trei materiale.

  • ^CF0,28 — text mai mare pentru preț.

  • ^FO180,50^FD{currency}{price}^FS — prețul, de ex. €129.

  • ^CF0,16 — text mediu.

  • ^FO1,8^FD{item_sku}^FS — SKU-ul, stânga sus.

  • ^FO1,23^FD{supplier_product_reference}^FS — referința produsului furnizorului.

  • ^FO50,60^FD{supplier_reference}^FS — referința furnizorului.

  • ^FO0,30^BQN,2,2 apoi ^FDQA,{ean_code}^FS — codul QR (stânga jos) și datele sale (EAN-ul).

  • ^XZ — sfârșitul etichetei.

Atenționare

ZPL nu are comentarii de linie — nu folosiți punct și virgulă ; pentru a adăuga note. ZPL înțelege doar comenzi care încep cu ^ (sau ~), astfel orice urmează după un ; este citit ca parte a valorii comenzii (sau ca date răzlețe de etichetă). Aceasta este cauza erorilor precum „Value «20;» is not a valid number” sau „Ignored unrecognized content”, iar un ; rătăcit poate deplasa sau strica discret aspectul etichetei dumneavoastră.

Pentru a lăsa o notă, folosiți comanda de comentariu ^FX, închisă cu ^FS. Imprimanta ignoră tot ce se află în interior:

^FX brand, near the top ^FS
^FO180,8^FD{brand}^FS

Singura regulă: un comentariu ^FX nu poate conține un ^ sau ~ — aceste caractere încheie comentariul și încep următoarea comandă.

Modificări frecvente

Măriți prețul

Găsiți ^CF0,28 înaintea liniei {price} și măriți numărul, de ex. ^CF0,40.

Mutați ceva

Schimbați numerele ^FO ale acestuia. Pentru a deplasa marca în jos, măriți al doilea număr din ^FO180,8 (8-ul).

Adăugați o linie nouă de text

Copiați o linie ^FO…^FD…^FS, dați-i o valoare y mai mare pentru ca să stea mai jos, și schimbați conținutul sau variabila.

Măriți codul QR

Creșteți ultimul număr din ^BQN,2,2 (încercați ^BQN,3,3). Dacă este tăiat, oferiți-i mai mult spațiu sau mutați-l la stânga/sus cu ^FO.

Adăugați o linie separator

Utilizați o casetă grafică. ^FO0,40^GB540,2,2^FS desenează o linie orizontală subțire de 540 puncte lățime.

Previzualizați și testați înainte de imprimare

Aveți două moduri simple de a verifica un design înainte de a utiliza etichete reale:

  • În Gem Logic: de fiecare dată când salvați, o imagine de previzualizare a etichetei apare sub câmpul de design. Utilizați-o ca buclă principală de feedback.

  • Online: lipiți ZPL-ul dumneavoastră în vizualizatorul Labelary gratuit pentru a vedea o randare instantanee la dimensiuni diferite de etichetă. (Înlocuiți mai întâi {variables} cu text de probă, deoarece Labelary nu cunoaște datele dumneavoastră de produs.)

Dacă o etichetă reală arată incorect — text tăiat, un cod QR care nu scanează, dimensiune greșită — consultați secțiunea etichete din Depanare.

Referință rapidă comenzi

Comandă

Ce face

^XA / ^XZ

Început / sfârșit de etichetă. Tot se află între ele.

^PW

Lățime de imprimare în puncte.

^LL

Lungime etichetă (înălțime) în puncte.

^LH

Origine etichetă — punctul de origine (de obicei 0,0).

^FO x,y

Origine câmp — poziționa următorul element la x,y.

^CF0,h

Setează înălțimea implicită a fontului (h puncte) pentru textul următor.

^FD ... ^FS

Date câmp — conținutul de imprimat — închis de un separator de câmp.

^FX ... ^FS

Comentariu — ignorat de imprimantă. Nu poate conține ^ sau ~.

^MD

Intensitate mediu (intensitate imprimare). Valori mai mari înseamnă mai întunecat.

^BQN,m,m

Cod QR; ultimul număr este dimensiunea. Datele încep cu QA,.

^BCN,h,...

Cod de bare Code 128; h este înălțimea în puncte.

^GB w,h,t

Desenează un cadru sau o linie (lățime, înălțime, grosime în puncte).

^CI28

Codificare caractere, astfel încât simboluri precum € să se imprime corect.

Pentru limbajul complet, Zebra publică un ghid detaliat de comenzi ZPL, dar comenzile de mai sus acoperă aproape orice etichetă de produs.