Návrh etiket Zebra (ZPL)

Etiketové tiskárny Zebra nerozumí běžným dokumentům. Místo toho čtou malou sadu textových příkazů nazývaných ZPL (Zebra Programming Language). ZPL design je pouze blok textu, který tiskárně říká, co má na etiketu umístit a kam: zde řádek textu, tam cenu, QR kód do rohu.

Tato stránka vysvětluje ZPL od základů, abyste mohli číst, upravovat a vytvářet vlastní etikety produktů bez pomoci. Svou etiketu navrhujete v Konfigurace ‣ Tiskárny, v poli Vlastní design etikety produktu Zebra (viz Konfigurace tiskárny).

Tip

Zřídka začínáte s prázdnou stránkou. Gem Logic poskytuje každé etiketě funkční výchozí design. Nejrychlejší způsob učení je otevřít výchozí design, změnit jednu věc, uložit a podívat se na obrázek náhledu. Opakujte, dokud nevypadá správně.

Rychlý start

  1. Přejděte do Konfigurace ‣ Tiskárny a najděte pole Vlastní design etikety produktu Zebra.

  2. Proveďte malou změnu (například přesuňte řádek nebo zvětšete cenu).

  3. Klikněte na Uložit. Gem Logic automaticky vygeneruje obrázek náhledu etikety.

  4. Prohlédněte si náhled. Pokud je nesprávný, upravte a znovu uložte.

Během experimentování není na skutečnou tiskárnu odesláno nic — náhled je generován z Vašeho designu, takže můžete bezpečně iterovat před vytištěním jediné etikety.

Jak je vytvořena etiketa ZPL

Každá etiketa začína ^XA a končí ^XZ. Vše mezi tím popisuje etiketu. Příkaz vždy začíná stříškou ^ (nebo někdy tildou ~).

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

Uvnitř je nejběžnější vzor „přejít na pozici, pak tam něco vytisknout“:

^FO50,30^FDHello^FS

Tento jediný řádek znamená: přejít na pozici 50,30 a vytisknout text „Hello“. Rozepsáno:

  • ^FO50,30 — Field Origin: přesun na x=50, y=30 (levý horní roh toho, co následuje).

  • ^FDHello — Field Data: skutečný obsah k tisku.

  • ^FS — Field Separator: označuje konec tohoto prvku. Vždy uzavřete pole pomocí ^FS.

To je 90 % návrhu etikety: série řádků „pozice + obsah“ vrstvených za sebou.

Velikost štítku, body a milimetry

Tiskárny Zebra měří vše v bodech, nikoli v milimetrech. Většina tiskáren štítků tiskne při 203 DPI, což znamená:

  • 1 mm ≈ 8 bodů

  • 1 palec = 203 bodů

Takže štítek, který je široký 56 mm a vysoký 13 mm, je přibližně 448 bodů široký a 104 bodů vysoký.

Dvě příkazy nastavují tisknutelnou oblast:

  • ^PW — Print Width, šířka tisku, v bodech.

  • ^LL — Label Length, délka štítku (výška), v bodech.

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

Důležité

Fyzická velikost štítku také pochází z polí Šířka produktového štítku a Délka produktového štítku vedle návrhu. Udržujte je synchronizované s Vaší skutečnou zásobou štítků. Proměnná {label_length} se automaticky vyplňuje z pole délky, proto výchozí návrh používá ^LL{label_length}.

Umístění: souřadnicová mřížka

Představte si štítek jako mřížku. Bod 0,0 je levý horní roh. První číslo je x (jak daleko vpravo) a druhé je y (jak daleko dolů), obojí v bodech.

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

Chcete-li posunout prvek, změňte jeho čísla ^FO. Větší x = dále vpravo; větší y = dále dolů. Takto umístíte SKU na jeden řádek a kov na další: dejte jim stejné x, ale větší y na druhém řádku.

Přidávání a změna velikosti textu

Před tiskem textu obvykle zvolíte velikost písma. Nejjednodušší způsob je ^CF0,h (Change default Font, změnit výchozí písmo), kde h je výška znaků v bodech:

