Oracle® Retail Warehouse Management System

Label Printing Support and Implementation Overview

Release 13.2
1291263.1

February 2011
Note: The following is intended to outline our general product direction. It is intended for information
purposes only, and may not be incorporated into any contract. It is not a commitment to deliver any
material, code, or functionality, and should not be relied upon in making purchasing decisions. The
development, release, and timing of any features or functionality described for Oracle's products remains at
the sole discretion of Oracle.
 Contents

1 Overview
Related Documents .................................................................................................................................. 1-1

2 RWMS Printing Subsystem

Installing Oracle BI Publisher ............................................................................................................... 2-1
BI Publisher Report Designer Overview............................................................................................. 2-1
BI Publisher Data Source Types ............................................................................................................ 2-2
BI Publisher Template Types ................................................................................................................. 2-3
Printing Sequence Using BI Publisher ................................................................................................ 2-4

3 Using Zebra Technologies Printing Solutions

ZebraLink Enterprise Connector (ZEC) ............................................................................................... 3-1
Configuring ZEC for Use with RWMS ................................................................................................ 3-3
Pre-requisites ...................................................................................................................................... 3-3
Installing the Zebra Enterprise Connector ..................................................................................... 3-3
Installing the RWMS 13.2 ZPL Templates ...................................................................................... 3-3
Configuring Printers in RWMS............................................................................................................. 3-3
Configuring Reports and Labels in BI Publisher .............................................................................. 3-4
Implementing Labels in Zebra Designer............................................................................................. 3-4
Example Label Configurations .............................................................................................................. 3-5
Shipping UCC-128 SSCC Label........................................................................................................ 3-6
Returns UCC-128 SSCC Label .......................................................................................................... 3-8
Label Configuration Summary .............................................................................................................. 3-9

4 Configuring Printers in RWMS

Setting up a Label Printer RWMS BI Publisher................................................................................. 4-1
Configuring Label Printers in BI Publisher........................................................................................ 4-2

iii
iv
 1
Overview

Whether your organization is a retail firm or a manufacturer, you must create your
own labeling and reporting outputs to meet specific business needs within your
warehouse operations.
Oracle Warehouse Management System (RWMS) Release 13.2 supports customizable
printing and reporting requirements using BI Publisher. BI Publisher is a part of
Fusion Middleware Business Intelligence suite of applications for the enterprise.
This white paper describes the technical approach to integrate third party labeling and
printing solutions to BI Publisher printing subsystem of RWMS. In particular, it
explains the use of Zebra Technologies printing solutions and outline how these can be
configured for use within RWMS.
To understand this white paper, you must be familiar with the installation and
operation of RWMS Release 13.2 and its BI Publisher subsystem.

Related Documents
For a detailed information on the implementation and configuration of RWMS, see the
following documents in the RWMS Release 13.2 documentation set:
■ Oracle Retail Warehouse Management System Installation Guide
■ Oracle Retail Warehouse Management System Operations Guide
For more information about products from Zebra Technologies, see the following
documents from Zebra Technologies:
■ ZebraDesigner for XML User Guide
■ ZebraLink Enterprise Connector for Oracle BI Publisher User Guide
■ ZebraDesigner for XML Font and Graphics Downloader User Guide
■ ZebraNet Bridge Enterprise User Guide
■ Zebra Enterprise Connector Solution Flyer

Overview 1-1
Related Documents

1-2 Oracle® Retail Warehouse Management System

 2
RWMS Printing Subsystem

RWMS uses Oracle BI Publisher to meet printing and reporting needs of retailers.
Oracle BI Publisher is a reporting and publishing application that enables you to
extract data from multiple data sources, create a template to print the data in a report,
and publish the report in numerous output formats. Oracle BI Publisher also enables
you to schedule reports and deliver the reports to any delivery channel required by
your business.
This chapter includes the following topics:
■ Installing Oracle BI Publisher
■ BI Publisher Report Designer Overview
■ BI Publisher Data Source Types
■ BI Publisher Template Types
■ Printing Sequence Using BI Publisher

Installing Oracle BI Publisher

For information on installation and configuration of Oracle BI Publisher, see Oracle
Retail Warehouse Management System Installation Guide from Release 13.2 documentation
set.

BI Publisher Report Designer Overview

