Zebra (ZPL) címkék tervezése

A Zebra címkenyomtatók nem értelmeznek normál dokumentumokat. Ehelyett szöveges parancsok egy kis halmazát olvassák, amelyet ZPL-nek (Zebra Programming Language) neveznek. Egy ZPL terv csupán egy szövegblokk, amely megmondja a nyomtatónak, hogy mit helyezzen el a címkén és hová: egy szövegsor itt, egy ár ott, egy QR-kód a sarokban.

Ez az oldal a ZPL-t az alapoktól magyarázza el, hogy Ön külső segítség nélkül tudjon olvasni, szerkeszteni és saját termék címkéket készíteni. A címkéjét a Konfiguráció ‣ Nyomtatók menüpontban tervezheti meg, az Egyéni Zebra termékcímke terv mezőben (lásd: Nyomtatókonfiguráció).

Javaslat

Ritkán kezd üres lappal. A Gem Logic minden címkéhez biztosít egy működő alapértelmezett tervet. A leggyorsabb tanulási mód, ha megnyitja ezt az alapértelmezett tervet, módosít rajta egy dolgot, elmenti, és megnézi az előnézeti képet. Ismételje, amíg megfelelőnek nem tűnik.

Gyors kezdés

  1. Lépjen a Konfiguráció ‣ Nyomtatók menüpontba, és keresse meg az Egyéni Zebra termékcímke terv mezőt.

  2. Végezzen el egy kis módosítást (például helyezzen át egy sort vagy növelje az ár méretét).

  3. Kattintson a Mentés gombra. A Gem Logic automatikusan generál egy előnézeti képet a címkéről.

  4. Nézze meg az előnézetet. Ha helytelen, módosítsa és mentse újra.

Semmi nem kerül továbbításra egy valódi nyomtatóra, amíg kísérletezik — az előnézet az Ön tervéből generálódik, így biztonságosan iterálhat, mielőtt egyetlen címkét is nyomtatna.

Hogyan épül fel egy ZPL címke

Minden címke ^XA-val kezdődik és ^XZ-vel végződik. A kettő közötti rész írja le a címkét. Egy parancs mindig kalappal ^ (vagy néha hullámjellel ~) kezdődik.

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

Belül a leggyakoribb minta ez: „menjen egy pozícióra, majd nyomtasson oda valamit”:

^FO50,30^FDHello^FS

Ez az egyetlen sor azt jelenti: menjen az 50,30 pozícióra és nyomtassa ki a „Hello” szöveget. Lebontva:

  • ^FO50,30 — Field Origin: ugrás x=50, y=30 pozícióra (a következő elem bal felső sarka).

  • ^FDHello — Field Data: a tényleges nyomtatandó tartalom.

  • ^FS — Field Separator: jelzi ennek a résznek a végét. Mindig zárjon le egy mezőt ^FS-sel.

Ez a címketervezés 90%-a: egymásra halmozott „pozíció + tartalom” sorok sorozata.

Címkeméret, pontok és milliméterek

A Zebra nyomtatók mindent pontokban mérnek, nem milliméterekben. A legtöbb címkenyomtató 203 DPI felbontással nyomtat, ami azt jelenti:

  • 1 mm ≈ 8 pont

  • 1 hüvelyk = 203 pont

Tehát egy 56 mm széles és 13 mm magas címke körülbelül 448 pont széles és 104 pont magas.

Két parancs állítja be a nyomtatható területet:

  • ^PW — Print Width, nyomtatási szélesség, pontokban.

  • ^LL — Label Length, címkehossz (magasság), pontokban.

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

Fontos

A fizikai címkeméret a tervezés melletti Termék címke szélessége és Termék címke hossza mezőkből is származik. Tartsa ezeket szinkronban a tényleges címkekészletével. A {label_length} változót a rendszer automatikusan tölti ki a hossz mezőből, ezért az alapértelmezett terv a ^LL{label_length} parancsot használja.

Pozicionálás: a koordináta-rács

Képzelje el a címkét rácsként. A 0,0 pont a bal felső sarok. Az első szám az x (mennyire jobbra), a második az y (mennyire lefelé), mindkettő pontokban.

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

Egy elem áthelyezéséhez módosítsa a ^FO értékeit. Nagyobb x = jobbrább; nagyobb y = lejjebb. Így helyezheti az SKU-t az egyik sorba és a fémet a következőbe: adjon nekik ugyanazt az x értéket, de nagyobb y értéket a második sorban.

Szöveg hozzáadása és méretezése

Szöveg nyomtatása előtt általában választ egy betűméretet. A legegyszerűbb módszer a ^CF0,h (Change default Font, alapértelmezett betűtípus módosítása), ahol a h a karaktermagasság pontokban:

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

