therein are owned by ZIH Corp. Unauthorized reproduction of this manual or the software and/or firmware in the
label printer may result in imprisonment of up to one year and fines of up to $10,000 (17 U.S.C.506). Copyright
violators may be subject to civil liability.
, ZPL II®, and ZebraLink™ programs; Element Energy Equalizer® Circuit; E3®; and
ZebraLink and all product names and numbers are trademarks, and Zebra, the Zebra logo, ZPL, ZPL II, Element
Energy Equalizer Circuit, and E
All other brand names, product names, or trademarks belong to their respective holders. For additional trademark
information, please see “Trademarks” on the product CD.
3
Circuit are registered trademarks of ZIH Corp. All rights reserved worldwide.
Proprietary Statement This manual contains proprietary information of Zebra Technologies Corporation and its
subsidiaries (“Zebra Technologies”). It is intended solely for the information and use of parties operating and
maintaining the equipment described herein. Such proprietary information may not be used, reproduced, or disclosed
to any other parties for any other purpose without the express, written permission of Zebra Technologies.
Product Improvements Continuous improvement of products is a policy of Zebra Technologies. All
specifications and designs are subject to change without notice.
Liability Disclaimer Zebra Technologies takes steps to ensure that its published Engineering specifications and
manuals are correct; however, errors do occur. Zebra Technologies reserves the right to correct any such errors and
disclaims liability resulting therefrom.
Limitation of Liability In no event shall Zebra Technologies or anyone else involved in the creation, production,
or delivery of the accompanying product (including hardware and software) be liable for any damages whatsoever
(including, without limitation, consequential damages including loss of business profits, business interruption, or loss
of business information) arising out of the use of, the results of use of, or inability to use such product, even if Zebra
Technologies has been advised of the possibility of such damages. Some jurisdictions do not allow the exclusion or
limitation of incidental or consequential damages, so the above limitation or exclusion may not apply to you.
Part Number: 13426L-003 Rev. A
About This Document
This section provides you with contact information, document structure and organization, and
additional reference documents.
11/15/07Zebra XML-Enabled Printer Reference Guide13426L-003 Rev. A
About This Document
6
Who Should Use This Document
Who Should Use This Document
This Reference Guide is intended for use by any person who is going to use Zebra XMLEnabled printers.
How This Document Is Organized
The Zebra XML-Enabled Printer Reference Guide is set up as follows:
SectionDescription
IntroductionThis chapter provides a high level overview of
Zebra's XML-Enabled printer, along with detailed
information about what Zebra has enabled with
XML printing and how to use those capabilities to
print bar code labels.
ZebraDesigner for XMLThis chapter details how to create XML-Enabled
Compliance Label FormatsThis appendix provides a high-level overview of
GlossaryThis section contains a list of terms and their
For printers, parts, media, and ribbon,
please call your distributor, or
contact us.
T: +65 6858 0722
F: +65 6885 0836
11/15/07Zebra XML-Enabled Printer Reference Guide13426L-003 Rev. A
About This Document
8
Document Conventions
Document Conventions
The following conventions are used throughout this document to convey certain information.
Alternate Color (online only) Cross-references contain hot links to other sections in this
guide. If you are viewing this guide online in .pdf format, you can click the cross-reference
(blue text) to jump directly to its location.
LCD Display Examples Text from a printer’s Liquid Crystal Display (LCD) appears in
Bubbledot ICG font.
Command Line Examples Command line examples appear in Courier New font. For
example, type
Files and Directories File names and directories appear in Courier New font. For
example, the
Icons Used
Identifies features that are available in printers with firmware version V60.15.x, V50.15.x, or
later.
ZTools to get to the Post-Install scripts in the bin directory.
Zebra<version number>.tar file and the /root directory.
Identifies features that are available in printers with firmware version v60.14, v50.14, or
later.
Important • Advises you of information that is essential to complete a task.
Note • Indicates neutral or positive information that emphasizes or supplements important
points of the main text.
Example • Provides an example, often a scenario, to better clarify a section of text.
Illustration Callouts Callouts are used when an illustration contains information that needs
to be labeled and described. A table that contains the labels and descriptions follows the
graphic. Figure 1 provides an example.
Figure 1 • Sample Figure with Callouts
! U1 setvar
1
“ip.addr” “value”
2
3
Command—always preceded with an exclamation point (!). A space resides
1
between the !and U1 and between U1 and the command (setvar or getvar).
Attribute—always in double quotes.
2
Chosen value—always in double quotes. Only applicable for setvar.
This chapter provides a high level overview of Zebra's XML-Enabled printers, along with
information about the Document Type Definition (DTD) in the Zebra XML-Enabled printers.
It also reviews the XML data stream expected to print labels and the role of stored label
formats in the XML-Enabled printing solution.
11/15/07Zebra XML-Enabled Printer Reference Guide13426L-003 Rev. A
Introduction
12
Overview
Overview
Zebra’s XML-Enabled printers provide a direct-connect solution for bar code label printing
into many of today’s leading supply chain management and manufacturing system
applications. This illustration shows you the direct-connect solution using XML.
Figure 2 • XML-Enabled Printer Pictorial Overview
Zebra XML Integrated Solutions
To simplify bar code label printing, the Zebra XML-Enabled and RFID printers and encoders
provide bar code output from these systems:
• Oracle
•SAP
•IBM
• Microsoft®
This gives you the ability to quickly and easily integrate complex printing solutions into your
enterprise systems.
For easy integration to the back end ERP systems, use Zebra Designer for XML to design your
labels.
An XML DTD defines the XML tags that are used in the XML file. The host system generates
XML files according to this DTD, and the Zebra XML-Enabled printer translates the XML
according to this DTD.
Example • This example shows the XML DTD that is used to form the XML understood by
the Zebra XML-Enabled printer. It defines the elements that are used in the XML data stream
and a list of their attributes and the next level elements.
Note • Following the example is a table that identifies the bold lines in the example:
<!ELEMENT labels (label)*>
<!ATTLIST labels _FORMAT CDATA #IMPLIED>
<!ATTLIST labels _JOBNAME CDATA #IMPLIED>
<!ATTLIST labels _QUANTITY CDATA #IMPLIED>
<!ATTLIST labels _DUPLICATES CDATA #IMPLIED>
<!ATTLIST labels _PAGES CDATA #IMPLIED>
<!ATTLIST labels _PRINTERNUMBER CDATA #IMPLIED>
<!ATTLIST labels _PRINTERNAME CDATA #IMPLIED>
Introduction
Document Type Definition
1
2
15
<!ELEMENT label (variable)*>
<!ATTLIST label _FORMAT CDATA #IMPLIED>
<!ATTLIST label _JOBNAME CDATA #IMPLIED>
<!ATTLIST label _QUANTITY CDATA #IMPLIED>
<!ATTLIST label _DUPLICATES CDATA #IMPLIED>
<!ATTLIST label _PAGES CDATA #IMPLIED>
<!ATTLIST label _PRINTERNUMBER CDATA #IMPLIED>
<!ATTLIST label _PRINTERNAME CDATA #IMPLIED>
<!ELEMENT variable (#PCDATA)>
<!ATTLIST variable name CDATA #IMPLIED>
If the XML stream follows the DTD semantics, it contains <labels> elements
1
that identify default attributes used by the printer to create the label. The
_FORMAT attribute identifies the appropriate stored label format.
Other attributes can be processed as well; for instance, the _QUANTITY attribute
2
can be used to set the print quantity of the label.
If the XML stream follows the DTD semantics, it contains <variable>
3
elements that have “name” attributes. The “name” attribute contains the variable
name that corresponds to the variable field in the label format. The
<variable> element text contains the data that is placed in the variable field in
the label format.
3
11/15/07Zebra XML-Enabled Printer Reference Guide13426L-003 Rev. A
Introduction
16
Expected XML Data Stream
Expected XML Data Stream
The content of the XML data stream lies between <labels> and </labels>, which
correspond to all labels to be printed. The content between <label> and
</label> has the information to print one label. Each <variable> and
</variable> pair gives the value of one variable on the label.
Example • The XML data stream contains the <labels> element that defines the format,
quantity, printer name, and job name. The Zebra XML-enabled printer uses the _FORMAT
element to recall the stored XML-Enabled ZPL format from memory, and also the
_QUANTITY element to determine the number of labels to be printed. Also, notice that the
serial_number is one of several defined variable data fields, and 12345 is the variable
To reduce the amount of customization required to implement enterprise printing, the Zebra
XML-Enabled printing solution uses stored XML-Enabled ZPL formats. The format is stored
in the printer’s memory and recalled by the XML data stream. Multiple formats may be stored
in printer memory, limited only to the size of the format and the amount of memory in the
printer. Graphic files are generally larger and take up more memory.
ZebraDesigner for XML is used to create the XML-Enabled ZPL formats.
Send Files to Printer
There are multiple ways to send XML files to the printer, such as:
• ZebraNet Bridge
•FTP
•Telnet
• hyper terminal
Introduction
Stored XML-Enabled ZPL Formats
17
Serial Label
Example • This is an example of a XML-Enabled ZPL format for a serial label. Following
this example is the XML-Enabled ZPL format for this serial label:
11/15/07Zebra XML-Enabled Printer Reference Guide13426L-003 Rev. A
Introduction
18
Stored XML-Enabled ZPL Formats
XML-Enabled ZPL Format for the Serial Label
The difference is that the ^FD (field data) statement following the standard ^FN (field name)
definition identifies the XML variable field to the printer. The printer then matches the
variable field name to the XML data. In this case, the serial_number variable field data is
matched to the format.
Note • As shown below, the ^FD statements and the information immediately following them
represent the names of the variable data fields in this format. During label printing, these
strings are replaced with the user’s variable data.
The XML data stream specifies the label format name and quantity to be printed. The printer
recalls the correct label format, based on that information. Then the XML data stream defines
the variable field data. The printer matches the variable field attributes and data to the
attributes defined in the stored XML-Enabled ZPL format. The data that follows the attribute
is then merged with the XML-Enabled format and printed.
11/15/07Zebra XML-Enabled Printer Reference Guide13426L-003 Rev. A
ZebraDesigner for XML
22
Overview
Overview
System and Software Requirements
A demonstration copy of ZebraDesigner for XML is provided on the Zebra XML-Enabled
Printers CD included with each printer. The demonstration version can be fully enabled by
entering a serial number available with the purchase of the fee-based product, available from
your Zebra Authorized Reseller.
These are the minimum requirements needed to run ZebraDesigner for XML:
• Pentium®-based computer with at least 64 MB of RAM
• One of the 32-bit Windows operating system: Windows 98 SE, Windows NT 4.0,
Windows ME, Windows 2000, Windows XP, and Windows Server 2003
• Hard disk with 75 MB of free disk space
•CD-ROM drive
• Administrator rights to the local computer during installation
When you put the ZebraDesigner for XML CD in your CD-ROM drive, the
installation/demonstration program automatically starts. You can browse the directory of the
CD and look at the brochures, technical documentation, sample files, and other documents on
the CD.
Note • If you are using Windows NT, Windows 2000, Windows XP, or Windows Server
2003 you have to log on with Administrator rights to perform the installation.
Close All Software Applications
Before you start installing ZebraDesigner for XML, close all other software applications. This
ensures a complete installation of ZebraDesigner for XML.
Run Installation
ZebraDesigner for XML
23
To install ZebraDesigner for XML on your desktop PC, do the following:
1. Insert the ZebraDesigner for XML CD into your CD-ROM drive. The Setup Wizard dialog
box opens.
Note • If the Setup Wizard does not start automatically, go to the main CD directory of
your ZebraDesigner for XML CD and double-click START.EXE.
2. Click Next.
3. Follow the prompts and make your selections accordingly.
4. Click Install.
5. Click Finish.
11/15/07Zebra XML-Enabled Printer Reference Guide13426L-003 Rev. A
ZebraDesigner for XML
24
Install Overview for ZebraDesigner for XML
Define Setup Options
To continue the installation, do the following:
1. Click Next.
2. Specify the program group you want to use for ZebraDesigner for XML.
3. Specify if shortcuts to ZebraDesigner for XML should be created on the desktop or in the
Quick Launch area.
4. To finish the installation, click Install.
After installation you are asked to install a printer driver. You must install a
ZebraDesigner driver. If you do not install a printer driver while installing the software,
you are asked to install one the first time you run the program.
5. After the installation is complete, the Start menu in Windows shows a new program group
for ZebraDesigner for XML. The program group contains shortcuts for all ZebraDesigner
for XML applications.
Install Printer Driver
To install the ZebraDesigner printer driver on your computer, do the following:
1. Click Start > Programs > ZebraDesigner for XML.
2. In the group ZebraDesigner for XML, click the shortcut Add printer. The printer
This section shows you how to design a label file with fixed and variable objects. The variable
objects get values from several sources. You learn how to:
• Place objects on the label
• Link objects to the variables
• Preview the label on the screen
The label you create will look like this:
ZebraDesigner for XML
Design Labels
25
Create a Basic label
Each time you create a new label, the Label Setup Wizard starts to help you set up the label
and connect to the printer.
To create a basic label, do the following:
1. Open ZebraDesigner for XML.
2. In the Standard toolbar, click . The Label Setup Wizard dialog box opens.
Note • To exit the Label Setup Wizard dialog box, click Finish.
3. Select a Printer
11/15/07Zebra XML-Enabled Printer Reference Guide13426L-003 Rev. A
ZebraDesigner for XML
26
Design Labels
To select a printer, do the following:
4. From the menu, select File > Label Setup.
5. Select the printer you want to use for label printing.
If you want to print a label on which the data changes for each label, ZebraDesigner for XML
offers different variable fields (date/time fields, link to the variables) that you can use with
text, picture, and bar code objects.
For this example, a new label was created. The steps in the following topics explain how to
create a label that contains a variable field and date/time fields.
Create Variable Fields linked to Variables
The object on the label that is linked to the variable can have a different value for each printed
label.
To create a text object linked to the variable, do the following:
1. In the Toolbox, click .
2. Click the label where you want to place the text object. The Text Wizard dialog box opens.
ZebraDesigner for XML
Add Variable Fields
31
3. For the Contents, select Variable text.
4. Click Next.
5. Select Variable Field.
6. Click Next.
7. Select one of the existing variables in the list. If no variable is available in the list, you
must create some.
8. Click Finish. The text object is placed on the label and linked to the selected variable.
Note • This example shows how to create a text field linked to the variable. You can use the
same approach to create and link a variable to the bar code object.
11/15/07Zebra XML-Enabled Printer Reference Guide13426L-003 Rev. A
ZebraDesigner for XML
32
Add Variable Fields
Create Date and Time Variable Fields
Content of the variable field can be filled automatically with the date or time stamp from the
computer clock or printer clock (for supported printer models).
To place a date field on the label, do the following:
1. In the Toolbox, click the arrow .
2. From the list, select New Date Field.
3. Click on the label where you want to place the object. The Date dialog box opens.
4. Leave everything as default. The date is used on the label using the selected format.
5. Follow the prompts.
Use Prefix or Suffix Options
You can add a prefix and suffix to each variable field on the label. Both are added to the value
when you preview and print the label.
To add the prefix to the variable field on the label, do the following:
1. In the Toolbox, click the arrow .
2. From the list, select New Time Field.
3. On the label, click where you want to place the object. The Text Wizard dialog box opens.
4. Click Next.
5. Enter Time: for the Prefix option.
6. Click Finish. The text object is placed on the label and linked to the new variable. When
you print the label, the prefix Time: will be appended to the time value on the left side.
During the label design make sure the label prints correctly. To verify the printout of your
label, from the menu, select
you can export the label to the printer. During the export process, ZebraDesigner for XML
runs the XML Format Generation Wizard and converts the label format to a supported Zebra
printer.
The generated file includes commands from the Zebra Programming Language (ZPL) and is
ready to be used in the printer for off-line printing.
Note • Off-line printing is a term that describes the type of label printing where the label
design application is not available at print time. Usually the label format is stored in the
memory of the printer and can be recalled. Off-line printing support is great for print
requirements where the PC computer cannot be included in the label printing process either
because of unacceptable working conditions or logistic issues.
Off-line printing also provides faster label printing because all variable objects on the label
use internal printer functionality.
To export the label to printer, do the following:
ZebraDesigner for XML
Export to Printer
File > Test Print. When you are satisfied with the designed label,
33
1. From the menu, select File > Export to Printer. The Stored Format Settings dialog box
opens.
11/15/07Zebra XML-Enabled Printer Reference Guide13426L-003 Rev. A
ZebraDesigner for XML
34
Export to Printer
2. Fill in the Printer Storage Location and Format Name fields, and then click Next. The Te st
XML File Settings dialog box opens.
3. Make your selections and then click Next. This confirmation dialog box opens: File(s)
created successfully.
4. Click OK. The Destination dialog box opens.
Your destination choices include:
•Use Current Location
•Send to IP Address
•Send to File
5. From the Destination dialog box, enable your desired destination and then click Next.
If you chose Use Current Location, this confirmation dialog box opens: The format has been
transferred. The XML test file can now be sent.
To send the files to the printer using the port that the ZebraDesigner driver is using,
do the following:
1. To send, click Send File.
Send to File
If you chose Send to File, the File Destination dialog box opens.
To send a file to a specific destination, do the following:
1. From the File Destination dialog box, click Browse and navigate to the location you want
the file to go.
ZebraDesigner for XML
Export to Printer
35
2. Click Next. This confirmation dialog box opens: The Format has been saved.
3. Click OK.
11/15/07Zebra XML-Enabled Printer Reference Guide13426L-003 Rev. A
ZebraDesigner for XML
36
Export to Printer
File Destination
If you enable Send to File from the Destination dialog box, the File Destination dialog box
opens.
To choose a file destination, do the following:
1. Click Browse. The Browse for Folder dialog box opens.
2. Navigate to the path where you want the file sent.
3. Click OK.
The Browse for Folder dialog box closes and you return to the File Destination dialog box.
The Enter Destination Path text-box is populated with the destination you selected in the
Browse for Folder dialog box.
4. Click Next. The Format has been saved dialog box opens.
5. Click OK.
The Browse button in the File Destination dialog box allows you to navigate to the location
you want the file sent.
11/15/07Zebra XML-Enabled Printer Reference Guide13426L-003 Rev. A
Compliance Label Formats
38
Overview
Overview
These compliance label formats are included with the Zebra XML-enabled printer:
Table 1 • Compliance Label Formats
Label TypeZebra Format Name
GM1724a Compliance LabelingGM1724A.ZPL
IAEA Compliance LabelingIAEA.ZPL
KMART Compliance LabelingKMART.ZPL
KMART UCC Compliance LabelingKMARTUCC.ZPL
WALMART Compliance LabelingWALMART.ZPL
To assist in the implementation of compliance label printing applications, this appendix
provides detailed descriptions of each of the compliance label formats, the label format names,
examples of the label design, the default XML-enabled label format code, and sample XML
data to populate the label format.
API The acronym for Application Program Interface. API is a set of standards or
conventions by which programs call the specific operating system or network services.
Common Gateway Interface (CGI) A common gateway interface (CGI) is a standard
way for a Web server to pass a Web user's request to an application program and to receive
data back to forward to the user. When the user requests a Web page (for example, by clicking
on a highlighted word or entering a Web site address), the server sends back the requested
page.
data stream In data communications, this is a flow of undifferentiated data trasmitted byte
by byte.
DTD The acronym for Document Type Definition. A DTD is a specification that
accompanies a document and identifies what the markups are that separate paragraphs,
identify topic headings, and so forth and how each is to be processed.
firmware Software routines that are stored in ROM (Read Only Memory). This is typically
part of a device, such as a printer or
Flash memory A type of memory that allows read-and-write operations, and permanently
stores data when the power is turned off. Useful for storing firmware because it can be easily
updated by downloading new code.
parse The process of breaking down components into smaller pieces.
stored format A format that is stored in the printer’s memory. This format can be recalled
and used to print out a label.
TCP/IP Transmission Control Protocol/Internet Protocol, the de facto standard for Internet
communications and widely used on local area networks.
UNIX A general-purpose computer operating system used on many different kinds of
computers.
PSII.
11/15/07Zebra XML-Enabled Printer Reference Guide13426L-003 Rev. A
58
Glossary
XML The acronym for eXtensible Markup Language. XML is a language that creates markup
language regulated by the World Wide Web Consortium (W3C).
ZebraDesigner for XML A bar code design and printing software application.
ZebraNet PrintServer II An Ethernet connectivity solution.
®
ZebraLink
Allows you to connect and control your bar code printers anywhere and
anytime.
ZPL II Zebra Programming Language II is a powerful label-definition and printer-control
language.