A report consists of a data model, a layout, and a set of properties. A report designer
performs the following tasks:
■ Creates report data model including parameters and lists of values, using BI
Publisher's report editor.
■ Designs layout template for the report. The layout can be created using different
tools depending on your output requirements, including Microsoft Word, Adobe
Acrobat, Microsoft Excel, and Adobe Flex Builder.
■ Sets runtime configuration properties for the report.
■ Defines a bursting control file for reports that are to be burst.
■ Enables translations for a report.

RWMS Printing Subsystem 2-1

BI Publisher Data Source Types

BI Publisher Data Source Types

BI Publisher uses Extensible Markup Language (XML) data to format and publish
your reports. It supports multiple methods for retrieving this data for your report.

Structured Query Language (SQL) Query

Submit an SQL query against any of the transactional databases set up by your
administrator. BI Publisher also provides Query Builder that enables you to build your
SQL query graphically.

Hypertext Transfer Protocol (XML Feed)

Use a Really Simple Syndication (RSS) feed from the web that returns XML.

Web Service
Supply the Web Service Definition Language (WSDL) to BI Publisher and then define
the parameters in BI Publisher to use a web service to return data for your report.

Data Template
The BI Publisher data engine enables you to rapidly generate any kind of XML data
structure against any database in a scalable, efficient manner. The data template is the
method by which you communicate your request for data to BI Publisher's data
engine.

Oracle BI Answers
If you have integrated your BI Publisher installation with Oracle BI Presentation
Services, then you can use the data from an Oracle BI Answers request to create your
report. For more information on this integration, see Oracle Business Intelligence
Publisher Administrator's and Developer's Guide.

Oracle BI Discoverer
If your BI Publisher installation is integrated with Oracle Discoverer, then you can use
the data from an Oracle Discoverer worksheet to create your report. For more
information on this integration, see Oracle Business Intelligence Publisher Administrator's
and Developer's Guide.

File
Use an existing XML data file stored in a directory that is set up by your administrator.

Multidimensional Query
Construct a Multidimensional Expressions (MDX) query against an Online Analytical
Processing (OLAP) database that is set up by your administrator.

2-2 Oracle® Retail Warehouse Management System

 BI Publisher Template Types

BI Publisher Template Types

BI Publisher offers several options for designing templates for your reports. Templates
can be in any of the following formats.

Note: Some formats restrict the output types.

Rich Text Format (RTF)

BI Publisher provides a plugin utility for Microsoft Word that automates template
design and enables you to connect to BI Publisher to access data and upload templates
directly from your Word session. RTF templates support most output types, including
Portable Document Format (PDF), HyperText Markup Language (HTML), RTF,
Microsoft Excel, Microsoft PowerPoint, and Modular HyperText Markup Language
(MHTML).

Portable Document Format (PDF)

PDF templates are used primarily for using predefined forms as templates for your
reports. For example, you can download forms from government web sites and load
them to BI Publisher as report templates. You can also design your own PDF templates
using Adobe Acrobat Professional. BI Publisher provides a mapping tool to enable you
to map fields from your data source to the form fields in the PDF template. PDF
templates support only PDF output.

Microsoft Excel (XLS)

Use BI Publisher's Analyzer for Microsoft Excel to download your report data to
Microsoft Excel spreadsheet. Create a layout for the data in the spreadsheet and then
upload the spreadsheet back to BI Publisher to use as a template.

Extensible Stylesheet Language (XSL) Stylesheet

You can define a template in the XSL formatting language. Specify whether your
template is for FO, HTML, XML, or TXT transformation.

eText
These are specialized RTF templates used for creating text output for Electronic Data
Interchange (EDI) or Electronic Funds Transfer (EFT) transactions.

Flash
BI Publisher's support for Flash templates enables you to develop Adobe Flex
templates that can be applied to BI Publisher reports to generate interactive Flash
output documents.

Barcode Template
See Chapter 3, "Using Zebra Technologies Printing Solutions" for more information.
The following tasks can be performed using an XML report:
■ Run and view reports from the BI Publisher reports repository.
■ Schedule reports to run at select intervals and to be delivered through any channel
set up by your administrator.
■ Create an ad hoc analysis of report data using BI Publisher's Analyzer feature.
■ Open and manipulate reports in Microsoft Excel using BI Publisher's Analyzer for
Microsoft Excel.

RWMS Printing Subsystem 2-3

Printing Sequence Using BI Publisher

