Intermec XMLLabel User manual

XMLLabel™ v6.10
User's Guide

ii XMLLabel v6.10 User’s Guide
Intermec Technologies Corporation
Corporate Headquarters
6001 36th Ave. W.
Everett, WA 98203
U.S.A.
www.intermec.com
The information contained herein is proprietary and is provided solely for the purpose of
allowing customers to operate and service Intermec-manufactured equipment and is not to be
released, reproduced, or used for any other purpose without written permission of Intermec.
Information and specifications contained in this document are subject to change without prior
notice and do not represent a commitment on the part of Intermec Technologies Corporation.
©2005 by Intermec Technologies Corporation. All rights reserved.
The word Intermec, the Intermec logo, Norand, ArciTech, Beverage Routebook, CrossBar,
dcBrowser, Duratherm, EasyADC, EasyCoder, EasySet, Fingerprint, INCA (under license), i-
gistics, Intellitag, Intellitag Gen2, JANUS, LabelShop, MobileLAN, Picolink, Ready-to-Work,
RoutePower, Sabre, ScanPlus, ShopScan, Smart Mobile Computing, SmartSystems, TE 2000,
Trakker Antares, and Vista Powered are either trademarks or registered trademarks of Intermec
Technologies Corporation.
Throughout this manual, trademarked names may be used. Rather than put a trademark (™or
®) symbol in every occurrence of a trademarked name, we state that we are using the names
only in an editorial fashion, and to the benefit of the trademark owner, with no intention of
infringement.
There are U.S. and foreign patents pending.
Microsoft, Windows, and the Windows logo are registered trademarks of Microsoft
Corporation in the United States and/or other countries.

XMLLabel v6.10 User’s Guide iii
Document Change Record
This page records changes to this document. The document was originally released as
version 001.
Version Date Description of Change
002 11/2005 Added new information to support RFID, SAP Auto-ID
Infrastructure, and changes to the Label Loader application.

iv XMLLabel v6.10 User’s Guide

Contents
XMLLabel v6.10 User’s Guide v
Contents
Before You Begin......................................................................................................vii
Safety Icons ................................................................................................vii
Global Services and Support.......................................................................vii
Who Should Read This Document? ..........................................................viii
Related Documents ...................................................................................viii
Getting Started..................................................................................................... 1
What Is XMLLabel?................................................................................................... 2
Understanding How XMLLabel Works....................................................... 2
Requirements .............................................................................................. 3
System Requirements .................................................................... 3
Supported Printers ........................................................................ 4
What’s New? ............................................................................................................. 4
Installing XMLLabel.................................................................................................. 4
Installing Printers to Work With XMLLabel.............................................................. 6
Setting Up Printers in LabelShop PRO........................................................ 6
Setting Up Printers in Oracle Version 11i10................................................ 8
Creating an Intermec Printer in Oracle ......................................... 8
Assigning Printers to Label Types................................................ 10
Defining Label Formats............................................................... 12
Setting Up Printers in SAP Auto-ID Infrastructure.................................... 13
Designing Labels............................................................................................... 15
Understanding How the Printer Supports Label Elements ....................................... 16
Defining Variable Data............................................................................................ 16
Using Variable Data in a Label ................................................................................ 18
Using Non-Latin Character Sets in a Label .............................................................. 20
Using Non-Latin Characters With Variable Data ...................................... 20
Using Non-Latin Characters With Fixed Data........................................... 20
1
2

Contents
vi XMLLabel v6.10 User’s Guide
Defining RFID Tags in a Label................................................................................ 21
Using Variables for Advanced Features .................................................................... 23
Optimizing Label Printing Speed............................................................................. 30
Using Printer Resident Fonts..................................................................... 30
Using Scaleable Fonts................................................................................ 31
Printing Labels.................................................................................................... 33
Converting a .lab File Format to an .lbx File Format................................................ 34
Downloading the .lbx File to Your Printer ............................................................... 36
Creating Printer Groups............................................................................ 40
Removing Printers and Groups.................................................................. 42
Printing a Test Label................................................................................................ 42
Troubleshooting................................................................................................ 47
Troubleshooting Problems and Possible Solutions ................................................... 48
Understanding Error Messages................................................................................. 50
Using Sample Labels................................................................................................ 50
3
4

