Návrh štítkov Zebra (ZPL)

Tlačiarne štítkov Zebra nerozumejú bežným dokumentom. Namiesto toho čítajú malú sadu textových príkazov nazývaných ZPL (Zebra Programming Language). ZPL dizajn je len blok textu, ktorý tlačiarni hovorí, čo má na štítok vytlačiť a kam: riadok textu sem, cenu tam, QR kód do rohu.

Táto stránka vysvetľuje ZPL od začiatku, aby ste mohli čítať, upravovať a vytvárať vlastné produktové štítky bez pomoci. Svoj štítok navrhujete v Konfigurácia ‣ Tlačiarne, v poli Vlastný dizajn produktového štítku Zebra (pozri Konfigurácia tlačiarní).

Tip

Len zriedka začínate s prázdnou stránkou. Gem Logic dáva každému štítku funkčný predvolený dizajn. Najrýchlejší spôsob učenia je otvoriť tento predvolený dizajn, zmeniť jednu vec, uložiť a pozrieť sa na náhľad. Opakujte, kým to nevyzerá dobre.

Rýchly štart

  1. Prejdite do Konfigurácia ‣ Tlačiarne a nájdite pole Vlastný dizajn produktového štítku Zebra.

  2. Vykonajte malú zmenu (napríklad presuňte riadok alebo zväčšite cenu).

  3. Kliknite na Uložiť. Gem Logic automaticky vygeneruje náhľad štítku.

  4. Pozrite sa na náhľad. Ak nie je správny, upravte a uložte znova.

Počas experimentovania sa na skutočnú tlačiareň nič neposiela — náhľad sa generuje z Vášho dizajnu, takže môžete bezpečne iterovať pred vytlačením jediného štítku.

Ako je vytvorený ZPL štítok

Každý štítok začína ^XA a končí ^XZ. Všetko medzi tým popisuje štítok. Príkaz vždy začína znakom stmavca ^ (niekedy aj vlnovkou ~).

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

Vo vnútri je najčastejší vzor „prejdi na pozíciu a potom tam niečo vytlač“:

^FO50,30^FDHello^FS

Tento jediný riadok znamená: prejdi na pozíciu 50,30 a vytlač text „Hello“. Rozdelený:

  • ^FO50,30 — Field Origin: presuň sa na x=50, y=30 (ľavý horný roh toho, čo nasleduje).

  • ^FDHello — Field Data: skutočný obsah na tlač.

  • ^FS — Field Separator: označuje koniec tohto prvku. Vždy uzatvorte pole pomocou ^FS.

To predstavuje 90 % návrhu štítku: séria riadkov „pozícia + obsah“ nakladaných na seba.

Veľkosť štítku, body a milimetre

Tlačiarne Zebra merajú všetko v bodoch, nie v milimetroch. Väčšina tlačiarní štítkov tlačí pri 203 DPI, což znamená:

  • 1 mm ≈ 8 bodov

  • 1 palec = 203 bodov

Takže štítok, ktorý má šírku 56 mm a výšku 13 mm, je približne 448 bodov široký a 104 bodov vysoký.

Oblasť tlače nastavujú dva príkazy:

  • ^PW — Print Width, šírka tlače, v bodoch.

  • ^LL — Label Length, dĺžka štítku (výška), v bodoch.

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

Dôležité

Fyzická veľkosť štítku vychádza tiež z polí Šírka produktového štítku a Dĺžka produktového štítku vedľa dizajnu. Udržiavajte ich synchronizované s Vašou skutočnou zásobou štítkov. Premenná {label_length} sa automaticky vypĺňa z poľa dĺžky, preto predvolený dizajn používa ^LL{label_length}.

Umiestnenie: súradnicová mriežka

Predstavte si štítok ako mriežku. Bod 0,0 je ľavý horný roh. Prvé číslo je x (ako ďaleko doprava) a druhé je y (ako ďaleko dole), obe v bodoch.

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

Ak chcete posunúť prvok, zmeňte jeho čísla ^FO. Väčšie x = ďalej doprava; väčšie y = ďalej dole. Takto umiestnite SKU na jeden riadok a kov na ďalší: dajte im rovnaké x, ale väčšie y na druhom riadku.

Pridanie textu a nastavenie veľkosti

Pred tlačou textu zvyčajne zvolíte veľkosť písma. Najjednoduchší spôsob je ^CF0,h (Change default Font, zmeniť predvolené písmo), kde h je výška znakov v bodoch:

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

Každý ^FD ... ^FS po ^CF používa túto veľkosť, kým nenastavíte inú. Ak teda chcete kombinovať veľkosti na jednom štítku, nastavte ^CF0,28 pred veľkým textom a ^CF0,14 pred malým textom.

