Oblikovanje nalepk Zebra (ZPL)

Tiskalniki nalepk Zebra ne razumejo običajnih dokumentov. Namesto tega berejo majhen nabor besedilnih ukazov, imenovanih ZPL (Zebra Programming Language). Oblika ZPL je zgolj blok besedila, ki tiskalniku sporoči, kaj naj natisne na nalepko in kje: vrstico besedila tukaj, ceno tam, kodo QR v kotu.

Ta stran od začetka pojasnjuje ZPL, tako da lahko brez pomoči berete, urejate in izdelate lastne nalepke izdelkov. Svojo nalepko oblikujete v Konfiguracija ‣ Tiskalniki, v polju Oblika nalepke izdelka Zebra po meri (glejte Konfiguracija tiskalnika).

Nasvet

Redko začnete s prazno stranjo. Gem Logic vsaki nalepki dodeli privzeto delujočo obliko. Najhitrejši način učenja je, da odprete to privzeto obliko, spremenite eno stvar, shranite in si ogledate predogledni posnetek. Ponavljajte, dokler ne izgleda pravilno.

Hiter začetek

  1. Pojdite na Konfiguracija ‣ Tiskalniki in poiščite polje Oblika nalepke izdelka Zebra po meri.

  2. Naredite majhno spremembo (na primer premaknite vrstico ali povečajte ceno).

  3. Kliknite Shrani. Gem Logic samodejno ustvari predogledni posnetek nalepke.

  4. Oglejte si predogled. Če ni pravilen, prilagodite in znova shranite.

Medtem ko eksperimentirate, se pravemu tiskalniku ne pošilja ničesar — predogled se ustvari iz Vaše oblike, tako da lahko varno ponavljate preizkuse, preden natisnete eno samo nalepko.

Kako je zgrajena nalepka ZPL

Vsaka nalepka se začne z ^XA in konča z ^XZ. Vse vmes opisuje nalepko. Ukaz se vedno začne s strešico ^ (včasih tudi s tildo ~).

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

Znotraj je najpogostejši vzorec „pojdi na pozicijo, nato tam natisni nekaj“:

^FO50,30^FDHello^FS

Ta posamezna vrstica pomeni: pojdi na pozicijo 50,30 in natisni besedilo „Hello“. Razčlenjeno:

  • ^FO50,30Field Origin: premakni se na x=50, y=30 (zgornji levi kot naslednjega elementa).

  • ^FDHelloField Data: dejanska vsebina za tiskanje.

  • ^FSField Separator: označuje konec tega dela. Polje vedno zaprite z ^FS.

To je 90 % oblikovanja nalepk: vrsta vrstic „pozicija + vsebina“, zloženih skupaj.

Velikost nalepke, pike in milimetri

Tiskalniki Zebra vse merijo v pikah, ne v milimetrih. Večina tiskalnikov nalepk tiska pri 203 DPI, kar pomeni:

  • 1 mm ≈ 8 pik

  • 1 palec = 203 pik

Torej nalepka, ki je široka 56 mm in visoka 13 mm, je približno 448 pik široka in 104 pik visoka.

Dva ukaza nastavita območje tiskanja:

  • ^PWPrint Width, širina tiskanja, v pikah.

  • ^LLLabel Length, dolžina nalepke (višina), v pikah.

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

Pomembno

Fizična velikost nalepke izhaja tudi iz polj Širina nalepke izdelka in Dolžina nalepke izdelka ob oblikovalcu. Poskrbite, da sta usklajeni z Vašimi dejanskimi zalogami nalepk. Spremenljivka {label_length} se samodejno izpolni iz polja dolžine, zato privzeta oblika uporablja ^LL{label_length}.

Pozicioniranje: koordinatno omrežje

Nalepko si predstavljajte kot omrežje. Točka 0,0 je levi zgornji kot. Prva številka je x (koliko v desno), druga pa y (koliko navzdol), obe v pikah.

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

Za premik elementa spremenite njegove številke ^FO. Večji x = bolj desno; večji y = bolj navzdol. Tako postavite SKU v eno vrstico in kovino v naslednjo: dodelite jima enak x, vendar večji y v drugi vrstici.

Dodajanje in spreminjanje velikosti besedila

Pred tiskanjem besedila običajno izberete velikost pisave. Najenostavnejši način je ^CF0,h (Change default Font, sprememba privzete pisave), kjer je h višina znakov v pikah:

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

Vsak ^FD ... ^FS po ^CF uporablja to velikost, dokler ne nastavite drugačne. Za mešanje velikosti na eni nalepki nastavite ^CF0,28 pred velikim besedilom in ^CF0,14 pred majhnim besedilom.