Before You Begin
XMLLabel v6.10 User’s Guide vii
Before You Begin
This section provides you with safety information, technical
support information, and sources for additional product
information.
Safety Icons
This section explains how to identify and understand cautions
and notes that you see in this document.
A caution alerts you to an operating procedure, practice,
condition, or statement that must be strictly observed to
prevent equipment damage or destruction, or corruption
or loss of data.
Attention: Une précaution vous avertit d’une procédure de
fonctionnement, d’une méthode, d’un état ou d’un rapport
qui doit être strictement respecté pour empêcher
l’endommagement ou la destruction de l’équipement, ou
l’altération ou la perte de données.
Note: Notes either provide extra information about a topic or
contain special instructions for handling a particular condition
or set of circumstances.
Global Services and Support
Warranty Information
To understand the warranty for your Intermec product, visit the
Intermec web site at www.intermec.com and click Service &
Support > Service & Support.The Intermec Global Sales &
Service page appears. From the Service & Support menu, move
your pointer over Support, and then click Warranty.
Disclaimer of warranties: The sample code included in this
document is presented for reference only. The code does not
necessarily represent complete, tested programs. The code is
provided “as is with all faults.” All warranties are expressly
disclaimed, including the implied warranties of merchantability
and fitness for a particular purpose.

Before You Begin
viii XMLLabel v6.10 User’s Guide
Web Support
Visit the Intermec web site at www.intermec.com to download
our current manuals in PDF format. To order printed versions
of the Intermec manuals, contact your local Intermec
representative or distributor.
Visit the Intermec technical knowledge base (Knowledge
Central) at intermec.custhelp.com to review technical
information or to request technical support for your Intermec
product.
Telephone Support
In the U.S.A. and Canada call 1-800-755-5505 and select the
appropriate option.
Outside the U.S.A. and Canada, contact your local Intermec
representative. To search for your local representative, from the
Intermec web site, click Contact.
Who Should Read This Document?
The XMLLabel v6.10 User’s Guide provides you with
information about the features of XMLLabel application. It also
explains how to install, use, and troubleshoot XMLLabel. Before
you install XMLLabel, you should be familiar with your network
and general networking terms, such as IP address.
Related Documents
The Intermec web site at www.intermec.com contains our
documents that you can download in PDF format.
To order printed versions of the Intermec manuals, contact your
local Intermec representative or distributor.

XMLLabel v6.10 User’s Guide 1
Getting Started
Use this chapter to familiarize yourself with Intermec
XMLLabel™. In this chapter you will find these sections:
•What Is XMLLabel?
•What’s New?
•Installing XMLLabel
•Installing Printers to Work With XMLLabel
1

Chapter 1 — Getting Started
2 XMLLabel v6.10 User’s Guide
What Is XMLLabel?
XMLLabel is a powerful suite of applications that enables you to
easily convert LabelShop PRO label formats into files that you
can download to Intermec XMLReady™ printers. XMLLabel
helps you convert, download, and test the label formats. The
Intermec XMLReady printers store these converted label formats
and then accept XML data files directly from your ERP or
WMS system to print labels on demand.
The unique architecture of XMLLabel eliminates the need for
print server middleware.
Understanding How XMLLabel Works
Intermec XMLLabel consists of three applications:
•XMLLabel Wizard: The XMLLabel Wizard guides you
through the process of selecting your LabelShop PRO label
format (.lab) file and converting it into an XMLLabel format
(.lbx) file that you can download to an XMLReady printer.
XMLLabel Wizard also lets you create a sample .xml file and
a variable list file (.var) at the same time that you create the
.lbx file. You can use the .xml file to print a test label and you
can use the .var file for debugging purposes.
•Label Loader: Use Label Loader to download the .lbx file to
your Intermec XMLReady printer so that when an XML
print job arrives from your ERP or WMS system, that data is
formatted and printed using the .lbx file.
•XMLLabel Print: Use XMLLabel Print to send a test .xml
file to your printer. The .xml file contains test data. The
XMLReady printer uses the .lbx file to print the test data,
allowing you to troubleshoot any problems with the format
file.
•XMLLabel Preferences: Use the XMLLabel Preferences
dialog box if you need to change the target system, keep .pof
files for troubleshooting, and remove or include setup values
when sending labels to the printer.
After you convert, download, and test your format files, you are
ready for an XML print job from an ERP or WMS system.