Tip

Ak chcete pridať nový riadok textu, nestlačíte Enter — pridáte ďalšie umiestnené pole nižšie. Skopírujte existujúci riadok, priraďte mu väčšiu hodnotu y a zmeňte jeho obsah.

Vloženie produktových dát

Dizajn štítku sa opätovne používa pre každý produkt, takže SKU ani cenu nezadávate ručne. Namiesto toho vkladáte premenné v zložených zátvorkách a Gem Logic ich pri tlači štítku nahradí skutočnými údajmi daného produktu.

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

Rovnaké premenné sú zobrazené ako klikateľné odznaky priamo pod poľom dizajnu v aplikácii, takže pri úpravách vidíte, ktoré sú dostupné.

Dostupné premenné

Produkt

  • {brand}: názov značky

  • {product_title}: názov produktu

  • {item_sku}: SKU produktu

  • {ean_code}: čiarový kód EAN (používa sa pre QR kód)

  • {price} a {currency}: cena a symbol meny

  • {serial_number}: sériové číslo

  • {year_of_manufacture}: rok výroby

  • {supplier_product_reference}: produktová referencia dodávateľa

  • {supplier_reference}: referencia dodávateľa

Materiály a drahokamy

  • {material_1} až {material_5}: úplný popis materiálu (hmotnosť, názov a detaily drahokamu)

  • {material_only_1} až {material_only_5}: len názov materiálu alebo drahokamu

Atribúty

  • {attribute_1} až {attribute_5}: atribút vo forme názov: hodnota

  • {attribute_name_1} až {attribute_name_5}: len názov atribútu

  • {attribute_value_1} až {attribute_value_5}: len hodnota atribútu

Rozmery

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

Kolekcie

  • {collections}: kolekcie, do ktorých produkt patrí

Kategórie

  • {categories}: kategórie, do ktorých produkt patrí, oddelené čiarkami

Krajina pôvodu

  • {country_of_origin}: krajina, z ktorej produkt pochádza

Čistota

  • {clarity}: čistota drahokamu produktu

Nákladový kód

  • {encoded_cost}: nákupný náklad prevedený do Vášho súkromného nákladového kódu (písmená sa nastavujú v Konfigurácia ‣ Všeobecné nastavenia), takže skutočný náklad nie je čitateľný na štítku.

RFID (potrebné iba pre štítky s RFID tagmi)

  • {item_sku_epc_hex}: SKU zakódované ako EPC hodnota pre RFID čip

  • {item_sku_epc_word_count}: dĺžka EPC, používaná príkazom ZPL RFID

Rozloženie

  • {label_length}: vyplnené automaticky podľa nastavenia dĺžky štítku

QR kódy a čiarové kódy

QR kód sa pridáva pomocou ^BQN, za ktorým nasleduje dátové pole začínajúce QA,:

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

  • ^FO0,30 — umiestnenie QR kódu.

  • ^BQN,2,2 — QR kód. Posledné číslo je veľkosť (zväčšenie). Zvýšte ho (3, 4, 5…) pre väčší, ľahšie skenovateľný kód; znížte ho pre ušetrenie miesta.

  • ^FDQA,{ean_code}^FS — dáta vnútri kódu. Tu kóduje EAN produktu.

Pre klasický 1D čiarový kód použite namiesto toho ^BCN (Code 128):

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

60 je výška čiarového kódu v bodoch a Y tlačí čitateľné číslo pod ním.

Predvolený dizajn, vysvetlený

Toto je počiatočný dizajn, ktorý Vám Gem Logic poskytuje, s anotáciami riadok po riadku. Jeho prečítanie je najrýchlejší spôsob, ako pochopiť, ako jednotlivé časti zapadajú do seba.

^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

Riadok po riadku:

  • ^XA — začiatok štítku.

  • ^MD20 — intenzita tlače. Zvýšte ju, ak sú štítky bledé, znížte ju, ak je text rozmazaný.

  • ^CI28 — kódovanie znakov, aby sa € a diakritika tlačili správne.

  • ^LL{label_length} — výška štítku, automaticky vyplnená z nastavenia dĺžky.

  • ^LH0,0 — domovská pozícia: počiatok je v ľavom hornom rohu.

  • ^CF0,18 — veľkosť textu ~18 bodov pre nasledujúce riadky.

  • ^FO180,8^FD{brand}^FS — značka, blízko horného okraja.

  • ^CF0,14 — menší text od tohto miesta.

  • ^FO50,45^FD{material_2}^FS, ^FO50,60^FD{material_3}^FS, ^FO180,27^FD{material_1}^FS — tri materiály.

  • ^CF0,28 — väčší text pre cenu.

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

  • ^CF0,16 — stredný text.

  • ^FO1,8^FD{item_sku}^FS — SKU, vľavo hore.

  • ^FO1,23^FD{supplier_product_reference}^FS — produktová referencia dodávateľa.

  • ^FO50,60^FD{supplier_reference}^FS — referencia dodávateľa.

  • ^FO0,30^BQN,2,2 potom ^FDQA,{ean_code}^FS — QR kód (vľavo dole) a jeho dáta (EAN).

  • ^XZ — koniec štítku.

