Дизайн на Zebra (ZPL) етикети

Принтерите за етикети Zebra не разбират обикновени документи. Вместо това те четат малък набор от текстови команди, наречени ZPL (Zebra Programming Language). ZPL дизайнът е просто блок текст, който казва на принтера какво да постави на етикета и къде: текстов ред тук, цена там, QR код в ъгъла.

Тази страница обяснява ZPL от нулата, така че можете да четете, редактирате и създавате свои собствени продуктови етикети без помощ. Вие създавате етикета си в Конфигурация ‣ Принтери, в полето Персонализиран Zebra дизайн на продуктов етикет (вижте Конфигурация на принтера).

Tip

Рядко започвате от празна страница. Gem Logic дава на всеки етикет работещ стандартен дизайн. Най-бързият начин да научите е да отворите този стандарт, да промените едно нещо, да запазите и да разгледате изображението за преглед. Повтаряйте, докато изглежда правилно.

Бърз старт

  1. Отидете в Конфигурация ‣ Принтери и намерете полето Персонализиран Zebra дизайн на продуктов етикет.

  2. Направете малка промяна (например преместете ред или увеличете цената).

  3. Щракнете върху Запази. Gem Logic автоматично генерира изображение за преглед на етикета.

  4. Разгледайте прегледа. Ако е грешен, коригирайте и запазете отново.

Нищо не се изпраща до реален принтер, докато експериментирате — прегледът се генерира от Вашия дизайн, така че можете безопасно да итерирате преди да отпечатате един единствен етикет.

Как се изгражда ZPL етикет

Всеки етикет започва с ^XA и завършва с ^XZ. Всичко помежду описва етикета. Командата винаги започва със знак ^ (или понякога тилда ~).

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

Вътре най-често срещаният модел е „отидете на позиция, след това отпечатайте нещо там“:

^FO50,30^FDHello^FS

Този единствен ред означава: отидете на позиция 50,30 и отпечатайте текста „Hello“. Разбивка:

  • ^FO50,30 — Field Origin: преместете се на x=50, y=30 (горният ляв ъгъл на това, което следва).

  • ^FDHello — Field Data: действителното съдържание за отпечатване.

  • ^FS — Field Separator: маркира края на този елемент. Винаги затваряйте поле с ^FS.

Това е 90% от дизайна на етикети: серия от редове „позиция + съдържание“, подредени заедно.

Размер на етикета, точки и милиметри

Принтерите Zebra измерват всичко в точки, а не в милиметри. Повечето принтери за етикети печатат при 203 DPI, което означава:

  • 1 mm ≈ 8 точки

  • 1 инч = 203 точки

Така етикет, който е широк 56 mm и висок 13 mm, е приблизително 448 точки широк и 104 точки висок.

Две команди задават печатната зона:

  • ^PW — Print Width, ширина на печат, в точки.

  • ^LL — Label Length, дължина на етикета (височина), в точки.

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

Important

Физическият размер на етикета идва също от полетата Ширина на етикета на продукт и Дължина на етикета на продукт до дизайна. Поддържайте ги синхронизирани с Вашия реален запас от етикети. Променливата {label_length} се попълва автоматично от полето за дължина, поради което стандартният дизайн използва ^LL{label_length}.

Позициониране: координатна мрежа

Мислете за етикета като за мрежа. Точката 0,0 е горният ляв ъгъл. Първото число е x (колко надясно) и второто е y (колко надолу), и двете в точки.

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

За да преместите елемент, променете неговите ^FO числа. По-голямо x = по-надясно; по-голямо y = по-надолу. Ето как поставяте SKU на един ред, а метала на следващия: дайте им един и същ x, но по-голямо y на втория ред.

Добавяне и оразмеряване на текст

Преди да отпечатате текст обикновено избирате размер на шрифта. Най-простият начин е ^CF0,h (Change default Font, промяна на шрифта по подразбиране), където h е височината на символите в точки:

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