^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žívá tuto velikost, dokud nenastavíte jinou. Chcete-li tedy na jednom štítku míchat velikosti, nastavte ^CF0,28 před velkým textem a ^CF0,14 před malým textem.

Tip

Chcete-li přidat nový řádek textu, nestisknete Enter — přidáte další umístěné pole níže. Zkopírujte existující řádek, dejte mu větší hodnotu y a změňte jeho obsah.

Vkládání dat produktu

Návrh štítku se opakovaně používá pro každý produkt, takže SKU nebo cenu nepíšete ručně. Místo toho vložíte proměnné ve složených závorkách a Gem Logic je při tisku štítku nahradí skutečnými daty každého produktu.

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

Stejné proměnné jsou zobrazeny jako klikací odznaky přímo pod polem návrhu v aplikaci, takže při úpravách vidíte, které jsou k dispozici.

Dostupné proměnné

Produkt

  • {brand}: název značky

  • {product_title}: název produktu

  • {item_sku}: SKU produktu

  • {ean_code}: čárový kód EAN (použitý pro QR kód)

  • {price} a {currency}: cena a symbol měny

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

  • {year_of_manufacture}: rok výroby

  • {supplier_product_reference}: produktová reference dodavatele

  • {supplier_reference}: reference dodavatele

Materiály a drahokamy

  • {material_1} až {material_5}: úplný popis materiálu (hmotnost, název a podrobnosti o drahokamu)

  • {material_only_1} až {material_only_5}: pouze název materiálu nebo drahokamu

Atributy

  • {attribute_1} až {attribute_5}: atribut ve tvaru název: hodnota

  • {attribute_name_1} až {attribute_name_5}: pouze název atributu

  • {attribute_value_1} až {attribute_value_5}: pouze hodnota atributu

Rozměry

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

Kolekce

  • {collections}: kolekce, do kterých produkt patří

Kategorie

  • {categories}: kategorie, do kterých produkt patří, oddělené čárkami

Země původu

  • {country_of_origin}: země, ze které produkt pochází

Čistota

  • {clarity}: čistota drahokamu produktu

Kód nákladů

  • {encoded_cost}: nákupní náklad převedený do Vašeho soukromého kódu nákladů (písmena se nastavují v Konfigurace ‣ Obecná nastavení), takže skutečný náklad není na štítku čitelný.

RFID (nutné pouze pro štítky s RFID čipy)

  • {item_sku_epc_hex}: SKU kódované jako hodnota EPC pro RFID čip

  • {item_sku_epc_word_count}: délka EPC, používaná příkazem ZPL RFID

Rozvržení

  • {label_length}: vyplněno automaticky podle nastavení délky štítku

QR kódy a čárové kódy

QR kód se přidává pomocí ^BQN následovaného datovým polem začínajícím QA,:

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

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

  • ^BQN,2,2 — QR kód. Poslední číslo je velikost (zvětšení). Zvyšte ho (3, 4, 5…) pro větší, snadněji skenovatelný kód; snižte ho pro úsporu místa.

  • ^FDQA,{ean_code}^FS — data uvnitř kódu. Zde kóduje EAN produktu.

Pro klasický 1D čárový kód použijte místo toho ^BCN (Code 128):

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

60 je výška čárového kódu v bodech a Y vytiskne čitelné číslo pod ním.

Výchozí design, vysvětleno

Toto je výchozí design, který Vám Gem Logic poskytuje, okomentovaný řádek po řádku. Jeho přečtení je nejrychlejší způsob, jak pochopit, jak jednotlivé části fungují dohromady.

^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

Řádek po řádku:

  • ^XA — začátek štítku.

  • ^MD20 — intenzita tisku. Zvyšte ji, pokud štítky vypadají bledě, snižte ji, pokud je text rozmazaný.

  • ^CI28 — kódování znaků, aby se € a diakritika tiskly správně.

  • ^LL{label_length} — výška štítku, vyplněná automaticky z nastavení délky.

  • ^LH0,0 — domovská pozice: počátek je v levém horním rohu.

  • ^CF0,18 — velikost textu ~18 bodů pro následující řádky.

  • ^FO180,8^FD{brand}^FS — značka, nahoře.

  • ^CF0,14 — menší text od této chvíle.

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

  • ^CF0,28 — větší text pro cenu.

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

  • ^CF0,16 — střední text.

  • ^FO1,8^FD{item_sku}^FS — SKU, vlevo nahoře.

  • ^FO1,23^FD{supplier_product_reference}^FS — produktová reference dodavatele.

  • ^FO50,60^FD{supplier_reference}^FS — reference dodavatele.

  • ^FO0,30^BQN,2,2 poté ^FDQA,{ean_code}^FS — QR kód (vlevo dole) a jeho data (EAN).

  • ^XZ — konec štítku.