Varovanie

ZPL nemá riadkové komentáre — nepoužívajte bodkočiarku ; na pridávanie poznámok. ZPL rozumie len príkazom, ktoré začínajú ^ (alebo ~), takže všetko po ; je čítané ako súčasť hodnoty príkazu (alebo ako chybné dáta štítku). To spôsobuje chyby ako „Value ‚20;‘ is not a valid number“ alebo „Ignored unrecognized content“, a zatúlaná ; môže ticho posunúť alebo pokaziť Vaše rozloženie.

Na zanechanie poznámky použite príkaz komentára ^FX, uzavretý pomocou ^FS. Tlačiareň ignoruje všetko vo vnútri:

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

Jediné pravidlo: komentár ^FX nemôže obsahovať ^ alebo ~ — tieto znaky ukončujú komentár a spúšťajú ďalší príkaz.

Bežné úpravy

Zväčšiť cenu

Nájdite ^CF0,28 pred riadkom {price} a zvýšte číslo, napr. ^CF0,40.

Presunúť niečo

Zmeňte jeho čísla ^FO. Ak chcete značku posunúť nadol, zvýšte druhé číslo v ^FO180,8 (to 8).

Pridať nový riadok textu

Skopírujte riadok ^FO…^FD…^FS, dajte mu väčšiu hodnotu y, aby bol nižšie, a zmeňte obsah alebo premennú.

Zväčšiť QR kód

Zvýšte posledné číslo v ^BQN,2,2 (skúste ^BQN,3,3). Ak je orezaný, poskytnite mu viac priestoru alebo ho posuňte vľavo/hore pomocou ^FO.

Pridať oddeľovaciu čiaru

Použite grafický box. ^FO0,40^GB540,2,2^FS nakreslí tenkú vodorovnú čiaru širokú 540 bodov.

Náhľad a test pred tlačou

Máte dva jednoduché spôsoby, ako skontrolovať návrh pred použitím skutočných štítkov:

  • V Gem Logic: pri každom uložení sa pod poľom návrhu zobrazí náhľad obrázka štítku. Použite to ako Vašu hlavnú spätnú väzbu.

  • Online: vložte Váš ZPL do bezplatného Labelary viewer, aby ste videli okamžité zobrazenie pri rôznych veľkostiach štítkov. (Najprv nahraďte {variables} vzorovým textom, keďže Labelary nepozná Vaše produktové údaje.)

Ak skutočný štítok vyzerá zle — orezaný text, QR kód, ktorý sa neskenovať, nesprávna veľkosť — pozrite si sekciu štítkov v Riešenie problémov.

Rýchla referencia príkazov

Príkaz

Čo robí

^XA / ^XZ

Začiatok / koniec štítku. Všetko sa nachádza medzi nimi.

^PW

Šírka tlače v bodoch.

^LL

Dĺžka štítku (výška) v bodoch.

^LH

Label home — počiatočný bod (zvyčajne 0,0).

^FO x,y

Field origin — umiestnenie ďalšieho prvku na x,y.

^CF0,h

Nastaviť predvolenú výšku písma (h bodov) pre nasledujúci text.

^FD ... ^FS

Field data — obsah na tlač — ukončený oddeľovačom poľa.

^FX ... ^FS

Komentár — ignorované tlačiarňou. Nemôže obsahovať ^ alebo ~.

^MD

Media darkness (intenzita tlače). Vyššia hodnota znamená tmavšiu tlač.

^BQN,m,m

QR kód; posledné číslo je veľkosť. Dáta začínajú na QA,.

^BCN,h,...

Čiarový kód Code 128; h je výška v bodoch.

^GB w,h,t

Nakreslí obdĺžnik alebo čiaru (šírka, výška, hrúbka v bodoch).

^CI28

Kódovanie znakov, aby sa symboly ako € tlačili správne.

Zebra publikuje úplnú príručku príkazov ZPL, ale príkazy uvedené vyššie pokrývajú takmer každý produktový štítok.