Nasvet

Za dodajanje nove vrstice besedila ne pritisnete Enter — dodate drugo pozicionirano polje niže. Kopirajte obstoječo vrstico, ji dodelite večjo vrednost y in spremenite njeno vsebino.

Vstavljanje podatkov o izdelku

Oblika nalepke se ponovno uporabi za vsak izdelek, zato SKU ali cene ne vnašate ročno. Namesto tega vstavite spremenljivke v zavitih oklepajih, Gem Logic pa jih ob tiskanju nalepke nadomesti z dejanskimi podatki vsakega izdelka.

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

Iste spremenljivke so prikazane kot klikljive značke neposredno pod poljem za oblikovanje v aplikaciji, tako da med urejanjem vidite, katere so na voljo.

Razpoložljive spremenljivke

Izdelek

  • {brand}: ime blagovne znamke

  • {product_title}: naslov izdelka

  • {item_sku}: SKU izdelka

  • {ean_code}: črtna koda EAN (uporabljena za QR kodo)

  • {price} in {currency}: cena in simbol valute

  • {serial_number}: serijska številka

  • {year_of_manufacture}: leto izdelave

  • {supplier_product_reference}: referenca izdelka dobavitelja

  • {supplier_reference}: referenca dobavitelja

Materiali in dragulji

  • {material_1} do {material_5}: popoln opis materiala (teža, ime in podatki o dragulju)

  • {material_only_1} do {material_only_5}: samo ime materiala ali dragulja

Atributi

  • {attribute_1} do {attribute_5}: atribut kot ime: vrednost

  • {attribute_name_1} do {attribute_name_5}: samo ime atributa

  • {attribute_value_1} do {attribute_value_5}: samo vrednost atributa

Dimenzije

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

Kolekcije

  • {collections}: kolekcije, ki jim izdelek pripada

Kategorije

  • {categories}: kategorije, ki jim izdelek pripada, ločene z vejico

Država izvora

  • {country_of_origin}: država, iz katere izdelek izvira

Čistost

  • {clarity}: čistost dragulja izdelka

Koda stroškov

  • {encoded_cost}: nabavni strošek, pretvorjen v Vašo zasebno kodo stroškov (črke so nastavljene v Konfiguracija ‣ Splošne nastavitve), tako da dejanski strošek na nalepki ni berljiv.

RFID (potrebno le za nalepke z RFID-oznakami)

  • {item_sku_epc_hex}: SKU, kodiran kot vrednost EPC za RFID-čip

  • {item_sku_epc_word_count}: dolžina EPC, ki jo uporablja ukaz ZPL RFID

Postavitev

  • {label_length}: samodejno izpolnjeno iz nastavitve dolžine nalepke

QR-kode in črtne kode

QR-koda se doda z ^BQN, ki mu sledi podatkovno polje, ki se začne z QA,:

^FO0,30^BQN,2,2^FDQA,{ean_code}^FS
  • ^FO0,30 — mesto QR-kode.

  • ^BQN,2,2 — QR-koda. Zadnja številka je velikost (povečava). Povečajte jo (3, 4, 5…) za večjo, lažje berljivo kodo; zmanjšajte jo za prihranek prostora.

  • ^FDQA,{ean_code}^FS — podatki znotraj kode. Tukaj kodira EAN izdelka.

Za klasično 1D črtno kodo namesto tega uporabite ^BCN (Code 128):

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

60 je višina črtne kode v pikah, Y pa pod njo natisne človeku berljivo številko.

Privzeta zasnova, razložena

To je začetna zasnova, ki Vam jo ponuja Gem Logic, z obrazložitvami vrstica za vrstico. Branje tega je najhitrejši način, da razumete, kako se deli povezujejo.

^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

Vrstica za vrstico:

  • ^XA — začetek nalepke.

  • ^MD20 — intenzivnost tiska. Povečajte jo, če so nalepke blede, zmanjšajte jo, če je besedilo razmazano.

  • ^CI28 — kodiranje znakov, da se in naglasi natiskajo pravilno.

  • ^LL{label_length} — višina nalepke, samodejno izpolnjena iz nastavitve dolžine.

  • ^LH0,0 — domača pozicija: izhodišče je v zgornjem levem kotu.

  • ^CF0,18 — velikost besedila ~18 pik za vrstice, ki sledijo.

  • ^FO180,8^FD{brand}^FS — blagovna znamka, blizu vrha.

  • ^CF0,14 — manjše besedilo od tu naprej.

  • ^FO50,45^FD{material_2}^FS, ^FO50,60^FD{material_3}^FS, ^FO180,27^FD{material_1}^FS — trije materiali.

  • ^CF0,28 — večje besedilo za ceno.

  • ^FO180,50^FD{currency}{price}^FS — cena, npr. €129.

  • ^CF0,16 — srednje veliko besedilo.

  • ^FO1,8^FD{item_sku}^FS — SKU, zgoraj levo.

  • ^FO1,23^FD{supplier_product_reference}^FS — dobaviteljeva oznaka izdelka.

  • ^FO50,60^FD{supplier_reference}^FS — oznaka dobavitelja.

  • ^FO0,30^BQN,2,2 nato ^FDQA,{ean_code}^FS — QR koda (spodaj levo) in njeni podatki (EAN).

  • ^XZ — konec nalepke.