Chapter 1 — Getting Started
XMLLabel v6.10 User’s Guide 3
XML print jobs
(optional)
XMLReady
printer
XMLReady
printer
.lbx
label
format
.lab
label
format
.xml
test
file
Label
Loader
LabelShop
PRO
XMLLabel
Wizard
XMLLabel
Print
ERP/WMS
system
XMLLabel Overview: This diagram shows how XMLLabel works with your ERP or WMS system to
print labels on an Intermec XMLReady printer.
Requirements
System Requirements
•LabelShop PRO v6.12
•PC running Microsoft Windows 2000 or Windows XP
•Hardware requirements–standard for operating system
•Host system with compatible XML output such as Oracle
11i10, SAP Auto-ID Infrastructure (AII) v.2.1 SP03 or v.4.0
•Microsoft Internet Explorer 5.01 or later
•Microsoft .NET Framework version 1.1

Chapter 1 — Getting Started
4 XMLLabel v6.10 User’s Guide
Supported Printers
•EasyCoder®PF2i, PF4i, PF4ci, PM4i, PX4i, PX6i with
Fingerprint v8.70 or later and EasyLAN/EasyLAN Wireless
interface.
What’s New?
This revision of the user’s guide includes this new information:
•Support for RFID labels. For help, see “Defining RFID Tags
in a Label” on page 21.
•Support for printing in SAP Auto-ID Infrastructure (AII).
For help, see “Setting Up Printers in SAP Auto-ID
Infrastructure” on page 13.
•Changes to the Label Loader application. For help, see
“Downloading the .lbx File to Your Printer” on page 36.
Installing XMLLabel
If LabelShop is not installed, you can install it from the
XMLLabel CD.
Note: You must have the Microsoft Framework version 1.1
installed on your PC to install XMLLabel. If necessary,
download Framework v1.1 from the Microsoft web site and
then install XMLLabel.
To install XMLLabel
1Insert the XMLLabel CD in your CD drive. The CD will
automatically start and display the introduction window.

Chapter 1 — Getting Started
XMLLabel v6.10 User’s Guide 5
If the CD does not start automatically, go to Start > Run and
browse to the autorun.exe file on your CD drive. Click OK
to start the installation.
2Click Install Software.
3If you do not have LabelShop PRO already installed, select
Install LabelShop PRO and follow the directions for
installation.
4Select Install XMLLabel and follow the directions for
installation.
To install XMLLabel on the LabelShop PRO Net
1From the LabelShop CD provided with the LabelShop PRO
Net package, install LabelShop PRO Net on the server.
2At the Network installation type window, choose Local
installation.

Chapter 1 — Getting Started
6 XMLLabel v6.10 User’s Guide
3Finish installing LabelShop PRO Net on the server, and then
install the clients from the server as described in the
Installation Guide of LabelShop PRO Net.
4Install XMLLabel locally on each of the clients that will use
XMLLabel.
After you have LabelShop PRO and XMLLabel installed, you
can run XMLLabel from these two places:
•Start > Programs > Intermec XMLLabel
•Tools menu in LabelShop PRO
Installing Printers to Work With XMLLabel
You need to make sure that you have the XMLReady printers
you plan to use in your network installed in LabelShop PRO,
Oracle®, or SAP Auto-ID Infrastructure (AII). Use this section
to install and set up printers in:
•LabelShop PRO.
•Oracle.
•SAP Auto-ID Infrastructure.
Setting Up Printers in LabelShop PRO
LabelShop PRO supports all Intermec XMLReady printers.
To install your printer
1Open LabelShop PRO.
2Go to File > Select printer or click the Select printer button
from the main menu. The Printer dialog box appears.

