Zebra (ZPL) etiket tasarımı

Zebra etiket yazıcıları normal belgeleri anlamaz. Bunun yerine ZPL (Zebra Programming Language) adı verilen küçük bir metin komutları setini okurlar. Bir ZPL tasarımı, yazıcıya etikete neyin nereye yerleştirileceğini söyleyen bir metin bloğudur: buraya bir metin satırı, oraya bir fiyat, köşeye bir QR kodu.

Bu sayfa, ZPL’yi sıfırdan açıklayarak kendi ürün etiketlerinizi okuyabilmeniz, düzenleyebilmeniz ve yardım almadan oluşturabilmeniz için hazırlanmıştır. Etiketinizi Yapılandırma ‣ Yazıcılar altında, Özel Zebra ürün etiketi tasarımı alanında tasarlarsınız (bkz. Yazıcı yapılandırması).

Tüyo

Boş bir sayfadan başlamanız nadirdir. Gem Logic her etikete çalışan bir varsayılan tasarım verir. Öğrenmenin en hızlı yolu, bu varsayılanı açmak, bir şeyi değiştirmek, kaydetmek ve önizleme görüntüsüne bakmaktır. Doğru görünene kadar tekrarlayın.

Hızlı başlangıç

  1. Yapılandırma ‣ Yazıcılar menüsüne gidin ve Özel Zebra ürün etiketi tasarımı alanını bulun.

  2. Küçük bir değişiklik yapın (örneğin bir satırı hareket ettirin veya fiyatı büyütün).

  3. Kaydet’e tıklayın. Gem Logic otomatik olarak etiketin bir önizleme görüntüsünü oluşturur.

  4. Önizlemeye bakın. Yanlışsa, ayarlayın ve tekrar kaydedin.

Deneme yaparken gerçek bir yazıcıya hiçbir şey gönderilmez — önizleme tasarımınızdan oluşturulur, böylece tek bir etiket yazdırmadan önce güvenle deneme yapabilirsiniz.

Bir ZPL etiket nasıl oluşturulur

Her etiket ^XA ile başlar ve ^XZ ile biter. Aradaki her şey etiketi tanımlar. Bir komut her zaman bir şapka işaretiyle ^ (veya bazen tilde ~ ile) başlar.

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

İçinde en yaygın desen “bir konuma git, sonra oraya bir şey yazdır” şeklindedir:

^FO50,30^FDHello^FS

Bu tek satır şunu ifade eder: 50,30 konumuna git ve “Hello” metnini yazdır. Ayrıntılı olarak:

  • ^FO50,30 — Field Origin: x=50, y=30 konumuna git (bir sonraki öğenin sol üst köşesi).

  • ^FDHello — Field Data: yazdırılacak gerçek içerik.

  • ^FS — Field Separator: bu parçanın sonunu işaretler. Bir alanı her zaman ^FS ile kapatın.

Etiket tasarımının %90’ı budur: bir araya yığılmış “konum + içerik” satırları dizisi.

Etiket boyutu, noktalar ve milimetreler

Zebra yazıcılar her şeyi milimetre cinsinden değil, nokta cinsinden ölçer. Çoğu etiket yazıcı 203 DPI çözünürlükte yazdırır, yani:

  • 1 mm ≈ 8 nokta

  • 1 inç = 203 nokta

Dolayısıyla 56 mm genişliğinde ve 13 mm yüksekliğinde bir etiket yaklaşık 448 nokta genişliğinde ve 104 nokta yüksekliğindedir.

Yazdırılabilir alanı iki komut belirler:

  • ^PW — Print Width, yazdırma genişliği, nokta cinsinden.

  • ^LL — Label Length, etiket uzunluğu (yükseklik), nokta cinsinden.

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

Önemli

Fiziksel etiket boyutu ayrıca tasarımın yanındaki Ürün etiketi genişliği ve Ürün etiketi uzunluğu alanlarından gelir. Bunları gerçek etiket stokunuzla senkronize tutun. {label_length} değişkeni, uzunluk alanından otomatik olarak doldurulur; bu nedenle varsayılan tasarım ^LL{label_length} kullanır.

Konumlandırma: koordinat ızgarası

Etiketi bir ızgara olarak düşünün. 0,0 noktası sol üst köşe**dir. İlk sayı **x (sağa doğru ne kadar), ikincisi y (aşağıya doğru ne kadar), her ikisi de nokta cinsindendir.

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

Bir öğeyi taşımak için ^FO sayılarını değiştirin. Daha büyük x = daha sağda; daha büyük y = daha aşağıda. SKU’yu bir satıra ve metali bir sonrakine şu şekilde yerleştirirsiniz: onlara aynı x değerini verin ama ikinci satırda daha büyük bir y değeri kullanın.

Metin ekleme ve boyutlandırma

Metin yazdırmadan önce genellikle bir yazı tipi boyutu seçersiniz. En basit yol ^CF0,h (Change default Font, varsayılan yazı tipini değiştir) komutudur; burada h, karakter yüksekliğini nokta cinsinden belirtir:

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