Всяко ^FD ... ^FS след ^CF използва този размер, докато не зададете друг. Така че за да смесите размери на един етикет, задайте ^CF0,28 преди големия текст и ^CF0,14 преди малкия текст.

Tip

За да добавите нов ред текст, не натискате Enter — добавяте друго позиционирано поле по-надолу. Копирайте съществуващ ред, дайте му по-голяма стойност на y и променете съдържанието му.

Вмъкване на данни за продукта

Дизайнът на етикет се използва повторно за всеки продукт, така че не въвеждате SKU или цена ръчно. Вместо това вмъквате променливи във фигурни скоби и Gem Logic ги заменя с реалните данни на всеки продукт при отпечатване на етикета.

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

Същите променливи са показани като кликваеми значки директно под полето за дизайн в приложението, така че можете да видите кои са налични, докато редактирате.

Налични променливи

Продукт

  • {brand}: име на марката

  • {product_title}: заглавие на продукта

  • {item_sku}: SKU на продукта

  • {ean_code}: EAN баркод (използва се за QR кода)

  • {price} и {currency}: цена и символ на валутата

  • {serial_number}: сериен номер

  • {year_of_manufacture}: година на производство

  • {supplier_product_reference}: продуктова референция на доставчика

  • {supplier_reference}: референция на доставчика

Материали и скъпоценни камъни

  • {material_1} до {material_5}: пълно описание на материала (тегло, наименование и детайли за скъпоценния камък)

  • {material_only_1} до {material_only_5}: само наименование на материала или скъпоценния камък

Атрибути

  • {attribute_1} до {attribute_5}: атрибут във формат име: стойност

  • {attribute_name_1} до {attribute_name_5}: само име на атрибута

  • {attribute_value_1} до {attribute_value_5}: само стойност на атрибута

Размери

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

Колекции

  • {collections}: колекциите, към които принадлежи продуктът

Категории

  • {categories}: категориите, към които принадлежи продуктът, разделени със запетая

Страна на произход

  • {country_of_origin}: страната, от която произхожда продуктът

Чистота

  • {clarity}: чистотата на скъпоценния камък на продукта

Код за цена

  • {encoded_cost}: покупната цена, преобразувана във Вашия личен код за цена (буквите се задават под Конфигурация ‣ Общи настройки), така че реалната цена да не е четима на етикета.

RFID (необходимо само за етикети с RFID чипове)

  • {item_sku_epc_hex}: SKU, кодирано като EPC стойност за RFID чипа

  • {item_sku_epc_word_count}: дължината на EPC, използвана от ZPL RFID командата

Оформление

  • {label_length}: попълва се автоматично от настройката за дължина на етикета

QR кодове и баркодове

QR код се добавя с ^BQN, последван от поле за данни, което започва с QA,:

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

  • ^FO0,30 — позицията на QR кода.

  • ^BQN,2,2 — QR код. Последното число е размерът (увеличение). Увеличете го (3, 4, 5…) за по-голям и по-лесно сканируем код; намалете го, за да спестите място.

  • ^FDQA,{ean_code}^FS — данните в кода. Тук кодира EAN на продукта.

За класически едномерен баркод вместо това използвайте ^BCN (Code 128):

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

60 е височината на баркода в точки, а Y отпечатва четимия номер под него.

Стандартният дизайн, обяснен

Това е началният дизайн, който Gem Logic Ви предоставя, с анотации на всеки ред. Прочитането му е най-бързият начин да разберете как елементите се свързват помежду си.

^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