Printing Sequence Using BI Publisher

RWMS makes use of BI Publisher for reporting and printing. It uses BI Publisher as the
first stage of a print rendering pipeline that outputs XML documents to consuming
devices or applications.
The BI Publisher tools are therefore the focus of queries to the RWMS schema. When
third-party printing solutions using BI Publisher XML outputs make direct queries to
the database, it results in increased complexity in the solution. Hence, it is
recommended to avoid such direct querying.
The following block diagram outlines the high level sequence of operations for a print
request in RWMS.

Figure 2–1 RWMS Reporting and Printing Block Diagram

The main characteristics of the sequence can be summarized as follows:

1. You press the print button, function key, or perform some other action through the
Forms user interface in either a mobile or desktop screen. RWMS then acquires
some standard parameters such as the logical name of the report, selected printer
name, warehouse ID, and the print label group number.
2. Using these request parameters, RWMS constructs a report request and routes the
request using an HTTP request to the pre-configured Reporting Tool URL (which
points to the BI Publisher installation URL).
3. BI Publisher identifies the report and queries the database accordingly. It then
formats the data and sends the report to a destination (in this case, a logical name
of a printer that is pre-configured on BI Publisher). The internal BI Publisher
scheduler may also be configured to automatically invoke reports based on timed
schedules that can be configured by the user.
4. BI Publisher then populates the output XML and applies filters before forwarding
the output to the appropriate destination. Any print failures are reported on BI
Publisher's scheduler log.
The XML output from BI Publisher acts as a demarcation between RWMS and
third-party printing solutions. RWMS sends predefined BI report templates that may

2-4 Oracle® Retail Warehouse Management System

 Printing Sequence Using BI Publisher

be modified to meet specific needs. Modifications to these templates results in

different XML output documents that the third-party printing solution must also
adapt.

RWMS Printing Subsystem 2-5

Printing Sequence Using BI Publisher

2-6 Oracle® Retail Warehouse Management System

 3
Using Zebra Technologies Printing Solutions

The Oracle Retail Warehouse Management System barcode printing solution may be
used in conjunction with Zebra Technologies barcode printing software and hardware
offerings.
Using the ZebraLink Enterprise Connector (ZEC), RWMS BI Publisher component
forwards report requests to Zebra label and LAN/Shared barcode printers that
support ZPL. The ZebraLink Enterprise Connector has the ability to parse and
interpret the XML passed to it by BI Publisher. Label formats supporting various
applications can be loaded into the Zebra Enterprise Connector's ZPL repository,
facilitating XML printing from Oracle BI Publisher.
The ZebraLink Enterprise Connector Printing Solution enhances the convenience and
accuracy of barcode and radio frequency identification label printing. Other tools from
Zebra Technologies may also be used to monitor and manage label directories and the
delivery of data to respective Zebra barcode and RFID printers.
This chapter includes the following topics:
■ ZebraLink Enterprise Connector (ZEC)
■ Configuring ZEC for Use with RWMS
■ Configuring Printers in RWMS
■ Configuring Reports and Labels in BI Publisher
■ Implementing Labels in Zebra Designer
■ Example Label Configurations
■ Label Configuration Summary

ZebraLink Enterprise Connector (ZEC)

The Zebra Enterprise Connector is a Java daemon process that accepts incoming XML
from Oracle BI Publisher using the BI Publisher's integrated xdo-delivery method of
using filters. The program extracts the variable XML data, merges the data with a ZPL
template and passes the print job to the operating system's printer subsystem.
It is designed to overcome the fundamental challenges that most retailers face
integrating barcode printing and their dependency on printer command languages.
The design tool that is used to create the label formats for the ZEC includes sample
formats and can be found on the Zebra Designer for XML CD ROM.
Though it might not be necessary, you can modify these formats to fit your business
needs by using Zebra Designer for XML and editing the <filename>.lbl files to create
your own custom compliance labels.

Using Zebra Technologies Printing Solutions 3-1

ZebraLink Enterprise Connector (ZEC)

ZPL Formats -- <filename>.ZPL