Bir ^CF komutundan sonraki her ^FD ... ^FS komutu, siz farklı bir boyut belirleyene kadar o boyutu kullanır. Dolayısıyla bir etiket üzerinde boyutları karıştırmak için büyük metnin önüne ^CF0,28, küçük metnin önüne ^CF0,14 yazın.

Tüyo

Yeni bir metin satırı eklemek için Enter tuşuna basmazsınız — daha aşağıya konumlandırılmış başka bir alan eklersiniz. Mevcut bir satırı kopyalayın, ona daha büyük bir y değeri verin ve içeriğini değiştirin.

Ürün verilerini ekleme

Bir etiket tasarımı her ürün için yeniden kullanılır, dolayısıyla SKU veya fiyatı elle yazmazsınız. Bunun yerine süslü parantezler içinde değişkenler eklersiniz ve Gem Logic bunları etiket yazdırıldığında her ürünün gerçek verileriyle değiştirir.

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

Aynı değişkenler, uygulamada tasarım alanının hemen altında tıklanabilir rozetler olarak gösterilir, böylece düzenlerken hangi değişkenlerin kullanılabilir olduğunu görebilirsiniz.

Kullanılabilir değişkenler

Ürün

  • {brand}: marka adı

  • {product_title}: ürün başlığı

  • {item_sku}: ürün SKU’su

  • {ean_code}: EAN barkodu (QR kodu için kullanılır)

  • {price} ve {currency}: fiyat ve para birimi simgesi

  • {serial_number}: seri numarası

  • {year_of_manufacture}: üretim yılı

  • {supplier_product_reference}: tedarikçinin ürün referansı

  • {supplier_reference}: tedarikçi referansı

Malzemeler ve değerli taşlar

  • {material_1} ile {material_5} arası: eksiksiz malzeme açıklaması (ağırlık, isim ve değerli taş detayları)

  • {material_only_1} ile {material_only_5} arası: yalnızca malzeme veya değerli taş adı

Özellikler

  • {attribute_1} ile {attribute_5} arası: ad: değer biçiminde özellik

  • {attribute_name_1} ile {attribute_name_5} arası: yalnızca özellik adı

  • {attribute_value_1} ile {attribute_value_5} arası: yalnızca özellik değeri

Boyutlar

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

Koleksiyonlar

  • {collections}: ürünün ait olduğu koleksiyonlar

Kategoriler

  • {categories}: ürünün ait olduğu kategoriler, virgülle ayrılmış

Menşe ülke

  • {country_of_origin}: ürünün geldiği ülke

Saflık

  • {clarity}: ürünün değerli taş saflığı

Maliyet kodu

  • {encoded_cost}: satın alma maliyeti, özel maliyet kodunuza dönüştürülmüştür (harfler Yapılandırma ‣ Genel ayarlar altında belirlenir), böylece gerçek maliyet etiket üzerinde okunamaz.

RFID (yalnızca RFID etiketli etiketler için gereklidir)

  • {item_sku_epc_hex}: RFID çipi için EPC değeri olarak kodlanmış SKU

  • {item_sku_epc_word_count}: ZPL RFID komutu tarafından kullanılan EPC uzunluğu

Düzen

  • {label_length}: etiket uzunluğu ayarından otomatik olarak doldurulur

QR kodları ve barkodlar

Bir QR kodu, ^BQN ile eklenir ve ardından QA, ile başlayan bir veri alanı gelir:

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

  • ^FO0,30 — QR kodunun konumu.

  • ^BQN,2,2 — bir QR kodu. Son sayı boyuttur (büyütme). Daha büyük, taranması daha kolay bir kod için artırın (3, 4, 5…); yer kazanmak için azaltın.

  • ^FDQA,{ean_code}^FS — kod içindeki veri. Burada ürünün EAN kodunu kodlar.

Klasik bir 1D barkod için bunun yerine ^BCN (Code 128) kullanın:

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

60 nokta cinsinden barkod yüksekliğidir ve Y okunabilir sayıyı altına yazdırır.

Varsayılan tasarım, açıklamalı

Gem Logic’in size verdiği başlangıç tasarımı, satır satır açıklamalı olarak sunulmuştur. Okumak, parçaların nasıl bir araya geldiğini anlamanın en hızlı yoludur.

^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

