Zebra (ZPL) -tarrojen suunnittelu

Zebra-tarratulostimet eivät ymmärrä tavallisia asiakirjoja. Sen sijaan ne lukevat pientä joukkoa tekstikomentoja, joita kutsutaan nimellä ZPL (Zebra Programming Language). ZPL-suunnitelma on vain tekstilohko, joka kertoo tulostimelle, mitä tarraan laitetaan ja mihin: tekstirivi tähän, hinta tuonne, QR-koodi nurkkaan.

Tämä sivu selittää ZPL:n alusta alkaen, jotta voitte lukea, muokata ja rakentaa omia tuotetarroja ilman apua. Suunnittelette tarranne kohdassa Asetukset ‣ Tulostimet kentässä Mukautettu Zebra-tuotetarran suunnitelma (katso Tulostimen määritys).

Vihje

Aloitatte harvoin tyhjältä sivulta. Gem Logic antaa jokaiselle tarralle toimivan oletussuunnitelman. Nopein tapa oppia on avata tuo oletussuunnitelma, muuttaa yhtä asiaa, tallentaa ja katsoa esikatselukuvaa. Toistakaa, kunnes se näyttää oikealta.

Pika-aloitus

  1. Siirtykää kohtaan Asetukset ‣ Tulostimet ja etsikää kenttä Mukautettu Zebra-tuotetarran suunnitelma.

  2. Tehkää pieni muutos (esimerkiksi siirtäkää rivi tai suurentakaa hintaa).

  3. Napsauttakaa Tallenna. Gem Logic luo automaattisesti esikatselukuvan tarrasta.

  4. Katsokaa esikatselua. Jos se on väärin, säätäkää ja tallentakaa uudelleen.

Mitään ei lähetetä oikeaan tulostimeen kokeilujenne aikana — esikatselu luodaan suunnitelmastanne, joten voitte iteroida turvallisesti ennen yhdenkään tarran tulostamista.

ZPL-tarran rakentaminen

Jokainen tarra alkaa ^XA:lla ja päättyy ^XZ:een. Kaikki niiden välissä kuvaa tarran. Komento alkaa aina hattu-merkillä ^ (tai joskus aaltomerkillä ~).

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

Sisällä yleisin kaava on ”siirry paikkaan ja tulosta sitten jotain sinne”:

^FO50,30^FDHello^FS

Tuo yksittäinen rivi tarkoittaa: siirry paikkaan 50,30 ja tulosta teksti ”Hello”. Eriteltynä:

  • ^FO50,30 — Field Origin: siirry kohtaan x=50, y=30 (seuraavan asian vasen yläkulma).

  • ^FDHello — Field Data: tulostettava varsinainen sisältö.

  • ^FS — Field Separator: merkitsee tämän osan lopun. Sulkekaa kenttä aina ^FS:llä.

Tuo on 90 % tarran suunnittelusta: sarja ”paikka + sisältö” -rivejä pinottuna yhteen.

Etiketin koko, pisteet ja millimetrit

Zebra-tulostimet mittaavat kaiken pisteissä, eivät millimetreinä. Useimmat etikettitulostimet tulostavat 203 DPI -tarkkuudella, mikä tarkoittaa:

  • 1 mm ≈ 8 pistettä

  • 1 tuuma = 203 pistettä

Esimerkiksi 56 mm leveä ja 13 mm korkea etiketti on noin 448 pistettä leveä ja 104 pistettä korkea.

Kaksi komentoa määrittävät tulostusalueen:

  • ^PW — Print Width, tulostusleveys pisteissä.

  • ^LL — Label Length, etiketin pituus (korkeus) pisteissä.

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

Tärkeä

Etiketin fyysinen koko määräytyy myös mallin vieressä olevista kentistä Tuoteetiketin leveys ja Tuoteetiketin pituus. Pidä nämä synkronoituina todellisen etikettirullanne kanssa. Muuttuja {label_length} täytetään automaattisesti pituuskentästä, minkä vuoksi oletusmalli käyttää komentoa ^LL{label_length}.

Paikantaminen: koordinaattiruudukko

Ajatelkaa etikettiä ruudukkona. Piste 0,0 on vasen yläkulma. Ensimmäinen luku on x (kuinka kaukana oikealla) ja toinen on y (kuinka kaukana alhaalla), molemmat pisteissä.

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

Elementin siirtämiseksi muuttakaa sen ^FO-lukuja. Suurempi x = kauempana oikealla; suurempi y = kauempana alhaalla. Näin sijoitatte SKU:n yhdelle riville ja metallin seuraavalle: antakaa niille sama x mutta suurempi y toisella rivillä.

Tekstin lisääminen ja koon muuttaminen

Ennen tekstin tulostamista valitsette yleensä fonttikoon. Yksinkertaisin tapa on ^CF0,h (Change default Font, vaihda oletusfontti), jossa h on merkin korkeus pisteissä:

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