Chapter 1 — Getting Started
XMLLabel v6.10 User’s Guide 7
3Click Add. The Add printer dialog box appears.
4Expand the Intermec Default folder.
5From the Model list, select your printer model.
6From the Port list, select the port to which the printer is
connected.
7Click OK.
8Make sure the printer you added is selected in the Printer
dialog box and click OK. Printers supported by LabelShop
PRO have a printer icon in front of the printer name.
XMLLabel does not support printers that appear without the
printer icon. Supported printers include EasyCoder PF2i,
PF4i, PF4ci, PM4i, PX4i, and PX6i in DP mode.

Chapter 1 — Getting Started
8 XMLLabel v6.10 User’s Guide
The name and port of the selected printer appears in the lower left corner of
the LabelShop PRO window.
Setting Up Printers in Oracle Version 11i10
Use this section to understand how to set up OWM to print
with the Intermec XMLReady printers. There are three processes
you need to complete to configure the Oracle printer:
•Creating an Intermec printer in Oracle
•Assigning printers to label types
•Defining label formats
Creating an Intermec Printer in Oracle
The printer needs to be set up within Oracle Applications solely
for the purpose of choosing the correct printer for a particular
print request and then identifying the selected printer by its
name in the XML produced by the system.
Use the System Administrator Responsibility Role to create
printers. To create a printer, you need to:
•select the label printer mode.
•define the printer.
•enter the IP address.
To select the label printer mode
1From the System Administrator Responsibility Role, go to
Profile > System.
2Query for the profile option named “WMS: Label Print
Mode.”
3From the WMS: Label Print Mode option dialog box, select
Synchronous – TCP/IP.
4Save your settings.

Chapter 1 — Getting Started
XMLLabel v6.10 User’s Guide 9
To define printers
1From the System Administrator Responsibility Role, go to
Install > Printer > Register.
The Printers dialog box appears.
2In the Printer field, type a unique name to reference your
printer throughout the application.
3From the Type list box, select Label.
4In the Description field, type a meaningful description of the
printer.
5Repeat Steps 2 through 4 for each label printer.
To enter an IP address
1From the Warehouse Manager role, go to Setup >
Warehouse Configuration > Printers and Devices > Define
Printer IP.

Chapter 1 — Getting Started
10 XMLLabel v6.10 User’s Guide
The Define Printer IP dialog box appears.
2From the Printer Name list box, select the printer name.
3In the IP Address field, enter the IP address.
4In the Port field, enter the port (9200).
5Click Test to ping the printer. You should receive a message
telling you that the connection is successful.
If your connection is not successful, make sure there is
connectivity between the database and the printer.
Assigning Printers to Label Types
When a particular label request is made, Oracle looks for printer
assignments for the label type being printed and uses the printer
assigned to the label type at the most specific level.
To assign printers to label types
1From the Warehouse Manager Responsibility Role, go to
Setup > Warehouse Configuration > Printing > Assign
Printers to Documents.

Chapter 1 — Getting Started
XMLLabel v6.10 User’s Guide 11
The Choose Document and Label Printers dialog box
appears.
The tree view in the left panel shows the list of document
Label Types to which you can assign printers.
2If a label type does not appear, right-click the Documents
node and select New from the context-sensitive menu.
3From the List of Values, select the appropriate label type.
The label type is added to the tree view.
4From the tree view in the left panel, select a document label
type (for example, Lpn or Lpn Summary).
5From the Printer drop-down list, select a printer name to
associate with the label type.
6From the Level drop-down list, assign a level to the label
type.
7In the Value field, enter the value for that level.
Note: You cannot delete printer or label type assignments from
this form; you can only disable them.

Chapter 1 — Getting Started
12 XMLLabel v6.10 User’s Guide
Defining Label Formats
After you design your labels in LabelShop PRO, you need to
define the label formats within Oracle. The label format
contains fields that need to be populated with data from Oracle.
To define a Label Format
1From the Warehouse Manager Responsibility Role, go to
Setup > Warehouse Configuration > Printers and Devices
> Define Label Formats.
2To find existing label formats, select the Label Type
associated with the label format and click Find.
3In the Name field, enter a label format name or make sure the
label format name matches the name given to the label format
in LabelShop PRO.
Note: There are no restrictions on the naming conventions
for the label format, but the extension is always .lbx
(lowercase).
4In the Description field, enter a description for the label
format.
After you define the format name and description, you can view
the label content by clicking the Label Fields and Variables
button.