Satır satır:

  • ^XA — etiketin başlangıcı.

  • ^MD20 — baskı koyuluğu. Etiketler soluk görünüyorsa artırın, metin bulaşıksa azaltın.

  • ^CI28 — karakter kodlaması, böylece € ve aksan işaretleri doğru yazdırılır.

  • ^LL{label_length} — etiket yüksekliği, uzunluk ayarından otomatik olarak doldurulur.

  • ^LH0,0 — ana konum: başlangıç noktası sol üst köşedir.

  • ^CF0,18 — aşağıdaki satırlar için metin boyutu ~18 nokta.

  • ^FO180,8^FD{brand}^FS — marka, üst kısma yakın.

  • ^CF0,14 — buradan itibaren daha küçük metin.

  • ^FO50,45^FD{material_2}^FS, ^FO50,60^FD{material_3}^FS, ^FO180,27^FD{material_1}^FS — üç malzeme.

  • ^CF0,28 — fiyat için daha büyük metin.

  • ^FO180,50^FD{currency}{price}^FS — fiyat, örn. €129.

  • ^CF0,16 — orta boy metin.

  • ^FO1,8^FD{item_sku}^FS — SKU, sol üst.

  • ^FO1,23^FD{supplier_product_reference}^FS — tedarikçinin ürün referansı.

  • ^FO50,60^FD{supplier_reference}^FS — tedarikçi referansı.

  • ^FO0,30^BQN,2,2 ardından ^FDQA,{ean_code}^FS — QR kodu (sol alt) ve verisi (EAN).

  • ^XZ — etiketin sonu.

Uyarı

ZPL’de satır yorumu yoktur — not eklemek için noktalı virgül kullanmayın ; . ZPL yalnızca ^ (veya ~) ile başlayan komutları anlar, dolayısıyla ; sonrası her şey komutun değerinin bir parçası olarak (veya başıboş etiket verisi olarak) okunur. “Value ‘20;’ is not a valid number” veya “Ignored unrecognized content” gibi hataların nedeni budur ve başıboş bir ; düzeninizi sessizce kaydırabilir veya bozabilir.

Not bırakmak için ^FX yorum komutu kullanın ve ^FS ile kapatın. Yazıcı içindeki her şeyi yok sayar:

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

Tek kural: ^FX yorumu ^ veya ~ içeremez — bu karakterler yorumu sonlandırır ve bir sonraki komutu başlatır.

Yaygın değişiklikler

Fiyatı büyütmek

{price} satırından önceki ^CF0,28 komutunu bulun ve sayıyı artırın, örn. ^CF0,40.

Bir şeyi taşımak

^FO sayılarını değiştirin. Markayı aşağı kaydırmak için ^FO180,8 içindeki ikinci sayıyı (8) artırın.

Yeni bir metin satırı eklemek

Bir ^FO…^FD…^FS satırını kopyalayın, daha aşağıda yer alması için daha büyük bir y değeri verin ve içeriği veya değişkeni değiştirin.

QR kodunu büyütün

^BQN,2,2 içindeki son sayıyı artırın (^BQN,3,3 deneyin). Kesilirse, ona daha fazla alan verin veya ^FO ile sola/yukarı taşıyın.

Ayırıcı çizgi ekleyin

Bir grafik kutu kullanın. ^FO0,40^GB540,2,2^FS 540 nokta genişliğinde ince bir yatay çizgi çizer.

Yazdırmadan önce önizleme yapın ve test edin

Gerçek etiketleri kullanmadan önce tasarımı kontrol etmenin iki kolay yolu vardır:

  • Gem Logic’te: her kaydettiğinizde, tasarım alanının altında etiketin önizleme görüntüsü görünür. Bunu ana geri bildirim döngünüz olarak kullanın.

  • Çevrimiçi: ZPL kodunuzu ücretsiz Labelary görüntüleyici içine yapıştırarak farklı etiket boyutlarında anında önizleme görebilirsiniz. (Labelary ürün verilerinizi bilmediğinden, önce {variables} yerine örnek metin yazın.)

Gerçek bir etiket yanlış görünüyorsa — kesilen metin, taranmayan bir QR, yanlış boyut — Sorun giderme belgesinin etiket bölümüne bakın.

Komut hızlı referansı

Komut

Ne yapar

^XA / ^XZ

Etiketin başlangıcı / sonu. Her şey bunların arasında yer alır.

^PW

Nokta cinsinden yazdırma genişliği.

^LL

Nokta cinsinden etiket uzunluğu (yükseklik).

^LH

Etiket başlangıç noktası — orijin noktası (genellikle 0,0).

^FO x,y

Alan orijini — sonraki öğeyi x,y konumuna yerleştirir.

^CF0,h

Sonraki metin için varsayılan yazı tipi yüksekliğini (h nokta) ayarlar.

^FD ... ^FS

Alan verisi — yazdırılacak içerik — alan ayırıcısıyla kapatılır.

^FX ... ^FS

Yorum — yazıcı tarafından göz ardı edilir. ^ veya ~ içeremez.

^MD

Ortam koyuluğu (yazdırma koyuluğu). Daha yüksek daha koyudur.

^BQN,m,m

QR kodu; son sayı boyuttur. Veriler QA, ile başlar.

^BCN,h,...

Code 128 barkodu; h nokta cinsinden yüksekliktir.

^GB w,h,t

Bir kutu veya çizgi çizer (nokta cinsinden genişlik, yükseklik, kalınlık).

^CI28

Karakter kodlaması, böylece € gibi semboller doğru yazdırılır.

Dilin tamamı için Zebra kapsamlı bir ZPL komut kılavuzu yayınlar, ancak yukarıdaki komutlar hemen hemen her ürün etiketini kapsar.