These formats, created by Zebra Designer for XML, are in Zebra Printer Language and
are installed in the label repository in the Zebra Enterprise Connector during setup.
XML Data Stream -- <filename>.xml
These are sample XML files that show how the data must be structured when it is sent
to the ZEC from the Oracle BI PublisherRWMS Server.
RWMS sends predefined BI Publisher reports that works with corresponding Zebra
ZPL templates specifically built for RWMS. These templates can be obtained from
Zebra Technologies at http://www.zebra.com/oracle.
The pipeline between RWMS BI Publisher components and ZEC is illustrated below
and shows the relationship between the BI Publisher and RWMS templates.

Figure 3–1 RWMS and ZEC Print Rendering Pipeline

The main characteristics of the pipeline can be summarized as follows:

■ The BI Publisher is responsible for invoking the appropriate SQL or RWMS stored
procedures according to the report being requested.
■ The XML output from the BI Publisher component is a clear demarcation between
Zebra components and RWMS.
■ The output XML document is used by ZEC which applies the corresponding ZPL
template to the XML to submit the final output to the printer.
■ The output is spooled to the standard operating systems print spooler.
Customization of reports or labels for Zebra Printing Solutions involves a two step
process:
■ Adapting the BI Publisher reports to meet your specific needs.
■ Update the corresponding ZPL template design for Zebra (Zebra provides tools
such as Zebra Designer for XML and a ZPL manual to assist in the template
changes) to reflect the changes in the new XML schema being generated.

3-2 Oracle® Retail Warehouse Management System

 Configuring Printers in RWMS

Configuring ZEC for Use with RWMS

This section provides an overview of the installation process for ZEC. See the Zebra
Enterprise Connector Installation Guide for more information.

Pre-requisites
Following are the pre-requisites before installing ZEC:
■ RWMS database and application components are correctly installed and
configured (as described in the Oracle Retail Warehouse Management System
Installation Guide for Release 13.2).
■ The BI Publisher database schema and web application components are installed
within a WebLogic 10.3.3 container (as described in the Oracle Retail Warehouse
Management System Installation Guide for Release 13.2).

Installing the Zebra Enterprise Connector

After completing the installation, ZEC for Oracle BI Publisher must be installed and
run on the same host as Oracle BI Publisher. It is also possible to install ZEC on other
servers but this requires additional installation of Remote Procedure Call (RPC) scripts
which may be obtained from Zebra Technologies.
To install the ZEC:
1. Download and license the Zebra Enterprise Connector from the following
hyperlink following the registration process on the web page:
http://www.zebra.com/oracle
2. Select the installer link for the operating system of the server you are going to
install it on or complete the requested software web form.
3. Put the file on your computer and extract the contents of the zip file.
4. FTP the zecinstall.bin file to the server you are going to install it on.
5. Execute the installer zecinstall.bin installer and follow the instructions.
6. When asked to select the directory to install, select the same directory as BI
Publisher install.

Installing the RWMS 13.2 ZPL Templates