Ред по ред:

  • ^XA — начало на етикета.

  • ^MD20 — интензитет на печат. Увеличете го, ако етикетите изглеждат бледи, намалете го, ако текстът е размазан.

  • ^CI28 — кодиране на символи, така че € и ударенията се отпечатват правилно.

  • ^LL{label_length} — височина на етикета, попълнена автоматично от настройката за дължина.

  • ^LH0,0 — начална позиция: началото е горният ляв ъгъл.

  • ^CF0,18 — размер на текста ~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 — цената, например €129.

  • ^CF0,16 — среден текст.

  • ^FO1,8^FD{item_sku}^FS — SKU, горе вляво.

  • ^FO1,23^FD{supplier_product_reference}^FS — продуктова референция на доставчика.

  • ^FO50,60^FD{supplier_reference}^FS — референция на доставчика.

  • ^FO0,30^BQN,2,2 след това ^FDQA,{ean_code}^FS — QR кодът (долу вляво) и неговите данни (EAN).

  • ^XZ — край на етикета.

Warning

ZPL няма коментари на ред — не използвайте точка и запетая ; за добавяне на бележки. ZPL разбира само команди, които започват с ^ (или ~), така че всичко след ; се чете като част от стойността на командата (или като странични данни на етикета). Това е причината за грешки като „Value ‚20;‘ is not a valid number“ или „Ignored unrecognized content“, а случайна ; може тихо да измести или разруши оформлението Ви.

За да оставите бележка, използвайте командата за коментар ^FX, затворена с ^FS. Принтерът игнорира всичко вътре в нея:

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

Единственото правило: коментар ^FX не може да съдържа ^ или ~ — тези символи прекратяват коментара и стартират следващата команда.

Често срещани промени

Увеличете цената

Намерете ^CF0,28 преди реда {price} и увеличете числото, например ^CF0,40.

Преместете нещо

Променете числата му ^FO. За да преместите марката надолу, увеличете второто число в ^FO180,8 (8).

Добавете нов ред текст

Копирайте ред ^FO…^FD…^FS, дайте му по-голяма стойност y, за да се позиционира по-ниско, и променете съдържанието или променливата.

Увеличете QR кода

Увеличете последното число в ^BQN,2,2 (опитайте ^BQN,3,3). Ако се отреже, дайте му повече място или го преместете наляво/нагоре с неговия ^FO.

Добавете разделителна линия

Използвайте графична кутия. ^FO0,40^GB540,2,2^FS изчертава тънка хоризонтална линия с широчина 540 точки.

Преглед и тест преди печат

Разполагате с два лесни начина да проверите дизайна преди да използвате истински етикети:

  • В Gem Logic: всеки път когато запазите, под полето за дизайн се появява изображение за преглед на етикета. Използвайте го като основна обратна връзка.

  • Онлайн: поставете Вашия ZPL в безплатния Labelary viewer, за да видите незабавен изглед при различни размери на етикети. (Първо заменете {variables} с примерен текст, тъй като Labelary не познава Вашите продуктови данни.)

Ако реален етикет изглежда неправилно — отрязан текст, QR, който не се сканира, грешен размер — вижте секцията за етикети в Отстраняване на неизправности.

Бърза справка за команди

Команда

Какво прави

^XA / ^XZ

Начало / край на етикета. Всичко се намира между тях.

^PW

Широчина на печат в точки.

^LL

Дължина на етикета (височина) в точки.

^LH

Label home — началната точка (обикновено 0,0).

^FO x,y

Field origin — позициониране на следващия елемент на x,y.

^CF0,h

Задава височината на шрифта по подразбиране (h точки) за следващия текст.

^FD ... ^FS

Field data — съдържанието за печат — затворено с разделител на поле.

^FX ... ^FS

Коментар — игнорира се от принтера. Не може да съдържа ^ или ~.

^MD

Media darkness (тъмнина на печата). По-високо е по-тъмно.

^BQN,m,m

QR код; последното число е размерът. Данните започват с QA,.

^BCN,h,...

Баркод Code 128; h е височината в точки.

^GB w,h,t

Начертава правоъгълник или линия (ширина, височина, дебелина в точки).

^CI28

Кодиране на символи, за да се отпечатват правилно символи като €.

За пълния език Zebra публикува подробно ръководство за ZPL командите, но горните команди покриват почти всички етикети за продукти.