Opozorilo

ZPL nima komentarjev vrstic — ne uporabljajte podpičja ; za dodajanje opomb. ZPL razume samo ukaze, ki se začnejo z ^ (ali ~), zato se vse za ; prebere kot del vrednosti ukaza (ali kot naključni podatki nalepke). To povzroča napake, kot sta „Value ‚20;‘ is not a valid number“ ali „Ignored unrecognized content“, in naključno ; lahko tiho premakne ali pokvari Vašo postavitev.

Za dodajanje opombe uporabite ukaz za komentar ^FX, zaprt z ^FS. Tiskalnik ignorira vse, kar je znotraj:

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

Edino pravilo: komentar ^FX ne sme vsebovati ^ ali ~ — ti znaki končajo komentar in zaženejo naslednji ukaz.

Pogoste spremembe

Povečajte ceno

Poiščite ^CF0,28 pred vrstico {price} in povečajte število, npr. ^CF0,40.

Premaknite element

Spremenite njegove vrednosti ^FO. Da premaknete blagovno znamko navzdol, povečajte drugo število v ^FO180,8 (8).

Dodajte novo vrstico besedila

Kopirajte vrstico ^FO…^FD…^FS, ji dodelite večjo vrednost y, da bo nižje, in spremenite vsebino ali spremenljivko.

Povečajte kodo QR

Povečajte zadnjo številko v ^BQN,2,2 (poskusite ^BQN,3,3). Če se obreže, ji dajte več prostora ali jo premaknite levo/navzgor z njenim ^FO.

Dodajte ločilno črto

Uporabite grafični okvir. ^FO0,40^GB540,2,2^FS nariše tanko vodoravno črto, široko 540 pik.

Predogled in preizkus pred tiskanjem

Na voljo imate dva enostavna načina za preverjanje zasnove, preden uporabite prave nalepke:

  • V Gem Logic: ob vsakem shranjevanju se pod poljem za zasnovo prikaže predogledna slika nalepke. Uporabite jo kot Vašo glavno povratno zanko.

  • Spletno: prilepite svoj ZPL v brezplačni pregledovalnik Labelary, da takoj vidite prikaz pri različnih velikostih nalepk. (Najprej zamenjajte {variables} s primerom besedila, saj Labelary ne pozna vaših podatkov o izdelkih.)

Če prava nalepka izgleda napačno — obrezano besedilo, koda QR, ki je ni mogoče skenirati, napačna velikost — glejte odsek o nalepkah v Odpravljanje težav.

Hitra referenca ukazov

Ukaz

Kaj naredi

^XA / ^XZ

Začetek / konec nalepke. Vse se nahaja med njima.

^PW

Širina tiska v pikah.

^LL

Dolžina nalepke (višina) v pikah.

^LH

Izhodišče nalepke — začetna točka (običajno 0,0).

^FO x,y

Izhodišče polja — postavite naslednji element na x,y.

^CF0,h

Nastavite privzeto višino pisave (h pik) za naslednje besedilo.

^FD ... ^FS

Podatki polja — vsebina za tiskanje — zaprta z ločilom polja.

^FX ... ^FS

Komentar — tiskalnik ga prezre. Ne sme vsebovati ^ ali ~.

^MD

Temnost medija (temnost tiska). Višja vrednost je temnejša.

^BQN,m,m

Koda QR; zadnja številka je velikost. Podatki se začnejo z QA,.

^BCN,h,...

Črtna koda Code 128; h je višina v pikah.

^GB w,h,t

Nariši okvir ali črto (širina, višina, debelina v pikah).

^CI28

Kodiranje znakov, da se simboli kot natisnjejo pravilno.

Za celoten jezik Zebra objavlja popoln vodnik po ukazih ZPL, vendar zgornji ukazi pokrivajo skoraj vsako etiketo artikla.