Minden ^FD ... ^FS a ^CF után ezt a méretet használja, amíg Ön nem állít be másikat. Tehát több méret használatához egy címkén állítsa be a ^CF0,28 parancsot a nagy szöveg előtt és a ^CF0,14 parancsot a kis szöveg előtt.

Javaslat

Új szövegsor hozzáadásához nem kell az Enter billentyűt megnyomnia — egy másik, lejjebb pozicionált mezőt kell hozzáadnia. Másoljon egy meglévő sort, adjon neki nagyobb y értéket, és módosítsa a tartalmát.

Termékadatok beszúrása

A címketervet minden termékhez újra felhasználják, így az SKU-t vagy az árat nem kell kézzel begépelnie. Ehelyett változókat szúr be kapcsos zárójelekben, és a Gem Logic ezeket a címke nyomtatásakor minden termék valós adataival helyettesíti.

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

Ugyanezek a változók kattintható jelvényekként jelennek meg közvetlenül a tervezési mező alatt az alkalmazásban, így szerkesztés közben láthatja, melyek érhetők el.

Elérhető változók

Termék

  • {brand}: márkanév

  • {product_title}: termék címe

  • {item_sku}: termék SKU

  • {ean_code}: EAN vonalkód (QR-kódhoz használt)

  • {price} és {currency}: ár és pénznem szimbólum

  • {serial_number}: sorozatszám

  • {year_of_manufacture}: gyártási év

  • {supplier_product_reference}: beszállító termékreferenciája

  • {supplier_reference}: beszállítói referencia

Anyagok és drágakövek

  • {material_1}-től {material_5}: teljes anyagleírás (súly, név és drágakő részletek)

  • {material_only_1}-től {material_only_5}: csak az anyag vagy drágakő neve

Attribútumok

  • {attribute_1}-től {attribute_5}: attribútum név: érték formában

  • {attribute_name_1}-től {attribute_name_5}: csak az attribútum neve

  • {attribute_value_1}-től {attribute_value_5}: csak az attribútum értéke

Méretek

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

Kollekciók

  • {collections}: azok a kollekciók, amelyekhez a termék tartozik

Kategóriák

  • {categories}: azok a kategóriák, amelyekhez a termék tartozik, vesszővel elválasztva

Származási ország

  • {country_of_origin}: az az ország, ahonnan a termék származik

Tisztaság

  • {clarity}: a termék drágakövének tisztasága

Költségkód

  • {encoded_cost}: a beszerzési költség az Ön privát költségkódjába konvertálva (a betűk a Konfiguráció ‣ Általános beállítások alatt állíthatók be), így a valós költség nem olvasható a címkén.

RFID (csak RFID-chipes címkékhez szükséges)

  • {item_sku_epc_hex}: az SKU EPC-értékként kódolva az RFID-chip számára

  • {item_sku_epc_word_count}: az EPC-hossz, amelyet a ZPL RFID-parancs használ

Elrendezés

  • {label_length}: automatikusan kitöltve a címkehossz-beállításból

QR-kódok és vonalkódok

A QR-kód hozzáadása ^BQN kóddal történik, amelyet egy QA,-val kezdődő adatmező követ:

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

  • ^FO0,30 — a QR-kód pozíciója.

  • {BQN,2,2} — egy QR-kód. Az utolsó szám a méret (nagyítás). Növelje (3, 4, 5…) nagyobb, könnyebben beolvasható kódhoz; csökkentse a hely takarítása érdekében.

  • ^FDQA,{ean_code}^FS — a kódban lévő adatok. Itt a termék EAN-ját kódolja.

Klasszikus 1D vonalkód esetén használja inkább a ^BCN (Code 128) parancsot:

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

A 60 a vonalkód magassága pontokban, az Y pedig kiírja az olvasható számot alatta.

Az alapértelmezett kialakítás részletesen

Ez az alapértelmezett kialakítás, amelyet a Gem Logic biztosít, soronkénti magyarázatokkal. Ennek elolvasása a leggyorsabb módja annak, hogy megértse, hogyan illeszkednek egymáshoz az elemek.

^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

Soronként:

  • ^XA — a címke kezdete.

  • ^MD20 — nyomtatási sötétség. Emelje meg, ha a címkék halványnak tűnnek, csökkentse, ha a szöveg elmosódott.

  • ^CI28 — karakterkódolás, hogy a € és az ékezetek helyesen nyomtatódjanak.

  • ^LL{label_length} — címke magassága, automatikusan kitöltve a hossz beállításból.

  • ^LH0,0 — kezdőpont: az origó a bal felső sarok.

  • ^CF0,18 — szövegméret ~18 pont a következő sorokhoz.

  • ^FO180,8^FD{brand}^FS — a márka, a felső rész közelében.

  • ^CF0,14 — kisebb szöveg ettől kezdve.

  • ^FO50,45^FD{material_2}^FS, ^FO50,60^FD{material_3}^FS, ^FO180,27^FD{material_1}^FS — a három anyag.

  • ^CF0,28 — nagyobb szöveg az árhoz.

  • ^FO180,50^FD{currency}{price}^FS — az ár, pl. €129.

  • ^CF0,16 — közepes szöveg.

  • ^FO1,8^FD{item_sku}^FS — a SKU, bal felül.

  • ^FO1,23^FD{supplier_product_reference}^FS — beszállító termékhivatkozása.

  • ^FO50,60^FD{supplier_reference}^FS — beszállító hivatkozása.

  • ^FO0,30^BQN,2,2 majd ^FDQA,{ean_code}^FS — a QR-kód (bal lent) és annak adatai (az EAN).

  • ^XZ — a címke vége.