Jokainen ^FD ... ^FS komennon ^CF jälkeen käyttää kyseistä kokoa, kunnes asetatte toisen. Joten useiden kokojen sekoittamiseksi yhdelle etiketille asettakaa ^CF0,28 ennen suurta tekstiä ja ^CF0,14 ennen pientä tekstiä.

Vihje

Uuden tekstirivin lisäämiseksi ette paina Enter-näppäintä — lisäätte toisen paikannettavan kentän alemmaksi. Kopioikaa olemassa oleva rivi, antakaa sille suurempi y-arvo ja muuttakaa sen sisältöä.

Tuotetietojen lisääminen

Etikettimallia käytetään uudelleen jokaiselle tuotteelle, joten Teillä ei ole tarpeen kirjoittaa SKU:ta tai hintaa käsin. Sen sijaan lisäätte muuttujia aaltosulkeissa, ja Gem Logic korvaa ne kunkin tuotteen todellisilla tiedoilla etiketin tulostuessa.

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

Samat muuttujat näytetään klikattavina merkkeinä suoraan mallikentän alla sovelluksessa, joten näette, mitkä ovat käytettävissä muokkauksen aikana.

Käytettävissä olevat muuttujat

Tuote

  • {brand}: tuotemerkin nimi

  • {product_title}: tuotteen otsikko

  • {item_sku}: tuotteen SKU

  • {ean_code}: EAN-viivakoodi (käytetään QR-koodissa)

  • {price} ja {currency}: hinta ja valuuttasymboli

  • {serial_number}: sarjanumero

  • {year_of_manufacture}: valmistusvuosi

  • {supplier_product_reference}: toimittajan tuoteviite

  • {supplier_reference}: toimittajaviite

Materiaalit ja jalokivet

  • {material_1} - {material_5}: täydellinen materiaalikuvaus (paino, nimi ja jalokivitiedot)

  • {material_only_1} - {material_only_5}: vain materiaalin tai jalokiven nimi

Attribuutit

  • {attribute_1} - {attribute_5}: attribuutti muodossa nimi: arvo

  • {attribute_name_1} - {attribute_name_5}: vain attribuutin nimi

  • {attribute_value_1} - {attribute_value_5}: vain attribuutin arvo

Mitat

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

Kokoelmat

  • {collections}: kokoelmat, joihin tuote kuuluu

Kategoriat

  • {categories}: kategoriat, joihin tuote kuuluu, pilkulla erotettuina

Alkuperämaa

  • {country_of_origin}: tuotteen alkuperämaa

Puhtaus

  • {clarity}: tuotteen jalokiven puhtaus

Kustannuskoodi

  • {encoded_cost}: hankintahinta muunnettuna yksityiseksi kustannuskoodiksi (kirjaimet määritetään kohdassa Asetukset ‣ Yleiset asetukset), jotta todellinen hinta ei ole luettavissa etiketistä.

RFID (tarvitaan vain RFID-etiketeille)

  • {item_sku_epc_hex}: SKU koodattuna EPC-arvoksi RFID-sirua varten

  • {item_sku_epc_word_count}: EPC-pituus, jota ZPL RFID-komento käyttää

Asettelu

  • {label_length}: täytetään automaattisesti etiketin pituusasetuksesta

QR-koodit ja viivakoodit

QR-koodi lisätään komennolla ^BQN, jota seuraa datakenttä, joka alkaa QA,:

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

  • ^FO0,30 — QR-koodin sijainti.

  • ^BQN,2,2 — QR-koodi. Viimeinen numero on koko (suurennus). Kasvattakaa sitä (3, 4, 5…), jos haluatte suuremman ja helpommin skannattavan koodin; pienentäkää sitä säästääksenne tilaa.

  • ^FDQA,{ean_code}^FS — koodiin tallennettu data. Tässä se koodaa tuotteen EAN-koodin.

Perinteistä 1D-viivakoodia varten käyttäkää sen sijaan ^BCN (Code 128):

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

60 on viivakoodin korkeus pisteissä, ja Y tulostaa ihmisluettavan numeron alle.

Oletussuunnittelu, selitettynä

Tämä on aloitussuunnittelu, jonka Gem Logic tarjoaa Teille, kommentoituna rivi riviltä. Sen lukeminen on nopein tapa ymmärtää, miten osat sopivat yhteen.

^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