The RWMS 13.2 Zebra ZPL templates must be obtained from Zebra technologies
(http://www.zebra.com/oracle) and uploaded into the ZEC's ZPL Repository
for processing during printing. ZEC applies the ZPL template to an XML data stream
to create the raw output for the Zebra printer.

Configuring Printers in RWMS

In RWMS the following configurations must be made:
■ Add printer names to the report_dest table. This can be done using the Print
Queue Editor screen available in the application.
■ Set the following System Control Parameters (SCPs) using the SCP Editor screen
– label_printer_font - This SCP is used to control what font the zebra printer
must use to print the label. This is needed as different fonts must be loaded for
different languages. The default is 0.fnt.

Using Zebra Technologies Printing Solutions 3-3

Configuring Reports and Labels in BI Publisher

– container_format - This SCP has 2 valid options. When set to Default it makes
the barcode on the label type code 39. When set to UCC128 it makes the
barcode a UCC128 barcode.
– default_language - This SCP is used to specify the language that the labels are
translated to. It must match one of the values in the supported_language table.

Configuring Reports and Labels in BI Publisher

Complete the following steps to set up the Data Model for each report in BI Publisher:
1. Choose Data Template as Type. Do not choose SQL Query. If SQL Query is
chosen, the output xml data will not be customized, it will be of the form:
<ROWSET><ROW><COLUMN1><COLUMN2>…

Figure 3–2 Example of XML Report Configuration

2. Use the Data Template to customize the xml to the form expected by ZPL label
template (ZPL template is the template for the label that is created in Zebra
Designer)

Implementing Labels in Zebra Designer

Label Design
RWMS labels are designed using the Zebra Designer for XML barcode labeling
software. The corresponding content for each BI Publisher report template is provided
by RWMS in the form of ZPL templates produced with the Zebra Designer.
The root node of the XML report for each label identifies the label names. Once you
have decided on the label format to be generated, and examined the label fields
required in the label, check the XML report generated by Oracle BI Publisher and map

3-4 Oracle® Retail Warehouse Management System

 Example Label Configurations

the required labels to the XML tag as variable fields in the Zebra label design tool. The
following steps outline this approach:
■ The XML Tags must match the variable fields on the label. For example,
<ORGANIZATION> in the XML report is represented as $$ORGANIZATION$$
in the label design.
■ Follow the instructions in the ZebraLink Enterprise Connector for Oracle BI Publisher
User Guide to construct your label design.
After constructing the label format, you must define label rules in the ZEC to print
these labels. Modify the ReportsInfo.ini file in the \zebra_ec\bin directory where the
Enterprise Connector is installed. See the ZebraLink Enterprise Connector for Oracle BI
Publisher User Guide for more information.
When modifying or creating a new ZPL template, the dynamic variable names must
match the element names in the XML data. For example, variable $$RETURN_ID$$ in
the template must match <RETURN_ID> in the xml data. See the ZebraLink Enterprise
Connector for Oracle BI Publisher User Guide for more information.
The ReportInfo.ini configuration file in ZEC must be configured for the ZPL templates.
This file is used to associate an XML root node to a ZPL template. This informs ZEC
which ZPL template to apply for which XML root node. It also indicates the repeat
node in the XML stream.
The repeat node is a repeating node in the XML stream that indicates ZEC the number
of labels to print. An XSL might also be specified here to transform the incoming XML
stream before applying the ZPL template. See ZebraLink Enterprise Connector for Oracle
BI Publisher User Guide for configuration details.

Example Label Configurations

In this section, the field mapping relationship between the XML tags on XML Reports
from Oracle BI Publisher and variable names on the label is described. All retailer
labels are derived from Generic SSCC label with some variations.

Note: The illustration above is not an actual RWMS label - It's

intention is to provide an easy to follow example of how the XML ZPL
template constructs work together.

Using Zebra Technologies Printing Solutions 3-5

Example Label Configurations

Shipping UCC-128 SSCC Label

This is a sample shipping label, which must be printed and attached to the container.
The fields in the label can be mapped using the XML report from Oracle BI Publisher.

Figure 3–3 UCC-128 SSCC Label

The following is a sample Oracle BI Publisher report:

Example 3–1 Sample Oracle BI Publisher Report for Shipping Label

<SHIPPING>
<SHIP_LINE>
<ORGANIZATION>O123</ORGANIZATION>
<SUPPLIER>Zebra</SUPPLIER>
<SHIP_FROM_ADDRESS1/>
<SHIP_FROM_ADDRESS2/>
<SHIP_FROM_CITY/>
<SHIP_FROM_STATE/>
<SHIP_FROM_ZIP/>
<LPN>1</LPN>
<PART_NUMBER>117-000-2050</PART_NUMBER>
<ITEM_DESC>110 XiIII PLUS</ITEM_DESC>
<SERIAL_NUMBER>ser1</SERIAL_NUMBER>
<QUANTITY>1</QUANTITY>
<SHIP_TO_CUSTOMER>Bills House of Patios</SHIP_TO_CUSTOMER>
<SHIP_TO_ADDRESS1>21 Wacker</SHIP_TO_ADDRESS1>
<SHIP_TO_ADDRESS_2/>
<SHIP_TO_CITY>Chicago</SHIP_TO_CITY>
<SHIP_TO_STATE>IL</SHIP_TO_STATE>
<SHIP_TO_ZIP>60001</SHIP_TO_ZIP>
<CUSTOMER>Bills House of Patios</CUSTOMER>
<SUPPLIER>Zebra</SUPPLIER>
<UOM>EA</UOM>
</SHIP_LINE>

3-6 Oracle® Retail Warehouse Management System

 Example Label Configurations

</SHIPPING>

The following table summarizes mapping for the shipping label:

Table 3–1 Mapping for Shipping Label

Label Field Name Seede XML Report Field Tag
XML Nodes Label Field in the Label in Oracle Retail d Name
<SHIPPING> $$ORGANIZATION$$ ORGANIZATION Yes <ORGANIZATION>
<SHIP_LINE> $$SUPPLIER$$ SUPPLIER Yes <SUPPLIER>
$$SHIP_FROM_ SHIP_FROM_ Yes <SHIP_FROM_
ADDRESS1$$ ADDRESS1 ADDRESS1>
$$SHIP_FROM_ SHIP_FROM_ Yes <SHIP_FROM_
ADDRESS2$$ ADDRESS2 ADDRESS2>
$$SHIP_FROM_CITY$$ SHIP_FROM_ Yes <SHIP_FROM_CITY>
CITY
$$SHIP_FROM_STATE$$ SHIP_FROM_ Yes <SHIP_FROM_STATE>
STATE
$$SHIP_FROM_ZIP$$ SHIP_FROM_ZIP Yes <SHIP_FROM_ZIP>
$$LPN$$ LPN Yes <LPN>
$$PART_NUMBER$$ PART_NUMBER Yes <PART_NUMBER>
$$ITEM_DESC$$ ITEM_DESC Yes <ITEM_DESC>
$$SERIAL_NUMBER$$ SERIAL_ Yes <SERIAL_NUMBER>
NUMBER
$$QUANTITY$$ QUANTITY Yes <QUANTITY>
$$SHIP_TO_CUSTOMER$$ SHIP_TO_ Yes <SHIP_TO_CUSTOMER>
CUSTOMER
$$SHIP_TO_ADDRESS1$$ SHIP_TO_ Yes <SHIP_TO_ADDRESS1>
ADDRESS1
$$SHIP_TO_ADDRESS_2$$ SHIP_TO_ Yes <SHIP_TO_ADDRESS_2>
ADDRESS_2
$$SHIP_TO_CITY$$ SHIP_TO_CITY Yes <SHIP_TO_CITY>
$$SHIP_TO_STATE$$ SHIP_TO_STATE Yes <SHIP_TO_STATE>
$$SHIP_TO_ZIP$$ SHIP_TO_ZIP Yes <SHIP_TO_ZIP>
$$CUSTOMER$$ CUSTOMER Yes <CUSTOMER>
$$SUPPLIER$$ SUPPLIER Yes <SUPPLIER>
$$UOM$$ UOM Yes <UOM>

Using Zebra Technologies Printing Solutions 3-7

Example Label Configurations

Returns UCC-128 SSCC Label

You can map all the fields in the label to the variable fields from the Returns XML
Report in Oracle BI Publisher.

Figure 3–4 Returns UCC-128 SSCC Label

The following is a sample XML report:

Example 3–2 Sample Oracle BI Publisher Report for Returns Label

<RETURNS>
<RETURN_LINE>
<TRANS_ID>1</TRANS_ID>
<RET_AUTH>1</RET_AUTH>
<TO_NAME>Soli Hill</TO_NAME>
<TO_ADD1>950 Nicollet Mall</TO_ADD1>
<TO_ADD2/>
<TO_CITY>Minneapolis</TO_CITY>
<TO_STATE>MN</TO_STATE>
<TO_POSTAL>55403</TO_POSTAL>
<FROM_NAME>Solihull</FROM_NAME>
<FROM_ADD1>950 Nicollet Mall</FROM_ADD1>
<FROM_ADD2/>
<FROM_CITY>Minneapolis</FROM_CITY>
<FROM_STATE>MN</FROM_STATE>
<FROM_POSTAL>55403</FROM_POSTAL>
</RETURN_LINE>
</RETURNS>

The following table summarizes the mapping for the returns label:

Table 3–2 Mapping for Returns Label

Label Field in the Label Field Name XML Report Field
XML Nodes Label in Oracle Retail Seeded Tag Name
<RETURN> $$TRANS_ID$$ TRANS_ID Yes <TRANS_ID>
<RETURN_LINE> $$RET_AUTH$$ RET_AUTH Yes <RET_AUTH>
$$TO_NAME$$ TO_NAME Yes <TO_NAME>

3-8 Oracle® Retail Warehouse Management System

 Label Configuration Summary

Table 3–2 (Cont.) Mapping for Returns Label

Label Field in the Label Field Name XML Report Field
XML Nodes Label in Oracle Retail Seeded Tag Name
$$TO_ADD1$$ TO_ADD1 Yes <TO_ADD1>
$$TO_ADD2$$ TO_ADD2 Yes <TO_ADD2>
$$TO_CITY$$ TO_CITY Yes <TO_CITY>
$$TO_STATE$$ TO_STATE Yes <TO_STATE>
$$TO_POSTAL$$ TO_POSTAL Yes <TO_POSTAL>
$$FROM_ FROM_NAME Yes <FROM_NAME>
NAME$$
$$FROM_ADD1$$ FROM_ADD1 Yes <FROM_ADD1>
$$FROM_ADD2$$ FROM_ADD2 Yes <FROM_ADD2>
$$FROM_CITY$$ FROM_CITY Yes <FROM_CITY>
$$FROM_ FROM_STATE Yes <FROM_STATE>
STATE$$
$$FROM_ FROM_POSTAL Yes <FROM_
POSTAL$$ POSTAL>

Label Configuration Summary

Label compliance is more strictly implemented in retail supply chain than in any other
industry. Non-compliance invites rejection of goods along with heavy penalties. See
The ZebraLink Enterprise Connector for Oracle BI Publisher User Guide for more
information on the design process, such as how to generate labels.

Note: All retail labels are derived from Generic SSCC label with
some variations.

Following are some requirements to print to a Zebra Printer from Oracle BI Publisher:
■ The ZebraLink Enterprise Connector must be installed and running.
■ A printer must be installed and configured.
■ RWMS must be configured with Oracle BI Publisher.
■ A Zebra Printer Language (ZPL) template appropriate to the Oracle XML report
must be created and uploaded to the ZebraLink Enterprise Connector (ZEC)
zplrepository directory.
■ The ReportInfo.ini file must be configured appropriately.
See the ZebraLink Enterprise Connector for Oracle BI Publisher User Guide for more
information.

Using Zebra Technologies Printing Solutions 3-9

Label Configuration Summary

3-10 Oracle® Retail Warehouse Management System

 4
Configuring Printers in RWMS

This chapter describes the steps necessary to set up printers in RWMS.

This chapter includes the following topics:
■ Setting up a Label Printer RWMS BI Publisher
■ Configuring Label Printers in BI Publisher

Setting up a Label Printer RWMS BI Publisher

Setup a CUPS server on the same server as BI Publisher.
The following screen shows an OS specific (Oracle Enterprise Linux) dialog for
configuring printers.

Figure 4–1 Example of OS Specific CUPS Configuration Dialog

When configuring printers, make sure that they are set up as RAW and the printers
have a logical name.

Configuring Printers in RWMS 4-1

Configuring Label Printers in BI Publisher

Configuring Label Printers in BI Publisher

For the purposes of this document, it is assumed that label printers use ZEC printing
mechanism and this must be configured appropriately in BI Publisher. The following
steps must be followed to configure BI Publisher for each printer:
1. Login to BI Publisher web interface as an administrative user.
2. Navigate to the Admin tab and click Printers link under Delivery section.
3. Click Create Server button and enter in the following information for your printer
setup:
■ Server Name: <printer_name>
■ URI: ipp://<printer_IP_address>:9100/printers/<printer_name>
■ Filter: Custom Filter
■ Filter Command: <file location of ZEC intall>/bin/zec -p {infile} <printer_
name>{outfile}
The following screen shows a typical BI Publisher dialog for these actions.

Figure 4–2 Configuring a Label Printer with a ZEC Custom Filter

4-2 Oracle® Retail Warehouse Management System

Oracle Corporation
World Headquarters
500 Oracle Parkway
Redwood Shores, CA 94065
U.S.A.

Worldwide Inquiries:
Phone: +1.650.506.7000
Fax: +1.650.506.7200
oracle.com

Copyright © 2011, Oracle. All rights reserved.

This document is provided for information purposes only and the
contents hereof are subject to change without notice.
This document is not warranted to be error-free, nor subject to any
other warranties or conditions, whether expressed orally or implied
in law, including implied warranties and conditions of merchantability
or fitness for a particular purpose. We specifically disclaim any
liability with respect to this document and no contractual obligations
are formed either directly or indirectly by this document. This document
may not be reproduced or transmitted in any form or by any means,
electronic or mechanical, for any purpose, without our prior written permission.
Oracle, JD Edwards, PeopleSoft, and Siebel are registered trademarks of Oracle
Corporation and/or its affiliates. Other names may be trademarks
of their respective owners.