Varování

ZPL nemá řádkové komentáře — nepoužívejte středník ; k přidání poznámek. ZPL rozumí pouze příkazům, které začínají ^ (nebo ~), takže vše po ; je čteno jako součást hodnoty příkazu (nebo jako zmatečná data štítku). To způsobuje chyby jako „Value ‚20;‘ is not a valid number“ nebo „Ignored unrecognized content“, a zmatečný ; může tiše posunout nebo rozbit Vaše rozvržení.

Chcete-li zanechat poznámku, použijte komentářový příkaz ^FX, uzavřený pomocí ^FS. Tiskárna vše uvnitř ignoruje:

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

Jediné pravidlo: komentář ^FX nesmí obsahovat ^ nebo ~ — tyto znaky ukončí komentář a spustí další příkaz.

Běžné úpravy

Zvětšit cenu

Najděte ^CF0,28 před řádkem {price} a zvyšte číslo, např. ^CF0,40.

Přesunout něco

Změňte jeho čísla ^FO. Abyste posunuli značku níže, zvyšte druhé číslo v ^FO180,8 (to 8).

Přidat nový řádek textu

Zkopírujte řádek ^FO…^FD…^FS, dejte mu větší hodnotu y, aby byl níže, a změňte obsah nebo proměnnou.

Zvětšit QR kód

Zvyšte poslední číslo v ^BQN,2,2 (zkuste ^BQN,3,3). Pokud se ořízne, dejte mu více místa nebo jej posuňte doleva/nahoru pomocí jeho ^FO.

Přidat oddělovací čáru

Použijte grafický box. ^FO0,40^GB540,2,2^FS nakreslí tenkou vodorovnou čáru širokou 540 bodů.

Náhled a testování před tiskem

Máte dva jednoduché způsoby, jak zkontrolovat design před použitím skutečných štítků:

  • V Gem Logic: při každém uložení se pod polem s designem zobrazí náhledový obrázek štítku. Použijte jej jako svou hlavní zpětnou vazbu.

  • Online: vložte svůj ZPL do bezplatného Labelary prohlížeče, abyste viděli okamžitý náhled v různých velikostech štítků. (Nejprve nahraďte {variables} ukázkovým textem, protože Labelary nezná data vašich produktů.)

Pokud skutečný štítek vypadá špatně — oříznutý text, QR kód, který se nedá naskenovat, nesprávná velikost — viz sekce štítků v Řešení problémů.

Rychlá reference příkazů

Příkaz

Co dělá

^XA / ^XZ

Začátek / konec štítku. Vše je mezi nimi.

^PW

Šířka tisku v bodech.

^LL

Délka štítku (výška) v bodech.

^LH

Label home — výchozí bod (obvykle 0,0).

^FO x,y

Field origin — umístit další prvek na x,y.

^CF0,h

Nastavit výchozí výšku písma (h bodů) pro následující text.

^FD ... ^FS

Field data — obsah k tisku — uzavřený oddělovačem pole.

^FX ... ^FS

Komentář — tiskárna jej ignoruje. Nesmí obsahovat ^ nebo ~.

^MD

Media darkness (tmavost tisku). Vyšší je tmavší.

^BQN,m,m

QR kód; poslední číslo je velikost. Data začínají QA,.

^BCN,h,...

Čárový kód Code 128; h je výška v bodech.

^GB w,h,t

Vykreslí rámeček nebo čáru (šířka, výška, tloušťka v bodech).

^CI28

Kódování znaků, aby se symboly jako € vytiskly správně.

Pro kompletní jazyk Zebra publikuje úplnou příručku příkazů ZPL, ale příkazy výše pokryjí téměř každý štítek produktu.