Rivi riviltä:

  • ^XA — etiketin alku.

  • ^MD20 — tulostustummuus. Nostakaa sitä, jos etiketit näyttävät vaaleilta, laskekaa, jos teksti on tahriintunut.

  • ^CI28 — merkistökoodaus, jotta € ja aksentit tulostuvat oikein.

  • ^LL{label_length} — etiketin korkeus, täytetään automaattisesti pituusasetuksesta.

  • ^LH0,0 — alkupiste: origo on vasemmassa yläkulmassa.

  • ^CF0,18 — tekstin koko ~18 pistettä seuraaville riveille.

  • ^FO180,8^FD{brand}^FS — brändi, lähellä yläreunaa.

  • ^CF0,14 — pienempi teksti tästä eteenpäin.

  • ^FO50,45^FD{material_2}^FS, ^FO50,60^FD{material_3}^FS, ^FO180,27^FD{material_1}^FS — kolme materiaalia.

  • ^CF0,28 — suurempi teksti hinnalle.

  • ^FO180,50^FD{currency}{price}^FS — hinta, esim. €129.

  • ^CF0,16 — keskikokoinen teksti.

  • ^FO1,8^FD{item_sku}^FS — SKU, vasemmassa yläkulmassa.

  • ^FO1,23^FD{supplier_product_reference}^FS — toimittajan tuoteviite.

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

  • ^FO0,30^BQN,2,2 sitten ^FDQA,{ean_code}^FS — QR-koodi (vasemmassa alakulmassa) ja sen tiedot (EAN).

  • ^XZ — etiketin loppu.

Varoitus

ZPL:ssä ei ole rivikommentteja — älkää käyttäkö puolipistettä ; muistiinpanojen lisäämiseen. ZPL ymmärtää vain komentoja, jotka alkavat ^ (tai ~), joten kaikki ; -merkin jälkeinen tulkitaan komennon arvon osaksi (tai irtonaiseksi etikettidataksi). Tämä aiheuttaa virheet kuten ”Value ’20;’ is not a valid number” tai ”Ignored unrecognized content”, ja irrallinen ; voi hiljaisesti siirtää tai rikkoa asettelunne.

Jättääksenne muistiinpanon, käyttäkää ^FX kommenttikomentoa, suljettuna ^FS:llä. Tulostin jättää kaiken sen sisällön huomiotta:

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

Yksi sääntö: ^FX kommentti ei voi sisältää ^ tai ~ — nämä merkit päättävät kommentin ja aloittavat seuraavan komennon.

Yleiset muutokset

Suurentakaa hinta

Etsikää ^CF0,28 ennen {price} riviä ja nostakaa lukua, esim. ^CF0,40.

Siirtäkää jokin

Muuttakaa sen ^FO lukuja. Siirtääksenne brändin alemmas, nostakaa toista lukua ^FO180,8 -komennossa (8).

Lisätkää uusi tekstirivi

Kopioikaa ^FO…^FD…^FS rivi, antakaa sille suurempi y arvo, jotta se sijaitsee alempana, ja muuttakaa sisältö tai muuttuja.

Suurenna QR-koodia

Kasvata viimeistä numeroa komennossa ^BQN,2,2 (kokeile ^BQN,3,3). Jos se katkeaa, anna sille enemmän tilaa tai siirrä sitä vasemmalle/ylös sen ^FO-komennolla.

Lisää erotin

Käytä grafiikkaruutua. ^FO0,40^GB540,2,2^FS piirtää ohuen vaakasuoran viivan, joka on 540 pistettä leveä.

Esikatsele ja testaa ennen tulostusta

Teillä on kaksi helppoa tapaa tarkistaa malli ennen oikeiden etikettien käyttöä:

  • Gem Logicissa: joka kerta kun tallennatte, esikatselukuva etiketistä ilmestyy mallikentän alle. Käyttäkää sitä pääasiallisena palautesilmukkana.

  • Verkossa: liitä ZPL ilmaiseen Labelary viewer -palveluun nähdäksesi välittömän esikatselun eri etikettikoissa. (Korvaa ensin {variables} esimerkkitekstillä, sillä Labelary ei tunne tuotetietojasi.)

Jos oikea etiketti näyttää väärälle — katkennut teksti, QR-koodi, joka ei skannaudu, väärä koko — katsokaa etikettiosa dokumentista Vianmääritys.

Komentojen pikaviite

Komento

Mitä se tekee

^XA / ^XZ

Etiketti alkaa / loppuu. Kaikki on näiden välissä.

^PW

Tulostusleveys pisteissä.

^LL

Etiketin pituus (korkeus) pisteissä.

^LH

Label home — origo (yleensä 0,0).

^FO x,y

Field origin — seuraavan elementin sijainti x,y.

^CF0,h

Aseta oletusfontin korkeus (h pistettä) seuraavalle tekstille.

^FD ... ^FS

Field data — tulostettava sisältö — suljettu kenttäerottimella.

^FX ... ^FS

Kommentti — tulostin jättää huomiotta. Ei voi sisältää ^ tai ~.

^MD

Media darkness (tulostuksen tummuus). Korkeampi on tummempi.

^BQN,m,m

QR-koodi; viimeinen numero on koko. Data alkaa merkinnällä QA,.

^BCN,h,...

Code 128 -viivakoodi; h on korkeus pisteissä.

^GB w,h,t

Piirrä laatikko tai viiva (leveys, korkeus, paksuus pisteissä).

^CI28

Merkkikoodaus, jotta symbolit kuten € tulostuvat oikein.

Zebra julkaisee täydellisen ZPL-komentooppaan, mutta yllä olevat komennot kattavat lähes kaikki tuoteetiketit.