Figyelem

A ZPL-nek nincsenek soros megjegyzései — ne használjon pontosvesszőt ; jegyzetek hozzáadásához. A ZPL csak olyan parancsokat ért meg, amelyek ^ (vagy ~) jellel kezdődnek, így a ; utáni bármi a parancs értékének részeként (vagy szabad címkeadatként) olvasódik. Ez okozza az olyan hibákat, mint „Value «20;» is not a valid number” vagy „Ignored unrecognized content”, és egy eltévedt ; csendben eltolhatja vagy tönkreteheti az elrendezést.

Jegyzet hagyásához használja a ^FX megjegyzés parancsot, ^FS-sel zárva. A nyomtató mindent figyelmen kívül hagy benne:

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

Az egyetlen szabály: egy ^FX megjegyzés nem tartalmazhat ^ vagy ~ karaktereket — ezek a karakterek lezárják a megjegyzést és elindítják a következő parancsot.

Gyakori módosítások

Az ár nagyobbá tétele

Keresse meg a ^CF0,28 parancsot a {price} sor előtt, és növelje a számot, pl. ^CF0,40.

Valami mozgatása

Változtassa meg a ^FO számait. A márka lefelé mozgatásához növelje a második számot a ^FO180,8 parancsban (a 8-at).

Új szövegsor hozzáadása

Másoljon egy ^FO…^FD…^FS sort, adjon neki nagyobb y értéket, hogy lejjebb kerüljön, és változtassa meg a tartalmat vagy a változót.

A QR-kód nagyítása

Növelje az utolsó számot a ^BQN,2,2 parancsban (próbálja meg a ^BQN,3,3 értéket). Ha levágódik, adjon neki több helyet, vagy mozgassa balra/felfelé a ^FO paraméterrel.

Elválasztó vonal hozzáadása

Használjon grafikus dobozt. A ^FO0,40^GB540,2,2^FS parancs egy 540 pont széles vékony vízszintes vonalat rajzol.

Előnézet és tesztelés nyomtatás előtt

Két egyszerű módja van a dizájn ellenőrzésének, mielőtt valódi címkéket használna:

  • A Gem Logicban: minden mentéskor a címke előnézeti képe megjelenik a dizájnmező alatt. Használja ezt a fő visszajelzési forrásaként.

  • Online: illessze be a ZPL-t az ingyenes Labelary viewer eszközbe, hogy azonnali megjelenítést lásson különböző címkeméretekben. (Először cserélje le a {variables} helyőrzőket mintaszövegre, mivel a Labelary nem ismeri az Ön termékadatait.)

Ha egy valódi címke rosszul néz ki — levágott szöveg, nem szkennelhető QR-kód, rossz méret —, tekintse meg a Hibaelhárítás címke szakaszát.

Parancsok gyors referenciája

Parancs

Mit csinál

^XA / ^XZ

A címke kezdete / vége. Minden ezek között található.

^PW

Nyomtatási szélesség pontokban.

^LL

Címke hossza (magasság) pontokban.

^LH

Címke origója — a kiindulási pont (általában 0,0).

^FO x,y

Mező origója — a következő elem pozicionálása x,y koordinátán.

^CF0,h

Az alapértelmezett betűméret (h pont) beállítása a következő szöveghez.

^FD ... ^FS

Mező adatai — a nyomtatandó tartalom — mezőelválasztóval lezárva.

^FX ... ^FS

Megjegyzés — a nyomtató figyelmen kívül hagyja. Nem tartalmazhat ^ vagy ~ karaktert.

^MD

Média sötétség (nyomtatási sötétség). A magasabb érték sötétebb.

^BQN,m,m

QR kód; az utolsó szám a méret. Az adatok QA,-val kezdődnek.

^BCN,h,...

Code 128 vonalkód; h a magasság pontokban.

^GB w,h,t

Keret vagy vonal rajzolása (szélesség, magasság, vastagság pontokban).

^CI28

Karakterkódolás, hogy az olyan szimbólumok, mint €, helyesen nyomtatódjanak.

A teljes nyelvhez a Zebra teljes ZPL parancsútmutatót tesz közzé, de a fenti parancsok szinte minden termékcímkét lefednek.