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.