MAPDRAW – TECHNICAL REFERENCE GUIDE

Transcription

MAPDRAW –
TECHNICAL REFERENCE GUIDE
Last revision date: 26 August 2010
MAPDRAW Technical Reference Guide
Presentation / Objectives
This guide is intended for MapDraw users at an intermediate and advanced level. It
includes detailed configuration settings and specific how-to information divided into 20+
chapters, from designing labels and barcodes to encoding RFID labels and running SQL
queries...
As of the date of release of this guide, the latest product version is 7.0
Table of contents
INSTALLING MAPDRAW ................................................................................................................................. 6
REQUIREMENTS ................................................................................................................................................... 6
INSTALLATION ..................................................................................................................................................... 6
SETTING UP ACCESS TO THE MAPPING SERVER .................................................................................................. 11
A. FTP Configuration.................................................................................................................................... 11
B. Share Folder ............................................................................................................................................. 12
AUTOMATING MAPDRAW PROCESSES ................................................................................................... 13
COMMAND PARAMETERS ................................................................................................................................... 13
EXAMPLES ......................................................................................................................................................... 15
GENERATING COMPONENTS ............................................................................................................................... 17
REGISTRY SETTINGS ........................................................................................................................................... 17
HOW TO DESIGN BARCODES IN MAPDRAW .......................................................................................... 18
GENERAL PRINCIPLE .......................................................................................................................................... 18
SPECIAL CASE: AFP/IPDS ................................................................................................................................ 20
Barcodes managed by the printer ................................................................................................................. 20
Barcodes managed by MAPPING ................................................................................................................. 21
SPECIAL CASE: THERMAL LANGUAGES ............................................................................................................. 22
Barcodes managed by the printer ................................................................................................................. 22
Barcodes managed by MAPPING ................................................................................................................. 23
DATA ROLLUP ................................................................................................................................................... 24
EAN 128............................................................................................................................................................ 25
CODE 128 ......................................................................................................................................................... 26
CODABAR ....................................................................................................................................................... 27
2D BAR CODES ................................................................................................................................................... 28
QR CODE ......................................................................................................................................................... 29
DATA MATRIX ............................................................................................................................................... 30
PDF 417 ............................................................................................................................................................ 32
UPS MAXICODE ............................................................................................................................................. 33
INTELLIGENT MAIL BARCODE (UNITED STATES POSTAL SERVICE) ................................................................... 34
HOW TO DESIGN AND APPLY COMPONENTS ........................................................................................ 35
DEFINITION ........................................................................................................................................................ 35
HOW DO I CREATE A COMPONENT? .................................................................................................................... 35
HOW DO I INSERT A COMPONENT IN A PROJECT? ................................................................................................ 38
HOW TO CALL AN EXISTING AFP OVERLAY ......................................................................................... 39
STEPS ................................................................................................................................................................. 39
HOW TO GENERATE PDF PROJECTS ........................................................................................................ 40
Page 2 of 109
CREATING THE PROJECT ASSOCIATION ............................................................................................................... 40
HOW TO DISPLAY PFSRC OR FILE DATA ................................................................................................ 43
ON THE SYSTEM I ............................................................................................................................................... 43
ON UNIX / LINUX / WINDOWS ............................................................................................................................ 45
LABELS ............................................................................................................................................................... 47
OPENING A VARIABLE ELEMENT IN A PROJECT ................................................................................................... 48
DUPLICATING A VARIABLE ELEMENT ................................................................................................................. 49
EXAMPLE: CREATING A LABEL PLATE ................................................................................................................ 50
Step 1: Creating a label ................................................................................................................................ 50
Step 2: Inserting the label into a new project................................................................................................ 51
Step 3: Creating a label plate ....................................................................................................................... 52
CONFIGURING THE STAPLING OPTION IN MAPDRAW ...................................................................... 54
STEPS ................................................................................................................................................................. 54
STAPLING A DOCUMENT ON A BREAK ................................................................................................................. 56
A) How to staple the pages of each customer together when you have a big input spool file with multiple
customer IDs in it (in other words staple all the same customer IDs together) ............................................ 56
B) How to staple X MapDraw sequences together........................................................................................ 56
HOW TO RUN SQL QUERIES IN MAPDRAW ............................................................................................ 59
REQUIREMENTS ................................................................................................................................................. 59
STEPS ................................................................................................................................................................. 59
HOW TO REPLACE CHARACTER STRINGS ............................................................................................. 63
STEPS ................................................................................................................................................................. 63
ACIF (AFP) ......................................................................................................................................................... 65
CREATING AN AFP FILE IN FONT COLLECTION MODE ........................................................................................ 65
GENERATING THE SPOOL FILE IN AFP ................................................................................................................ 66
ADDING THE AFP RESOURCES TO CREATE THE ACIF FILE ................................................................................. 66
SENDING THE FILE TO BUSINESS CONTACTS ....................................................................................................... 66
HOW TO INSTALL DOWNLOADABLE FONTS FOR DATAMAX PRINTERS ..................................... 67
STEPS ................................................................................................................................................................. 67
HOW TO DESIGN LABELS IN THE DATAMAX DPL LANGUAGE ....................................................... 70
REMAPPING........................................................................................................................................................ 70
System i ......................................................................................................................................................... 70
Unix / Linux / Windows ................................................................................................................................. 70
GENERATION MODE ........................................................................................................................................... 70
COMMANDS ....................................................................................................................................................... 71
FONTS ................................................................................................................................................................ 71
Resident fonts ................................................................................................................................................ 71
Downloadable fonts ...................................................................................................................................... 71
PAGE SIZE .......................................................................................................................................................... 72
VARIABLE LOGOS .............................................................................................................................................. 72
BARCODES ......................................................................................................................................................... 72
HOW TO DESIGN LABELS IN THE ELTRON ETL LANGUAGE ........................................................... 73
REMAPPING........................................................................................................................................................ 73
System i ......................................................................................................................................................... 73
COMMANDS ....................................................................................................................................................... 73
PAGE SIZE .......................................................................................................................................................... 74
BARCODES ......................................................................................................................................................... 74
HOW TO DESIGN LABELS IN THE INTERMEC DIRECT PROTOCOL LANGUAGE ....................... 75
Page 3 of 109
REMAPPING........................................................................................................................................................ 75
System i ......................................................................................................................................................... 75
TEXT IN REVERSE VIDEO MODE ......................................................................................................................... 75
BARCODES ......................................................................................................................................................... 76
PRINTER MODELS ............................................................................................................................................... 77
HOW TO DESIGN LABELS IN THE PRINTRONIX IGP LANGUAGE ................................................... 78
REMAPPING........................................................................................................................................................ 78
System i ......................................................................................................................................................... 78
UNICODE MODE ................................................................................................................................................. 78
COMMANDS ....................................................................................................................................................... 79
FONTS ................................................................................................................................................................ 79
RESOLUTION ...................................................................................................................................................... 79
BARCODES ......................................................................................................................................................... 79
SPECIAL FUNCTION CONTROL CODE (SFCC) .................................................................................................... 81
DOWNLOAD OVERLAY ....................................................................................................................................... 81
RFID ................................................................................................................................................................. 81
HOW TO DESIGN LABELS IN THE TEC LANGUAGE ............................................................................. 83
REMAPPING........................................................................................................................................................ 83
System i ......................................................................................................................................................... 83
ADVANCED PROPERTIES..................................................................................................................................... 83
Label interval ................................................................................................................................................ 83
Speed ............................................................................................................................................................. 84
Cell type ........................................................................................................................................................ 84
Copies ........................................................................................................................................................... 84
Mode ............................................................................................................................................................. 84
Cut interval ................................................................................................................................................... 84
Eject last label ............................................................................................................................................... 84
Print mode ..................................................................................................................................................... 84
Commands..................................................................................................................................................... 84
PAGE SIZE .......................................................................................................................................................... 85
COMMANDS ....................................................................................................................................................... 85
FONTS ................................................................................................................................................................ 85
Resident fonts ................................................................................................................................................ 85
TEXT IN REVERSE VIDEO ................................................................................................................................... 86
BARCODES ......................................................................................................................................................... 86
HOW TO DESIGN LABELS IN THE ZEBRA ZPL II LANGUAGE........................................................... 87
REMAPPING........................................................................................................................................................ 87
On the system i .............................................................................................................................................. 87
On Unix / Linux / Windows ........................................................................................................................... 87
COMMANDS ....................................................................................................................................................... 88
FONTS ................................................................................................................................................................ 89
Resident fonts ................................................................................................................................................ 89
BARCODES ......................................................................................................................................................... 90
RFID ................................................................................................................................................................. 91
HOW TO ENCODE RFID CHIPS .................................................................................................................... 93
RFID ZONES ...................................................................................................................................................... 93
COMMAND ZONES .............................................................................................................................................. 94
ZEBRA LANGUAGE ........................................................................................................................................... 94
Page 4 of 109
IGP LANGUAGE .................................................................................................................................................. 96
HOW TO PROCESS IMAGE FILES AUTOMATICALLY .......................................................................... 98
PROGRAM INTERFACE ........................................................................................................................................ 98
COMMAND SYNTAX ......................................................................................................................................... 104
BATCH MODE ................................................................................................................................................... 106
AFP ................................................................................................................................................................. 107
iSeries: ........................................................................................................................................................ 107
Unix/Windows: ............................................................................................................................................ 107
LIST OF EMBEDDED FONTS IN PDF PROJECTS ................................................................................... 108
CHOOSING THE EMBEDDED PDF FONTS ........................................................................................................... 108
Page 5 of 109
Chapter 1 – Installation
Installing MAPDRAW
This section shows how to install or update MapDraw. Be sure to also update the other products in
the software suite to avoid any conflicts.
Requirements
To connect the MapDraw PC to the server where Mapping is installed, you will need to:
Know the IP address or network path to the machine
Have Write access rights over Mapping folders
Have Admin rights for installing
If you are updating, be sure to make a backup copy of the current environments first.
Minimum requirements:
Pentium III 800 MHz (or equivalent)
Windows 2000, XP or 2003
128 MB of RAM
20 MB of free disk space
CD-ROM drive
For more information on MAPPING Suite requirements, visit: http://www.mappingsuite/prerequisites
Installation
1. Launch set-up from the installation CD or client site
2. Answer the questions
Extract installation files:
Page 6 of 109
MAPDRAW TECHNICAL GUIDE
3. Click Next to start installing.
4. Click Yes to accept the license agreement.
Page 7 of 109
5. Change the installation folder if necessary and then click Next.
6. Select the path to the IFS folder between MapDraw and Mapping (this can be done at a
later stage) and then click Next.
Page 8 of 109
7. Click Next to install all the components.
8. If necessary change the shortcut in the Windows Program menu and click Next.
Page 9 of 109
9. Wait for the installation to finish.
10. Click Finish to end the installation.
Note
Software license keys are not required to activate MapDraw. MapDraw can be installed on as
many computers as necessary.
Page 10 of 109
Setting up access to the Mapping server
1. Open MapDraw
2. From the File menu, choose Preferences to configure the connection between MapDraw
and the Mapping server.
If you use FTP (local copy of the mappings), continue with step 3. If not, skip to step 5.
A. FTP Configuration
3. Check the Use FTP box.
4. Give a name to the Mapping server in Server Name and fill in the different fields. Then,
click on the Test connection button to check that the connection works fine.
Note
If you will be using FTP to generate documents on several PCs, the shared folder must be the
same for every PC where MapDraw will be installed.
Page 11 of 109
B. Share Folder
5. In the Share Folder field, select the folder where the projects will be saved. The folder can
be local or it can be a UNC path or mapped network drive. In the screen capture below it is a local
folder.
Page 12 of 109
Chapter 2 – Process automation
Automating MapDraw processes
In this chapter you will learn how to create image files to easily preview any given project. You can
also automatically generate projects and project associations from a command prompt and use hidden
mode.
You need to be familiar with Windows-style commands.
Command parameters
Simply write the command in a .BAT file or use a remote command.
Here is the list of associated parameters:
-InFile
.PAG or .XML file to be remapped
-OutFile
Image output file
-ProjectFile
Project to be opened (.MPP)
-ProjectAsso
Project association to be generated (.MPA)
-MPIFile:
MPI file to be opened (MAP tab)
-MPWFile:
MPW file to be opened (DRAW tab)
-Hide
To start MapDraw in hidden mode
-Color
Allows you to create colored images
-Rotation
Image rotation angle (default: 0)
-Resolution
Image resolution (default: 300)
-Specimen
Allows you to add text above the image (insert text as an argument)
-Mode
Spool file or XML mode (default: SPLF)
-Generate
To start generating the project specified as argument
-Lang
Generation language (default: PCL5)
0: PCL5
1: PCL OPTIMIZED
2: PCL5 IMAGE
3: AFPDS
4: PDF (requires a project association)
5: ZEBRA
6: DPL
7: IGP
8: TEC
9: IPL
10: F+D
11: EPL
12: XPS
Page 13 of 109
-SubLang
Generation sub-language (default: 0)
Depends on primary generation language:
- PCL5, PCL5 OPTIMIZED, PCL5 IMAGE:
0 = PCL5e (default)
1 = PCL5
- AFPDS:
0 = 4028 Compatible
1 = Resident Font
3 = Font Collection (default)
- DPL:
0 = Macro Standard
1 = Send Standard
2 = Macro Mainframe (default)
3 = Send Mainframe
- IPL:
0 = Bitmap Font
1 = True Type Font (default)
-GenColor
Black and white or color (0 or 1) (default: 0 i.e. black and white)
-Acif
Acif mode, only for AFPDS (0 or 1) (default: 0)
-Res
Generation resolution
Depends on primary generation language:
PCL5, PCL5 OPTIMIZED, PCL5 IMAGE: 300 or 600 (default: 300)
AFPDS: 240, 300 or 600 (default: 240)
PDF: 300 or 600 (default: 300)
ZEBRA: 152, 203, 300 or 600 (default: 152)
DPL: 152, 203, 300 or 600 (default: 152)
IGP: 72, 152, 203, 300 or 600 (default: 72)
TEC: 203 or 300 (default: 203)
IPL: 203 or 300 (default: 203)
F+D: 203 or 300 (default: 203)
EPL: 203 or 300 (default: 203)
-Overlay
Generate overlay (0 or 1) (default: 1)
-Font
Generate font (0 or 1) (default: 1)
-FtpUse
0 = No FTP, 1 = FTP
-FtpFolder
FTP folder
-FtpLogin
FTP login
-FtpPassword
FTP password
-FtpIPAddress
FTP server IP address
-ShareFolder
Shared Folder
-ServerName
Server Name (description)
Page 14 of 109
-Rename
Changes the project FORMAT and SEQUENCE using the name of the project.
Example: Invoice00010.mpp
-MVM
Opens MapDraw in MappingVersionManager mode.
-ImportXML
Imports the file specified in XML mode
-ExportXML
Exports the file specified in XML mode
-ImportXPS
Imports an XPS file into a MapDraw format
Examples
Below is a list of examples illustrating the use of the different parameters.
Example 1: Importing an XML file. The –Save parameter saves the imported file automatically but will
overwrite the file if it already exists.
C:\Program
Files\MapDraw\Mapdraw.exe
InFile:C:\testmpp.xml" "-Hide"
"-ImportXML"
"-Save"
"-
Example 2: Exporting a complete project in XML
C:\Program Files\ \MapDraw\Mapdraw.exe "-ExportXML" "ProjectFile:C:\Program Files\ MappingWindows\Import\docpc\test.mpp"
"-OutFile:C:\testmpp.xml" "-Hide"
Example 3: Exporting a component in XML
C:\Program Files\ \MapDraw\Mapdraw.exe "-ExportXML" "MPWFile:C:\Program Files\ MappingWindows\Import\docpc\test.mpw" "OutFile:C:\testmpw.xml" "-Hide"
Example 4: Exporting a variable element in XML
C:\Program Files\ \MapDraw\Mapdraw.exe "-ExportXML" "MPIFile:C:\Program Files\ MappingWindows\Import\docpc\test.mpi" "OutFile:C:\testmpi.xml" "-Hide"
Example 5: Generating a bitmap
C:\Program Files\MapDraw\mapdraw.exe "-ProjectFile:C:\Program
Files\MappingWindows\Import\DocPc\test.mpp" "-SaveImage" "InFile:C:\Program Files\MappingWindows\Import\test.PAG" "OutFile:c:\test.bmp" "-Hide" "-Mode:SPOOL"
Example 6: Project generated in PCL, color and 300dpi
C:\Program
Files\MapDraw\mapdraw.exe
"-Hide"
"ProjectFile:C:\Program
Files\MappingWindows\Import\DocPc\test.mpp"
"-Generate"
"-Lang:0" "-GenColor:1" "-Res:300"
Page 15 of 109
If "-Generate" (to generate the project) is included in the command, either "-ProjectFile:" or
"-ProjectAsso:" has to be included as well.
If both "ProjectFile:" and "-ProjectAsso:" are included in the command, the project will be
generated but the project association will be ignored.
Example 7: Project association generated in PDF, color and 300dpi
C:\Program
"-Hide"
"ProjectAsso:C:\Program
Files\MappingWindows\Import\DocPc\test.mpa"
"-Generate" "-Lang:4" "-GenColor:1" "-Res:300"
Example 8: Creating a .BMP image in color, 90° rotation angle, 203 dpi resolution and with text added
above the image:
C:\Program
"-InFile:c:\test.xml"
"OutFile:c:\image.bmp"
"-ProjectFile:C:\Program
Files\MappingWindows\Import\DocPc\test.mpp"
"-Hide"
"-Rotation:90"
"Resolution:203" "-Color" "-Mode:XML" "-Specimen:SPECIMEN"
To create an image, you have to include both "-InFile" and "-ProjectFile".
If "-OutFile" isn’t included, the .BMP output file name will be the same as the input file.
If the input file is XML, you will need to add "-Mode:XML" as the default mode is SPLF.
Exemple 9: Importing an XPS file into a MapDraw format in hidden mode:
C:\Program Files\MapDraw\mapdraw.exe
Format:TESTXPS" "-Hide"
"-InFile:C:\testword.xps"
Optional parameters:
-MemSpace: to enable the use of memory zones with spaces
-NoParagraph: does not create paragraphs in MapDraw
Note
The double quotes around each parameter are required syntax.
Page 16 of 109
"-
Generating components
To generate components automatically, you will need to specify which component (with an MPW
extension) must be processed by the command using the -MPWFile parameter.
You will also need the -Generate parameter plus all the usual parameters required for the
generation of MapDraw projects (language, resolution, etc.).
Example
"C:\Program Files\MapDraw\MapDraw" "-Generate" "-MPWFile:C:\Program
Files\MappingWindows\Import\whatever.mpw" "-Lang:0" "-GenColor:0" "Res:300"
The command above will generate a component called whatever.mpw with language set to PCL5, in
black and white mode, and a standard resolution of 300 dpi.
Registry settings
MapDraw stores settings in the registry in HKEY_CURRENT_USER. Some of those settings are used
when generating automatically without them being called when running mapdraw.exe.
Therefore, in an automated generation context, if the username is not the one used to configure
MapDraw, some parameters can be missing. To avoid this, it is recommended to copy the settings into
DEFAULT USER as explained below:
As there is nothing set up for the SYSTEM user, you will need to define MapDraw settings for the
Default User in the registry.
The easiest thing to do is to export the Registry content from HKEY_CURRENT_USER and import it
into DEFAULT USER.
Open the Registry, and then export the following branch to a .reg file:
[HKEY_CURRENT_USER\Software\Mapping\MapDraw 6]
Then, open the file in a text editor and replace all the occurrences of HKEY_CURRENT_USER with
HKEY_USERS\.DEFAULT
Finally, import the new .reg file (or execute it directly).
Note
If you make further changes to these settings, you will need to update them for the Default User
again.
Page 17 of 109
Chapter 3 – Barcodes
How to design barcodes in MAPDRAW
General principle
This section shows how to create zones of bar code type in MapDraw.
To design a barcode in MapDraw, you will need to create a zone and select Bar Code and then the
type of barcode using the drop-down lists under Type in the Zone properties dialog box.
After creating the zone, select the barcode font in the Font and Style tab. The fonts are stored in
the Fonts and Fonts_old folders on the installation CD-ROM.
The fonts located in the Fonts folder are the new fonts recommended for Mapping. They can be used
with projects created with MapDraw Unicode.
Here is the list of new fonts:
BC25E.ttf: 2/5 interlaced
BC25EL.ttf: 2/5 interlaced (with label)
BC25S.ttf: 2/5 industrial
BC25SL.ttf: 2/5 industrial (with label)
BC39.ttf: Code39 and Code39 without control
BC39L.ttf: Code39 and Code39 without control (with label)
BC128.ttf: Code128 and EAN128
BC128A.ttf: Code128 and EAN128 (with Alpha label)
BC128N.ttf: Code128 and EAN128 (with numerical label)
BCEan.ttf: EAN8 and EAN 13
BCEanL.ttf: EAN8 and EAN 13 (with label)
BCCodabar.ttf: Codabar and NW7
BCCodabarL.ttf: Codabar and NW7 (with label)
BCJapanPostal.ttf: Japan Postal
Page 18 of 109
Complementary information is available in MapDraw’s online help section (press F1 in MapDraw).
The barcode size, width and length depend on the font size. To reduce the height, choose a different
value under Height (%).
To label a barcode, select a labeled font.
Page 19 of 109
Special Case: AFP/IPDS
Barcodes managed by the printer
To print barcodes natively on IPDS printers (BCOCA), check the « Printer resident barcode » box in
the Advanced Properties of the MapDraw project.
In this mode, you won’t need to select any font because it is the printer that will draw the barcode.
Therefore, the preview feature will not be available in MapDraw.
The available settings (Font and Style tab in Zone properties) are:
- Font size (to set the barcode’s height)
- Barcode width
- The checkbox labeled Data printed under barcode
Page 20 of 109
Barcodes managed by MAPPING
If you would like Mapping to handle barcodes (recommended), uncheck the « Printer resident
barcode » box in the Advanced Properties of the project.
Page 21 of 109
Special case: Thermal Languages
Barcodes managed by the printer
In a non Unicode MAPPING environment, barcodes are printed natively on thermal printers.
In this mode, you won’t need to select any font because it is the printer that draws the barcode.
Therefore, the preview feature will not be available in MapDraw.
The available settings (Font and Style tab in the zone properties) are:
- Font size (to set the barcode’s height)
- Barcode width
- The checkbox labeled Data printed under barcode
Page 22 of 109
Barcodes managed by MAPPING
In a Unicode environment, Mapping is able to handle barcodes (recommended). To enable this option,
uncheck the « Printer resident barcode » box in the Advanced Properties of the project.
Page 23 of 109
Data Rollup
The data located in several places in a spool file can be accumulated into a single barcode. To do so,
you will need to create as many memory zones as the amount of data in the file and then accumulate
the zones in the barcode zone label under Characters added after the zone.
Creating memory zones
Creating barcode zones
Note
It is also possible to add text that is not included in the spool file with:
[[MEM1]]TEXT[[MEM2]].
If you are using replacement zones in a barcode zone, set the barcode length to 0.
Page 24 of 109
EAN 128
Encoding EAN128 is the same as encoding Code128. This is why we use the same fonts. The only
difference is that EAN128 is structured differently so it can standardize the data. An AI (Application
Identifier) is inserted after each piece of information to identify the encoded data.
EAN128 structure: START FNC1 AI DATA (FNC1) AI DATA .... (FNC1) AI DATA CRC END
FNC1: EAN128 separating character.
AI: Application Identifier, ensures that several pieces of standardized data are encoded into a same
code (date+time+...).
The first FNC1 is automatically added by MapDraw and is essential because this is what differentiates
an EAN128 from a CODE128 barcode.
The next FNC1 are optional. They are required only when the previous piece of data doesn’t have a
fixed length. In this case they separate the pieces of data.
If you would like to insert FNC1 characters, you need to add the paragraph sign (§) in your spool file.
Mapping will automatically replace § with FCN1 characters.
Example:
SPOOL
AI DATA
AI DATA § AI DATA
---->
---->
---->
MAPPING
START FNC1 AI DATA CRC END
START FNC1 AI DATA FNC1 AI DATA CRC END
If you cannot modify the spool file and add the § sign or you would like to accumulate several pieces
of data located in several places in your file (see Data Rollup), you can use memory zones instead.
Note
EAN128 barcode labels must contain the Ai in brackets. Because this is not managed
by barcode fonts, you need to add a text box under the barcode to add the label.
Page 25 of 109
CODE 128
There are 3 encoding modes available for bar codes of type 128: mode A (alphanumeric), mode B
(alphanumeric) and mode C (numeric).
Code 128 Alphanumeric encodes in mode B.
Code 128 Numeric encodes in mode C.
Code 128 Alphanumeric Optimized switches from mode B to mode C automatically so as to optimize
the bar code size.
However, you may have to stick to a particular format for your bar codes, that is to say keep to a
certain number of characters in mode A, B, or C.
For example, the bar code that corresponds to the tracking identifier for letters and parcels sent via
the French postal services « La Poste » is made up of 13 characters. The first 3 characters must be
encoded in mode B and the next 10 in mode C.
To create this kind of bar code in MapDraw, you must create a zone of type « Code 128 Non
Optimized », and then enter a Formatting Mask in the Advanced options for that particular zone.
Example
Let’s assume you have the following character string: 1J45034500751
You wish to encode:
- the first 3 characters (1J4) in mode B
- the 10 last characters (5034500751) in mode C
Therefore, the formatting mask must be BBBCCCCC.
Note
Although you need to encode 10 digits in mode C, you will only need to enter 5 Cs in
the formatting mask. This is due to the fact that one character in mode C encodes 2
digits.
Page 26 of 109
CODABAR
It is possible to create documents containing CODABAR barcode type (also known as NW-7 in Japan).
Given that this type of barcode does not require coding or check digit, there is no special MapDraw
zone for CODABAR, a simple text zone using font BCCodabar or BCCodabarL is enough.
However, this type of bar code must have a start and stop character (character A, B, C or D).
If the start and stop characters are not present in the data, you will need to do the following:
1 - create a memory zone that will contain the barcode data.
2 - create a replacement memory zone containing the data and the start and stop characters. This
zone should use the BCCodabar or BCCodabarL font.
Page 27 of 109
2D bar codes
Today, MAPPING can handle four types of 2D bar codes: PDF417, DATA MATRIX, QR CODE and UPS
MAXICODE.
In PCL5 and PDF: PDF417 - DATA MATRIX - QR CODE - MAXICODE
In ZEBRA: PDF417 - DATA MATRIX
You will not need to select any font because it’s the printer that draws the bar code.
In PCL and PDF, use the “Bar code width” field to change the bar code size.
In ZEBRA, the bar code height is determined by the font size.
2D bar codes make it possible to encode a lot of information. If the data you wish to encode is located
in several places across the spool file, go to the Data Rollup section to know how to accumulate it
into a single bar code.
However, note that this type of bar code handles optimizing sequences (from alphanumeric to
numeric). Consequently, the bar code size can vary in height and length according to the data you
need to encode.
Page 28 of 109
QR CODE
QR CODE has been developed according to the international standard ISO/IEC 18004. The advantage
of using QR CODE is that it makes it possible to encode a large number of characters (7736 in
numeric mode).
There are four types of encoding schemes (alphanumeric, numeric, bytes, Kanji) that offer various
compression rates. By default, we use an automatic mode that selects the best encoding format
according to the best possible compression rate. The automatic mode also allows switching from one
type of encoding to the other during processing.
For instance, let’s assume that the beginning of a string contains alphanumeric characters. As soon as
the program detects a string of at least 13 characters, it will change the encoding mode.
The program adds detection/correction error codes to the data. The codes make it possible to resist
damages and prevent any loss of data. There are four levels of error correction/detection. We have
selected level 3 where the codes account for approximately 25% of the final bar code size.
Advanced options:
-
-
Barcode width: Value ranging from 1 to 15 used to set the bar code size
Error Level: (7%, 15%, 25% and 30%)
FCN1:
ECI protocol not implemented
ECI protocol not implemented, FNC1 implied in first position
ECI protocol not implemented, FNC1 implied in second position
For the latter, a grouping character is required (application identifier).
Application Identifier: Grouping character only used with FCN1 implied in second position
Encoding:
AUTO: Automatic data encoding incl. mode switching depending on data type
ALPHA: Alphanumeric encoding
NUMERIC: Numeric encoding
BYTE: Byte encoding
Page 29 of 109
DATA MATRIX
DATA MATRIX has been developed according to the international standard ISO/IEC 16022 and will
encode up to 2335 characters.
Several types of encoding are available (ASCII, C40, Text, and Base 256), but, as with QR CODE, we
have selected an automatic mode that allows optimizing and switching between encoding modes
according to the data type.
Error detection/correction codes are also included to prevent any damage to the bar codes.
Advanced options:
-
Barcode width: Value ranging between 1 and 15 used to set the bar code size
Encoding:
• AUTO: Automatic data encoding including mode switching according
to data type
• ASCII: ASCII encoding is an easy way to encode ASCII data.
• C40: C40 transforms 3 alphanumeric characters into 2 code words.
• TEXT: Text encoding is used to encode lowercase characters.
PCL DATAMATRIX barcode with a static prefix
Let’s assume you wish to encode the string INSEE1690713. But all you have in the
splf is 1690713. Solution: Insert a Memory / Text zone to store the data i.e. 1690713
in a zone called MEMZONE for example. Then, design the bar code, set the length to
0. In the field “Characters added after the zone” type INSEE[[MEMZONE]].
Page 30 of 109
However, before the string INSEE, there must be an empty Memory / Text zone too.
For example, call it VOID with length = 0. In the end, in the “Characters added after
the zone” field you should have: [[VOID]]INSEE[[MEMZONE]].
Page 31 of 109
PDF 417
PDF 417 bar codes have been developed according to the international standard ISO/IEC 15438. This
kind of bar code will encode up to 2700 numerical characters.
There are three types of encoding (alphanumerical, numerical and bytes). Here again, automatic
mode will select the best compression rate for you and you will be able to change modes during
processing. There is also an eight-level error detection/correction mode selected depending on the
number of characters that must be encoded.
Advanced options:
-
-
Error Level:
AUTO: automatic selection
0-8
Compact Mode: Enables or disables compact mode
Ratio: Allows setting the bar code height/width ratio
Fixed Columns: type the number of columns here
Fixed Rows: type the number of rows here
Selecting a ratio will prevent you from choosing a number of columns and rows.
Page 32 of 109
UPS MAXICODE
This type of barcode was developed by UPS – United Parcel Service – according to the ISO 160232000 standard. Unlike other 2D barcodes, it has a fixed size and will encode a limited number of
characters. The maximum size is 93 alphanumeric characters or 138 numeric characters.
There are two types of encoding:
- The first type will only encode a character string that includes data based on a classic
encoding scheme and a standard error detection/correction system.
- In addition to the data string, the second type will also encode three fields stored in three
memory spaces in MapDraw. The three fields are: country – 3 numbers according to the ISO
3166 standard (called map_countr), zip code – 6 characters (map_zipcod) and a kind of
services – 3 characters (map_servic). Unlike the classic correction mode used in data strings,
the three fields include an extended error detection/correction scheme.
Advanced options:
-
Page 33 of 109
Intelligent Mail Barcode (United States Postal Service)
For this barcode, two sets of data must be encoded: the Tracking Code and the Routing Code.
The Tracking Code is a 20-digit field that contains different sets of information:
Barcode Identifier: 2 digits (the second digit must range between 0 and 4)
Service Type Identifier: 3 digits
Mailer Identifier: 6 or 9 digits
Serial Number: 6 digits if the Mailer ID has 9 digits, else 9 digits
The Routing Code is optional and contains the Delivery Point ZIP Code that can be 0, 5, 9 or 11 digits.
In MapDraw, the barcode zone must include in the following order the Tracking Code directly followed
by the Routing Code without any blank space or other character between the two (Memory zones can
be used to retrieve all the spool file data).
In MapDraw, you will need to draw a barcode zone of type « USPS » and the character font must be
« BCUSPotal ».
Page 34 of 109
Chapter 4 – Components
How to design and apply components
In this chapter, you will learn how to design and apply components in MapDraw.
Definition
A component is an extra overlay that can be used in all MAPPING projects in addition to the main
overlay.
A conditional logic can be defined to apply the component only to some spooled files or some pages
inside the same spooled file.
Typical example: as a header or footer
Design the header of your company once for all documents. In each Mapping format, you will call the
header component and apply it together with the main overlay.
If your company moves for example, you can change the footer with the new address once for all
documents.
Component files have an .MPW extension just like regular overlays.
How do I create a component?
In MapDraw, go to File > New > Component…
The following dialog box comes up:
Select the component settings (language, size, margins…) and click « OK ».
Note
As you will see, you do not need to enter a format and sequence name for the
component.
Page 35 of 109
Next, design the component as you would normally design any document in MapDraw. In this
example, the component has a Mapping logo and footer.
Once finished, you will need to generate the component. To do this, click on
toolbar on the left. The « Save as » dialog box opens up:
at the bottom of the
Enter a name for the component and then click on « Save ».
Note
Components must be saved in the « docpc » directory on the MAPPING server.
Page 36 of 109
Select the generation settings.
Click on « OK » to generate the component.
Note
The component must have the same print characteristics as the MAPDRAW project it
will be used with.
Page 37 of 109
How do I insert a component in a project?
This is very simple. In the « MAP » part in MAPDRAW, click on
The following dialog box comes up.
in the toolbar.
Click « Add » and then select the component you wish to use.
If necessary, click on the « Conditions » tab to set a conditional logic.
Click on « OK » to save.
Page 38 of 109
Chapter 5 – Existing AFP overlay
How to call an existing AFP overlay
This section shows how to call an existing AFP overlay in a MapDraw document template.
You will need to know how to use MapDraw in AFP and convert an EBCDIC text to ASCII values.
Steps
1) In MapDraw, select the MAP tab and click on the commands icon
toolbar to create a PCL zone with length = 0.
in the variable
2) In the InsertPCL5 tab, type the following:
<<HEX:5A0016D3AFD8000000D6F1D4F0F0F0F0F5000000000000>>
Replace D6F1D4F0F0F0F0F5, which means O1M00005, with the name of the existing AFP
overlay. Be careful not to change the length (=8).
Page 39 of 109
Chapter 6 – How to generate PDF projects – Project associations
How to generate PDF projects
In this chapter you will learn how to generate MapDraw projects by means of a project association.
This is the only way to create projects in PDF format. However, project associations can also be used
to generate any project in any other supported language in MapDraw, and are especially useful when
working with different sequences.
Creating the project association
In the File menu, choose Project association and New.
The Projects association dialog box comes up with the list of available projects on the left hand
side. Highlight the MPP files you wish to associate (hold down the Ctrl key and click on each
individual file). For instance, select the two sequences of the A4BARCODE project. Next, click on the
> button.
Page 40 of 109
You can now see both files under the Associated projects column. Click Save.
Give a name to the file and save it as an MPA file.
Page 41 of 109
Once the file is saved, click Generate.
Select the generation settings. Be sure to select PDF under Language. Then, click OK.
The generation by project association is finished. Now, all you need to do is import the files on the
production system.
Note
You
must
use
the
project
association
Page 42 of 109
feature
to
generate
PDF
projects.
Chapter 7 – How to display PFSRC or file data
How to display PFSRC or file data
This section shows how to display specific information in a MapDraw document. The information
comes from:
Either a PFSRC (system i)
Or a file (Unix/Linux/Windows).
On the system i
To use this option, you will first need to create files of PFSRC type on the system i.
The source file will be called QMAPFIELDS and must be located in the « library list » at runtime.
The idea is to define the following in MapDraw:
A zone of type « Tools/File Replacement »
1. The zone name must be the same as the member name that
you will use to retrieve the information.
2. The line number represents the line number of the source file
where the info can be found.
3. The data’s column and length.
You may also use groups to retrieve the information on lines 1 to 4 for instance.
MapDraw
System i
„ADR“ field
Mapping
22 Rue du
59561 LA M
0001
0002
0003
0004
...+... 1 ...+... 2 ...+... 3
Mapping
22 Rue du général de Gaulle
59561 LA MADELEINE FRANCE
www.mapping.com
As the preview isn’t available, the PFSRC data will be replaced with:
« line 1 from xxxxxx »
Page 43 of 109
Overall block diagram during production (mapcpysplf)
MapDraw
System i
„ADR“ field
PF-SRC in library *LIBL
(Filename f. e. QMAPFIELDS)
„ADSP“ field
File member
„ADR“
Mapping Suite
..........................
„BANK“ field
.
.
.
File member
„BANK“
Deutsche Bank
BLZ ..........................
„ADR“ field
Note
Conditions cannot apply because they are using information included in the spool file.
To set conditions, you must use different files.
Pay particular attention to the file’s CCSID used in the conversion to the Unicode code
page.
Page 44 of 109
On Unix / Linux / Windows
To use this option, you will need to create files of text type in the following folder:
$PATH_IMPORT\lgobitmap\data_ ???????.txt
The file must start with « data_ » and end with « .txt »
The question marks ???? must be replaced with the zone name.
The idea is to define the following in MapDraw:
A zone of type « Tools/File Replacement »
4. the zone name must be the same as the member name that
you will use to retrieve the information.
5. the line number represents the line number of the source file
where the info can be found.
6. the data’s column and length.
You may also use groups to retrieve the information on lines 1 to 4 for instance.
MapDraw
Unix/Linux/Windows
Field „ADR“
Mapping
22 Rue du
59561 LA M
Mapping
22 Rue du général de Gaulle
59561 LA MADELEINE FRANCE
www.mapping.com
As the preview isn’t available, the PFSRC data will be replaced with:
« line 1 from xxxxxx »
Page 45 of 109
Overall block diagram during production (mapcpysplf)
MapDraw
Unix/Linux/Windows
„ADR“ field
Lgobitmap folder
„ADSP“ field
File name
data_ADR.txt
Mapping Suite
..........................
„BANK“ field
.
.
.
File member
data_BANK.txt
Deutsche Bank
BLZ ..........................
„ADR“field
Note
Conditions cannot apply because they are using information included in the spool file.
To set conditions, you must use different files.
If you are working with the Unicode version of MapDraw, the file must be Unicode
and start with FFFE.
Page 46 of 109
Chapter 8 – Labels
Labels
In this section, you will learn how to create labels and label plates in MapDraw using variable
elements.
Note that the steps described in this document only apply to MapDraw 6.0.8.2 and higher.
General Principle
To start designing a label, go to File -> New-> Variable element…
This will create a blank project without an overlay. Also, the format name and sequence number
cannot be changed. This means you will need to design the label in its actual size.
Note that you will be able to change the data position and conditions when inserting the label into the
new project.
Thus, to create a label plate, just design the label and then import it into a new project and duplicate
it.
Page 47 of 109
Opening a variable element in a project
To open a variable element in a new project, you will need to add an object of Variable Element type
in the toolbar on the left-hand side and select the associated label template (i.e.
by clicking on
the MPI file corresponding to the label created previously).
Type a name for the label under « Name ».
« MPI file » is the MPI file corresponding to the actual label template.
« Increment data » is used to change the line where data is retrieved in the spooled file. For example,
if the label contains a zone that is set to retrieve data from line 10 in the spooled file, and if the
increment is equal to 2, the program will now pick data from line 12 instead.
« Increment conditions »: same principle as for « Increment data » but applied to conditions.
Page 48 of 109
Duplicating a variable element
The interesting thing about variable elements is that you can easily duplicate them (Edit menu ->
Duplicate).
You can easily create label plates by duplicating single labels without having to design a new template
for each new label. When duplicating labels, you can choose the number of labels per row and column
and you can also choose to increment the data and conditions included in the label.
Page 49 of 109
Example: Creating a label plate
Step 1: Creating a label
In this example, each label in the label plate is set up in a specific line in the PAG file.
First, design the first label (here 4x8 cm) in the label plate.
Label preview:
Then, save the label under the name « Label.mpi »
Page 50 of 109
Step 2: Inserting the label into a new project
Create a new project and insert an object of Variable Element type:
In the Label dialog box, click Open and browse to the label file (Label.mpi):
Page 51 of 109
Note that you can preview the project to make sure you’ve selected the right file:
Step 3: Creating a label plate
To create a label plate, duplicate the first label while incrementing the label data with each label you
duplicate.
Page 52 of 109
Duplicate the label to obtain 10 labels:
The label data has been incremented and you can now preview the result:
Check that each label is different and retrieves the right lines from the PAG file. Then, save the
project. You have now successfully created a label plate.
Note: Generation
Variable elements are design objects and must not be generated.
Page 53 of 109
Chapter 9 – Stapling
Configuring the Stapling option in MapDraw
This section shows how to configure the Stapling option in MAPDRAW.
Steps
In MAPDRAW, open the project and then click on
Properties box.
Click Advanced >>.
Page 54 of 109
in the icons bar to open the Project
In the Advanced Properties box, select Stapling in the Command drop-down list and then click
>> to insert the PJL command that will be sent to the printer. This is a standard command but you
will need to add other specific commands depending on the printer you are using. You will find the
commands in the printer manual.
Example command for an IBM printer:
The <<UEL>> <<CRLF>> >>ESC>> … commands are required to execute the file. Select them
from the Command drop-down list. They are used to initialize the PJL mode and then switch back to
PCL. The only variable that must be entered according to the printer model is the value after "@PJL
SET STAPLE=".
In the following example, the stapling command will apply to the whole document.
Page 55 of 109
Stapling a document on a break
There are 2 kinds of « breaks »:
A)
Sort and Split commands: On a value in the spool file, for instance if you have a big spool file
with multiple customer numbers in it and you want to staple the pages of each customer together. (In
other words staple all the same customer IDs together)
B)
Sequences: If you want to staple X MapDraw sequences together, for instance from 1 page of
a spool file you want to create multiple ones with a different overlay and staple them together.
A) How to staple the pages of each customer together when you have a big input spool
file with multiple customer IDs in it (in other words staple all the same customer IDs
together)
First, you will need to use the MAPSORTSPLF command to split the spool file into multiple ones using
the customer ID as the split up key.
Then, create a rule that takes those new « little » spool files and that applies the MapDraw format
which has the properties of the example here in the first part of this documentation that prints and
staples the pages. (Assuming that the printer has the stapling finisher).
B) How to staple X MapDraw sequences together
Example :
Sequence 10 start page
Sequence 20 middle page
Sequence 30 end page
And then set a conditional logic to start and stop stapling based on the sequence.
The example below was made using the IBM InfoPrint 2235 extends monochrome cutsheet printer
line. The detailed code may change depending on the printer used... Tests must be carried out.
Here for our example we are going to deal with 3 different sequences. We want to staple those 3
different MapDraw sequences together.
To do that, we have to tell the printer to « start stapling> at sequence 00010 and « end stapling » at
sequence 00030.
Starting the stapling
To do so, open the page proprieties of sequence 00010 and type the following in page – Pre-Printing
section:
<<ESC>>%-12345X@PJL SET STAPLE=LEFTTOPSLANTPORT<<CRLF>>@PJL
ENTER LANGUAGE =
PCL<<CRLF>><<ESC>>E<<ESC>>&l2a0o0x0S<<ESC>>&b1M<<ESC>>&f000
03y2X<<ESC>>*t300R<<ESC>>&u300D<<ESC>>*v0n0o0T<<CRLF>>
Here in
green are the variable values :
LEFTTOPSLANTPORT : change depending on the printed used (this is the way of stapling :
Slanted on the left top corner of the pages)
Page 56 of 109
&f00003 : Overlay number will have to be the same as the one contained in the lstobj.txt file. (here
Overlay number 3)
&12a : Page definition. Here it is a letter format.
In the pre-Printing section we have defined the Page definition and the overlay used to print.
So we must uncheck the Page definition and Call up overlay checkboxes.
Here below for your information are the details of the code entered in the pre-printing section:
<<ESC>>%-12345X → Every PJL code sequence must start with <<ESC>>%-12345X
@PJL SET STAPLE=LEFTTOPSLANTPORT → this is defined by the printer. (See the printer manual for
more information)
<<CRLF>> → Every PJL command must end with a <<CRLF>> (Carriage Return Line Feed.)
@PJL ENTER LANGUAGE=PCL<<CRLF>> → we are telling the printer that we are going to
have PCL code coming next. Then, like before, a CRLF is needed to end the PJL command.
<<ESC>>E → To reset the printer and start the PCL Code
<<ESC>>&l2a0o0x0S → Page definition (Here Letter Format)
<<ESC>>&b1M
<<ESC>>&f00003y2X → Overlay definition (To be checked on the lstobj.txt file to know which
overlay number must be entered; here 00003 for the example)
Page 57 of 109
<<ESC>>*t300R → 300 dots / inch graphic Mode
<<ESC>>&u300D → 300 dots / inch graphic Mode
<<ESC>>*v0n0o0T<<CRLF>>
Note
To make sure the PJL and PCL sequences suit the printer you are using, it might be
useful to print to a print-file using the Windows driver of the printer. You can then
look at it to make sure that the PCL and PJL codes you have entered in MapDraw
correspond to what the printer is expecting.
Ending the stapling
Now we are going to trigger the stapling. Because we want to trigger the stapling on sequence 00030,
we have to end the PJL stapling job at that sequence.
Open the Page Properties of the MapDraw sequence 00030 and type the following in the Page PostPrinting section:
<<ESC>>E<<ESC>>%-12345X@PJL<<CRLF>>@PJL
EOJ<<CRLF>><<ESC>>%-12345X
Make sure that Page Definition and Call up Overlay are checked and Page Break is UNCHECKED.
Now the printer will staple the 3 MapDraw sequences together.
Page 58 of 109
Chapter 10 – SQL queries
How to run SQL queries in MapDraw
In this section, you will learn how to insert data from a database into a MapDraw document template
using SQL commands.
Requirements
The Mapping server must support SQL commands.
The database application must be SQL compatible (SQLCLI on iSeries).
mapping.conf and map_036 must be properly defined in Unix or Windows.
Knowledge of Memory type zones in MapDraw is required.
Steps
Example: Let’s assume you need to retrieve the name of the customer in the document. But in the
spool file, all you have is the customer ID.
5. Create a memory zone to insert the customer ID in the spool file:
Type: Memory
Sub-type: Text Memory, Float Memory or Integer Memory
Page 59 of 109
6. Create a zone to process the SQL query:
Type: Memory / Sub-type: SQL Memory
Label: {SQL:SELECT NAME FROM MYLIB.CUSTOMER WHERE ID=[[ID]]}
Note that {SQL:…} will only retrieve the first record in the database. To retrieve all the records
delimited by commas, you will need to use the {SQLGROUP:…} operator.
7. Create a zone to display the result of the SQL command:
Type: Memory / Sub-type: Memory Replacement / Width: 0
Label: [[NAME]] where NAME is the name of the SQL zone.
Page 60 of 109
This is what the zones will look like in the MapDraw template.
Note
If an error occurs during processing on iSeries, enter the DSPJOBLG command
(Display Job Log – Press F10 for more information) to verify the syntax of the SQL
command.
Page 61 of 109
Next, check the zone order in the summary table. You should see first the Memory / Text memory
zones, then Memory / SQL Memory and finally Memory / Memory Replacement.
Note: Preview
Note that SQL zones cannot be previewed because MapDraw isn’t directly connected
to the database.
Page 62 of 109
Chapter 11 – How to replace character strings
How to replace character strings
Steps
The idea is to use a text file as a correlation map between the character string in the input file and the
new string you want to print. To use this correlation map, you will need to design a Text / Substitution
zone.
1. In MapDraw, create a zone that will retrieve the character string in the input file and choose
Text and Substitution from the two drop-down lists under Type.
2. Click OK and then generate the Mapping format as usual.
Page 63 of 109
Chapter 11 – How to replace character strings
3. Open the ReplaceValue.txt file in a text editor (such as Notepad, but not Word) and use this
syntax :
String to replace
Tabulation
New string
Here "]" will be replaced with ">" and "Nom" with "Name".
4. Save ReplaceValue.txt in the subfolder lgobitmap in Mapping (default location:
\home\mapping\lgobitmap on iSeries and /apps/mapping/import/lgobitmap on UNIX).
Other example
This function is also used to change the formatting of a specified text string between two tags
(underline, bold...)
Example : Dear Mr <bold>Smith</bold>
Then in the replaceInFile.txt file, we specify:
<bold>
</bold>
[ESC] ( s 3 B <-- PCL code to bold On
[ESC] ( s 0 B <-- PCL code to bold Off
Page 64 of 109
Chapter 12 – ACIF (AFP)
ACIF (AFP)
In this section, you will learn how to create an AFP-ACIF data stream, i.e. an AFP data stream that
contains all the resources in a single file.
The objective is to create an AFP data stream that will contain all the resources (fonts, overlays and
images) required for printing.
The program will retrieve the AFP resources in the path specified in the « RESLIB » parameter of
mapping.conf.
Use the–mapnam parameter to specify the MapDraw format and –mapseq for the sequence number.
Note that you can specify a given sequence number (e.g. 00010) or all the sequences for a particular
format (« *ALL » or « *MRG »).
Each resource will be copied only once into the output file no matter how many times it will be used
(e.g. in several sequences).
The font resource files can end with an extension (.240 or .300) that will match the layout resolution
when they are generated. Note that you can specify a resolution in the map_acif command. If you
don’t, the program will pick the first available resource.
Creating an AFP file in Font Collection mode
To generate all resident fonts for AFP (Times New Roman, Courier, etc), it is required to delete all the
fonts from the list of AFP fonts in the Page Properties options first.
List of AFP fonts in MapDraw
Page 65 of 109
Chapter 12 – ACIF (AFP)
Generating the spool file in AFP
After designing the layout, generate an AFP file using the MAPCPYSPLF command:
On Unix
/apps/mapping/bin/mapcpysplf –mapnam:ACIF –mapseq:*MRG –lang:AFPDS
–infile:/tmp/MY_INPUT_FILE –outfile:/tmp/FILE.AFP
On Windows
“C:\Program Files\MappingWindows\Applications\mapcpysplf” “–mapnam:ACIF” “–mapseq:*MRG”
“–lang:AFPDS” “–infile:/tmp/MY_INPUT_FILE” “–outfile:/tmp/FILE.AFP”
Adding the AFP resources to create the ACIF file
To do this, run the map_acif command and specify the format name and MAPPING sequence:
On Unix
/apps/mapping/bin/map_acif –infile:/tmp/FILE.AFP –outfile:/tmp/ACIF.AFP –mapnam:ACIF
–mapseq:*MRG –mapres:300
On Windows
"C:\Program Files\MappingWindows\Applications\map_acif" “–infile:/tmp/FILE.AFP”
“–outfile:/tmp/ACIF.AFP” “–mapnam:ACIF” “–mapseq:*MRG” “–mapres:300”
Sending the file to business contacts
Use the following command to print the AFPDS data stream if you are using Infoprint Manager (or
other):
On Unix
pdpr -dibm32afp /tmp/ACIF.AFP
On Windows
"C:\Program Files\MappingWindows\Applications\map_lp" “–Dibm32afp” "C:\tmp\ACIF.AFP"
Caution!
Be sure to select binary mode when transferring the file via FTP (or any other
transfer method).
Page 66 of 109
Chapter 13 – DATAMAX downloadable fonts
How to install downloadable fonts for DATAMAX printers
This section shows how to add fonts for DATAMAX printers. This will apply to any DATAMAX printer
that supports downloadable fonts.
Steps
First, install the Windows DATAMAX printer driver. To know how to do that, see the printer manual.
To add fonts:
From the Start menu in Windows, choose Printers and Faxes
In the Printers and Faxes box, right-click on the newly added printer and choose Properties
In the Fonts tab, click on the Font drop-down menu and select Download Font…
Page 67 of 109
Then, select the Font and Style and choose the location where the font will be stored.
Upon clicking OK, you will be presented with the Font Properties at the bottom of the window.
Write down the internal font name under Location (here S50) so you can remember it.
Page 68 of 109
Then, open MapDraw. In the Tools menu, choose DATAMAX Fonts and then click New to add the
DATAMAX font name as specified in the Font Properties (S50).
To finish, close the project to refresh the fonts list and re-open it. You can now use the new font.
Page 69 of 109
Chapter 14 – DATAMAX DPL
How to design labels in the DATAMAX DPL language
The purpose of this section is to give indications on how to create labels meant to be printed on
thermal printers that support DPL (native language of DATAMAX printers).
Remapping
System i
To print MAPDRAW projects of DATAMAX type to a DATAMAX printer using the MAPCPYSPLF
command, you will need to declare the printer by setting the TYPELAN parameter to *DPL in the
« Define printer settings » menu (option 14 – 14 of the MAPPING menu).
Alternatively, you can also add the TYPELAN parameter in the MAPCPYSPLF command.
Unix / Linux / Windows
To print MAPDRAW projects of DATAMAX type to a DATAMAX printer, you will need to pass the –lang
parameter to the MAPCPYSPLF command and set it to DPL (-lang:DPL).
Generation mode
There are two possible generation modes:
SEND: The overlay is sent with each page.
MAPCPYSPLF parameters: SNDFDP=NO SNDPOL=YES
MACRO: The overlay is sent only once. This mode is recommended to reduce the print stream size.
MAPCPYSPLF parameters: SNDFDP=YES SNDPOL=NO
Page 70 of 109
Commands
Commands can be added at the start of the data stream by filling in the "Pre-Printing" field in the
project’s advanced options.
To do this, you will need to insert one of the two following control characters before each command:
<STX> or <SOH>.
If you wish to type more than one command, be sure to press Ctrl+Enter after each command to
insert a line break.
Example: <STX>O0300(Ctrl+Enter)<STX>M0500
DPL commands can also be added to the data stream using a zone of "COMMANDS" type.
In this case, there is no need to insert <STX> or <SOH> tags anymore because the system is running
in "Label Formatting Processor" mode rather than "System-Level Processor".
Fonts
Resident fonts
By default, there are 10 printer-resident fonts.
DATAMAX 9 is a proportional and therefore recommended font.
The other fonts are bitmap fonts, which means less than good quality.
There are also 2 proportional resident fonts called S00 and S01 (except for E-Class and M-4206). All
there is to do is declare them in the list of downloadable fonts.
Downloadable fonts
MAPDRAW will call fonts that have been downloaded to the printer beforehand.
To add a font, choose DATAMAX FONTS on the TOOLS menu (the list of fonts is stored in the
following file c:\Program Files\ MAPDRAW \DATAMAX.fnt).
Declare the fonts as follows: A04 to A72, S00 to S9z, U00 to U9z, and u00 to u9z.
Whenever the list of downloaded fonts is modified, you will need to close and reopen the project to
update the list of MAPDRAW fonts.
MAPDRAW does not handle fonts in the printer. You will need to use a DATAMAX tool (such as the
printer driver) to download the font to the printer.
Page 71 of 109
Page size
The page size specified here refers to the size of one label, not the whole sheet. By default, margins
are ignored (see "Advanced Properties").
If margins are enabled, only the Y margin will be taken into account.
Variable logos
Variable logos are supported only in MACRO mode (in SEND mode images are loaded after the
overlays, and as a result the <SOH>D tag causes a problem).
Barcodes
There is no need to select any particular font because bar codes are drawn by the printer.
This is why MAPDRAW only gives a rough preview.
The available settings are (right-click zone, Properties, Font and Style tab):
Font size (used to set the barcode’s height)
Advanced options:
Barcode width dropdown
Data printed under barcode checkbox
Page 72 of 109
Chapter 15 – ELTRON EPL
How to design labels in the ELTRON ETL language
The purpose of this document is to give indications on how to create labels meant to be printed on
thermal printers that support EPL II (native language of ELTRON printers).
Remapping
System i
To print MAPDRAW projects of ELTRON type to an ELTRON printer using the MAPCPYSPLF command,
you will need to declare the printer by setting the TYPELAN parameter to *EPL in the « Define printer
settings » menu (option 14 – 14 of the MAPPING menu).
Alternatively, you can also use the TYPELAN parameter in the MAPCPYSPLF command.
To print MAPDRAW projects of ELTRON type to an ELTRON printer, you will need to pass the –lang
parameter to the MAPCPYSPLF command and set it to EPL (-lang:EPL).
Commands
You can add commands at the start of the data stream by using the "Pre-Printing" field in the
Advanced options of the project.
Example:
D8 (Set Density)
Note that you will need to end each command with Ctrl+Enter.
In the project’s Advanced settings, you can specify the number of labels you wish to print before
cutting under "Cut Interval" (if set to 0, no cut).
Page 73 of 109
Chapter 15 – ELTRON EPL
Page size
The page size specified here refers to the labels, not the whole sheet.
To specify the spacing between each label, open the project’s Advanced options and fill in the "Label
Interval" field.
By default, margins will be ignored (see "Advanced Properties").
Barcodes
You will not need to select any particular font because bar codes will be drawn by the printer.
Font size (used to set the bar code’s height)
Advanced options:
Barcode width
Page 74 of 109
Chapter 16 – INTERMEC DIRECT PROTOCOL
How to design labels in the INTERMEC DIRECT PROTOCOL
language
The purpose of this section is to give indications on how to create labels meant to be printed on
thermal printers that support DIRECT PROTOCOL i.e. the native language of INTERMEC printers.
Remapping
System i
To print MAPDRAW projects of IPL type to an INTERMEC printer using the MAPCPYSPLF command,
you will need to declare the printer by setting the TYPELAN parameter to *IPL in the « Define printer
To print MAPDRAW projects of INTERMEC type to an INTERMEC printer, you will need to pass the –
lang parameter to the MAPCPYSPLF command and set it to IPL (-lang:IPL).
Text in Reverse Video mode
In the DRAW part of the template (Draw tab):
Set the text color to white. In that case, the size of the black rectangle will be proportional to the
number of characters drawn.
Alternatively, you can draw a black rectangle and then type white text on top of it (the text must lay
on top of the rectangle).
In the MAP part of the template (Map tab):
Either create a zone with the background set to white: In that case, the size of the black rectangle will
be proportional to the number of characters drawn.
Or draw a black rectangle and then add a white zone on top of it (in the summary the text zone must
be placed after the rectangle).
Page 75 of 109
Barcodes
You will not need to select any particular font because bar codes will be drawn by the printer.
Advanced options:
Barcode width
PARAMETER
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
WIDTH
1
1
2
2
3
3
4
4
5
5
6
6
7
7
8
RATIO(wide/narrow)
2.1
3.1
2.1
3.1
2.1
3.1
2.1
3.1
2.1
3.1
2.1
3.1
2.1
3.1
3.1
Page 76 of 109
Printer models
All INTERMEC printer models do not support the same print languages. To make it work with
MAPPING, the printers must support DIRECT PROTOCOL.
A few compatible models:
Easy Coder C4 : EPL
Easy Coder E4 : Direct Protocol
Easy Coder F4 : Direct Protocol - Finger Print (VB) - IPL
PS2i : Direct Protocol - Finger Print (VB) - IPL
PS4i (nouvelle F4) : Direct Protocol - Finger Print (VB) - IPL
PM4i : Direct Protocol - Finger Print (VB) - IPL
PX4i : Direct Protocol - Finger Print (VB) - IPL
PX6i : Direct Protocol - Finger Print (VB) - IPL
PS2Ci : Direct Protocol - Finger Print (VB) - IPL
PS4Ci : Direct Protocol - Finger Print (VB) - IPL
3240 : IPL
3400E 3400D : IPL
3600 : IPL
4420 : IPL
4440 : IPL
PC4i : IPL
Page 77 of 109
Chapter 17 – PRINTRONIX IGP
How to design labels in the PRINTRONIX IGP language
The purpose of this chapter is to give indications on how to create labels meant to be printed on
thermal or impact/dot-matrix printers that support IGP (native language of PRINTRONIX printers).
This mode is compatible with IBM, PRINTRONIX, or TALLY impact/dot-matrix printers that have an
IGP/PGL (Printronix Graphics Language) emulator.
Remapping
System i
To print MAPDRAW projects of PRINTRONIX type to a PRINTRONIX printer using the MAPCPYSPLF
command, you will need to declare the printer by setting the TYPELAN parameter to *IGP in the
« Define printer settings » menu (option 14 – 14 of the MAPPING menu).
To print MAPDRAW projects of PRINTRONIX type to a PRINTRONIX printer, you must pass the –lang:
parameter to the MAPCPYSPLF command and set it to IGP (-lang:IGP).
Unicode mode
This mode has been tested on a matrix « Infoprint 6500 » and a thermal « Infoprint 6700 ».
In the printer control panel, « Expanded Font » must be set to « Scalable ».
Page 78 of 109
Commands
Commands can be added at the start of the data stream by using the "Pre-Printing" field in the
advanced options of the project.
For example: ^PQ5 (will print the label 5 times)
You can also add commands to the data stream by using a zone of "COMMANDS" type.
Example: Let’s assume that you wish to print the same label n times and that the value n can be
found in the spool file.
To do this, design a "COMMMANDS" zone to retrieve the number of times the label shall print from
the spool file and type ^PQ under Pre-Printing.
Example: To use a font that has both a specific width and height:
Pre-Printing: ^F015,840Â0N,200,100^FD Post-Printing: ^FS
Fonts
With the non-Unicode version of Mapping, the number of fonts is limited to 1 (Letter Gothic) on dotmatrix/impact printers. With the Unicode version however, restrictions disappear.
To improve the quality of the print preview, it is recommended to install the following fonts:
- "Letter Gothic" for dot-matrix printers
- "Letter Gothic" and "CG Triumvirate" for thermal printers
Resolution
On dot-matrix printers, it is recommended to select 72 dpi.
On dot-matrix printers, the resolution of images is 72/60 dpi.
There are 2 methods here:
- You can either draw a zone and set the text color to white (DRAW and MAP).
- Or design a black rectangle in the overlay. Anything that prints over it will be printed in Reverse
Video.
Barcodes
You do not need to select any particular font because bar codes are drawn by the printer.
font size (used to set the bar code’s height)
Advanced settings:
Bar code width
Labelled bar code checkbox
Page 79 of 109
The bar code width will vary with the type of printer and barcode orientation.
One particular IGP code is associated with each bar code width value in MAPDRAW. Please see the
printer manual to find out which code you need.
However, there isn’t always a code for each and every type of bar code.
MAPDRAW PARAMETER - IGP CODE (1D bar code)
1
X1A
2
X1
3
4
5
6
7
8
9
10
11
12
13
14
15
X1B
X1E
X1.5
X2
X2A
X2B
X2E
X3
X3A
X3E
X4
X4A
X4E
In the IGP language, the print start point of bar code zones is different from the print start point of
text zones. So the bar code preview is not correct.
The top left point of the bar code (without rotation and 90° rotation) is the top left point of the bar
code zone (see below).
Below is the result compared to the MapDraw zones.
Page 80 of 109
Special Function Control Code (SFCC)
The SFCC control character can be edited in the project’s Advanced Settings.
It is either 0x7E (126) or 0x5E (94).
Download overlay
You can download overlays to the printer before printing provided this is supported by the printer
(download to Flash memory).
To do this, check the "Download resources" box in the project’s Advanced Settings. This way, the
generated overlay will be sent to the printer’s Flash memory. Then, all you need to do is send it to the
printer via LPR.
RFID
RFID code is inserted using a command zone in the "Insert IGP" tab. In this tab users can create RFID
code manually and add Pre-printing and Post-Printing characters around the data retrieved from the
spooled file.
The buttons NewLine>>, ~>>, CREATE>>, ALPHA>>, and STOP>> allow you to respectively
add line breaks, tildes, and the CREATE, ALPHA and STOP commands.
RFID code is inserted using the RFWTAG>> button, which adds the following syntax first under the
Pre-printing field:
RFWTAG[;LOCKn[;format]];size[;mem bank]
length;[DFn;]format;(D)
and then in the Post-printing field:
(D)
Page 81 of 109
STOP
One can then select customized settings.
The parameters in square brackets are optional.
LOCKn[;format]: Optional parameter used to lock the data block to prevent it from being overwritten.
By default, the data is not locked initially. n is the passcode. The acceptable values for n are X'1' to
X'FFFFFFFF' in hex, a 4-byte data string. When the LOCKn option is used to lock any memory bank,
which at the same time is programmed with the write data, the same passcode will be written on ACS
memory bank. The ACS memory bank will also be locked if ACS is not locked at the time of the
operation. If ACS is already locked at the time of the operation, the passcode needs to match the
current content of ACS so that the memory bank lock takes effect. The passcode (n) can also be
written in dynamic format. To enable dynamic format, enter LOCK<DFn>, where DFn is the dynamic
field defined in EXECUTE mode. format is an optional parameter to specify the format for the
passcode data. Enter B for binary, D for decimal, and H for hexadecimal. The default is decimal if
format is not specified.
Size: A decimal number specifying the overall bit length of RFID tags. mem bank specifies which tag
logical memory area this command will apply to. If omitted, it defaults to the EPC memory area. Other
areas include Identification, User Data, Access area and Kill area. Enter one of the following values:
'EPC' - EPC 12 bytes data area (default) 'TID' - Tag identification 8 bytes area (currently not
applicable for RFWTAG) 'USR' - User 32 bytes area 'ACS' - 4 bytes access code area 'KIL' - 4 bytes
kill code area.
Length: A decimal number specifying the bit length of a field within a tag. The maximum length for
each DFn field is 64 bits for binary or decimal format. For hexadecimal format, the bit length can be
up to the maximum bit length specified for the corresponding memory bank.
DFn: Optional parameter to indicate that this field has dynamic data. Replace n with a number
ranging from 1 to 512 to identify the field number of this particular field. If this option is used, the
data field (data retrieved from the spool file) is ignored, and dynamic data must be entered via the DF
command in the EXECUTE mode.
Format: A letter specifying the format of the data field. B - binary, D - decimal, H - hexadecimal (D)
Delimiter designating the start and end of static data for this bit field. Replace (D) with any printable
character, except the SFCC and the slash character (/).
Page 82 of 109
Chapter 18 – TEC
How to design labels in the TEC language
The purpose of this chapter is to give indications on how to design labels meant to be printed on
thermal printers that support the TEC language.
Remapping
System i
To print MAPDRAW projects of TEC type to a TEC printer using the MAPCPYSPLF command, you will
need to declare the printer by setting the TYPELAN parameter to *TEC in the « Define printer
To print MAPDRAW projects of TEC type to a TEC printer, you will need to pass the –lang parameter
to the MAPCPYSPLF command and set it to TEC (-lang:TEC).
Advanced properties
In the project’s advanced properties, extra settings can be defined for your labels.
Label interval
Use this parameter to set the spacing between 2 labels. The unit of measurement used to set this
parameter is the one selected in the Preferences of the MAPDRAW project.
Page 83 of 109
Speed
Print speed
75.5 mm/sec
101.6 mm/sec
125.0 mm/sec
152.4 mm/sec
203.2 mm/sec
254.0 mm/sec
B-372
3
5
8
-
Chapter 18 – TEC
B-472
3
6
A
B-572
3
5
8
-
B-672
3
4
8
-
B-872
3
4
8
-
Cell type
0 NONE (without detection)
1 REFLECTIVE (black mark)
2 TRANSMISSIVE (holes or slits)
3 TRANSMISSIVE (holes or slits with preprint)
4 REFLECTIVE (black mark with manual setting)
Copies
Number of labels to be printed
Mode
C: Batch mode (cut issue, stop and cut, with back feed)(Continuous)
D: Strip mode (with back feed) (Pre-stripping)
E: Strip mode (with back feed, the strip sensor is ignored, the applicator supports this mode.)(Prestripoff w/o Label sensor cell (utiliser pour automates).)
Cut interval
Number of labels to be printed before cutting
Eject last label
If the Cutter feature is enabled, this command allows you to eject the last printed label if it has not
been cut.
Print mode
0 None=w/o film (thermal direct)
1 With(Save)=with film (saver on)
2 With(No Save)=with film (saver off)
Commands
Commands can be added at the start of the print stream. To do this, type the commands in the "Preprinting" field in the project's Advanced settings.
Example: Warm-up command {AY;abb,c¦}
a: increases or decreases the temperature
+ warmer (darker), - colder (lighter).
bb: temperature value range 00 to 10.
c: operating mode 0: Thermal transfer 1: Thermal direct
Example: To shift the printing 100 mm upwards.
{AX;-100,+000,-00|}
Page 84 of 109
Chapter 18 – TEC
Page size
The page size specified here refers to the labels, not the whole sheet.
To specify the spacing between each label, open the project’s Advanced options and fill in the "Label
Interval" field.
By default, margins will be ignored (see "Advanced Properties").
Commands
You can also add TEC commands to the data stream by using a zone of "COMMANDS" type.
PRE-PRINTING :
POST-PRINTING :
{PC004;0347,0348,15,15,Q,00,B=
|}
RESULT :
{PC004;0347,0348,15,15,Q,00,B=SPOOLDATA|}
Fonts
Resident fonts
There are 10 printer-resident fonts.
Arial (TTF) and Times New Roman (TTR) both are proportional and therefore recommended fonts.
Other fonts are Bitmap fonts, which means less than good quality.
Downloadable fonts
MAPDRAW allows calling fonts that have been downloaded to the printer beforehand.
To add a font, click TEC FONTS from the TOOLS menu (this list of fonts is saved in the following file
c:\Program Files\ MAPDRAW \TEC.fnt).
You will need to declare the fonts as "ff,g" (for example 02,1) with:
ff: Type of true type font
- 01 BalloonP Extra Bold
- 02 BlacklightD
- 03 BrushScrD
- ...
Page 85 of 109
Chapter 18 – TEC
g: Font location
- 0: motherboard flash memory
- 1: first PCMCIA port flash memory
- 2: second PCMCIA port flash memory
Whenever the list of downloaded fonts is modified, you will need to close and reopen the project to
update the list of MAPDRAW fonts.
MAPDRAW does not handle fonts in the printer. You will need to use a ZEBRA tool (such as the printer
driver) to download the font to the printer.
Text in Reverse Video
To print white text over a black background, set the text color to white.
Barcodes
You do not need to select any particular font because barcodes are drawn by the printer.
Advanced options:
Barcode width
Page 86 of 109
Chapter 19 – ZEBRA ZPL II
How to design labels in the ZEBRA ZPL II language
The purpose of this document is to give indications on how to create labels meant to be printed on
thermal printers that support ZPL II (i.e. the native language of ZEBRA printers).
Remapping
On the system i
To print MAPDRAW projects of ZEBRA type to a ZEBRA printer using the MAPCPYSPLF command, you
will need to declare the printer by setting the TYPELAN parameter to *ZEBRA in the « Define printer
Alternatively, you can also set the TYPELAN parameter in the MAPCPYSPLF command.
On Unix / Linux / Windows
To print MAPDRAW projects of ZEBRA type to a ZEBRA printer, you must pass the –lang parameter to
the MAPCPYSPLF command and set it to ZEBRA (-lang:ZEBRA).
Page 87 of 109
Commands
Commands can be added at the start of the data stream in the Pre-Printing field in the project’s
Advanced Properties. Example: ^PQ5 (will print the label 5 times)
You can also add ZPL commands to the data stream by using a zone of "COMMANDS" type.
Example 1: Let’s assume that you wish to print the same label n times and that the value n can be
found in the spool file. To do this, design a "COMMMANDS" zone to retrieve the number of times the
label shall print from the spool file and type ^PQ under Pre-Printing.
Example 2: To use a font that has both a specific width and height:
In Pre-Printing: ^F015,840Â0N,200,100^FD In Post-Printing: ^FS
Example 3: To display a text box (centered, justified, aligned to the left or to the right) on multiple
lines with automatic line break.
Insert the following in the Pre-printing field: ^FB « width », « number of lines »,0, « alignment »
Where
width: text width (in printer units, depends on the print resolution)
number of lines: maximum number of lines
alignment: L (left), R (right), C (center) or J (justified)
Example: ^FB200,3,0,C
The command zone must be placed right before the text box in question in the summary.
Page 88 of 109
Fonts
Resident fonts
By default, there are 8 printer-resident fonts.
ZEBRA 0 (Arial) is the only recommended proportional font (bold).
The other fonts are bitmap fonts, which means less than good quality.
The OCR A font will only print uppercase characters.
Downloadable fonts
MAPDRAW can call the fonts that have been downloaded to the printer beforehand.
To add a font, choose ZEBRA FONTS on the TOOLS menu (the list of fonts is stored in the following
file c:\Program Files\ MAPDRAW \ZEBRA.fnt).
Example: R:ARIAL
(Arial font downloaded to DRAM)
The first letter refers to the place where the font is stored in the printer memory.
R: Printer DRAM library (read/write)
B: Optional memory (a card or factory installed)
E: Flash memory (read/write)
Z: internal ZPL II stored object library (read only)
Whenever you modify the list of downloaded fonts, you will need to close and then reopen the project
to update the list of MAPDRAW fonts.
MAPDRAW does not handle fonts in the printer. You will need to use a ZEBRA tool (such as the printer
driver) to download the font to the printer.
Design a black rectangle and then set the text color to white. The text must be placed on top of the
rectangle (works both in the MAP and DRAW tabs).
To apply Reverse Video to the whole label, design the template without any Reverse zone and then
type the following command "^LRY^FO0,0^GB800,0,800^FS" in the Pre-Printing field in the
project’s Advanced Properties. This will reverse the whole label (black background).
Page 89 of 109
Barcodes
You will not need to select any particular font because bar codes are drawn by the printer.
Font size (to set the bar code’s height)
Advanced settings:
Barcode width
PARAMETER
1
2
3
4
5
6
7
8
9
10
11
12
13
14
-
WIDTH
1
2
3
3
4
4
5
5
6
6
7
8
9
10
-
RATIO (wide/narrow)
3.0
3.0
2.5
3.0
2.5
3.0
2.5
3.0
2.5
3.0
3.0
3.0
3.0
3.0
Page 90 of 109
RFID
RFID code is inserted using a command zone in the “Insert ZEBRA” tab (click on the Commands icon
on the left-hand side toolbar). In this tab RFID code can be added manually and you will need to add
Pre-printing and Post-Printing characters around the data retrieved from the spooled file.
The buttons ^>>, FIELD DATA>>, FIELD SEPARATOR>>, FIELD ORIGIN>>, FONT>>, and
PRINT QUANTITY>> allow you to respectively insert the ^ character, and the ^FD, ^FS, ^FO,
Â0N,33 and ^PQ commands.
RFID code can also be created automatically using the following dialog box (click the Write RFID
button in the Insert ZEBRA tab):
This dialog box offers two writing methods:
- RFw: New standard for writing RFID code
- WT: Previous mode, for use with old ZEBRA printers.
Page 91 of 109
Data format
- ASCII: To write ASCII data. The data taken from the spooled file must be of ASCII type.
- Hexadecimal: To write hexadecimal data. The data taken from the spooled file must be of
hexadecimal type.
- EPC (Electronic Product Code): The EPC format is composed of several fields of different sizes
each (size expressed in bits). The data retrieved from the spooled file must be commadelimited data.
EPC Data Structure
Users define the number of fields as well as the size for each field in bits (1 to 64 bits).
RFID Setup
This option allows you to select various configuration settings e.g. the « tag type ». Not all the listed
« tag types » are supported by all printers. If you select a « tag type » that isn’t supported by your
printer, the printer will use the default value.
Enable RFID motion
This command enables or disables RFID motion. By default, labels automatically print at the end of
the format. This command allows you to inhibit the label from actually moving when it reaches the
program position, which is useful for debugging, setup, and custom applications. This parameter is
not persistent (carried over form label to label).
Write protected (only supported with the old writing method)
Used to protect the writing.
Verify Valid Data
If write verify is enabled, this command verifies the RFID write operation to ensure that the tag about
to be programmed contains the hex data “A5A5” in the first two bytes. This parameter is not
persistent (carried over from label to label).
Number of retries
This command changes the number of times the printer attempts to write to a particular block of a
single RFID tag. By default, the printer will attempt six retries. This command is persistent and will be
used in subsequent formats if not provided.
After validation, the RFID code will be added into the Pre- and Post-Printing fields.
Page 92 of 109
Chapter 20 – RFID
How to encode RFID chips
General principle
To encode an RFID chip or tag in MapDraw, you will first need to design RFID zones:
First, insert a zone of RFID type. This is recommended in the case of chips complying with
the EPC standard.
Alternatively, you can also insert a zone of Commands type. This will allow you to enter the
commands manually and in particular, to encode any type of alphanumerical data. However,
you will need to know the commands required to encode the chip as they vary according to
each print language.
RFID zones
This type of zone is used to encode an EPC – Electronic Product Code – in an RFID tag. The EPC is a
unique identifier used to identify different items in the production chain. The current standards include
3 formats: 64, 96 or 125 bits.
Sample EPC format: 01 – 0 000 ABC – 000 16F – 000 269 DC0
01: Header referring to the encoding standard
0 000 ABC: Company producing the EPC
000 16F: Product code leaving the company
000 269 DC0: Product serial number
To encode an EPC in MapDraw:
- Design a zone of RFID type
- Select the type of information you wish to encode in the « Type » and « Filter Value » fields.
- Select the type of partition. This is used to set the length of each field that will be encoded
(e.g. number of bytes for « Company Prefix » and « Item Reference »). See the EPC standard
specifications for matching references.
- Fill in the different fields as shown on the screen capture below. Alternatively, you may also
use Memory zones.
Page 93 of 109
Chapter 20 – RFID
The available encoding standards are the ones supported in version 1.3 of the EPC standard:
GID-96 : General Identifier (GID)
SGTIN-96 SGTIN-198 : a serialized version of the GS1 Global Trade Item Number (GTIN)
SSCC-96 : GS1 Serial Shipping Container Code (SSCC)
SGLN-96 SGLN-195 : GS1 Global Location Number (GLN)
GRAI-96 GRAI-170 : GS1 Global Returnable Asset Identifier (GRAI)
GIAI-96 GIAI-202 : GS1 Global Individual Asset Identifier (GIAI)
DoD-96 : DOD Construct
Select
-
“DEFINE” under Type to declare the encoding structure manually:
Total number of bits.
Total number of fields.
Size of each field.
Content of each field.
Command zones
To insert a Command zone, make sure the Map tab is selected and then click on the Commands icon
in the left-hand side toolbar. This type of zone is used to create RFID zones manually by entering
the required commands to encode the RFID tag. These commands are specific to each type of
printer.
ZEBRA language
RFID code is inserted using a command zone in the “Insert ZEBRA” tab (see screen capture below). In
this tab, users can create RFID code manually and add Pre-printing and Post-Printing characters
around the data retrieved from the spooled file.
The “ ^>>”, “ FIELD DATA>> ”, “ FIELD SEPARATOR>>”, “ FIELD ORIGIN>>”, “FONT>>” and
“PRINT QUANTITY>>” buttons are used to respectively insert the « ^ » character, and the « ^FD »,
« ^FS », « ^FO », « Â0N,33 » and « ^PQ » commands.
Page 94 of 109
Chapter 20 – RFID
RFID code can also be added automatically in the following dialog box (click « Write RFID » from the
« Insert ZEBRA » tab):
There are two available writing methods:
- RFw: New standard for RFID code
- WT: Previous mode, for use with old ZEBRA printers
Data format:
- ASCII: To write ASCII data. The data taken from the spooled file must be of ASCII type.
- Hexadecimal: To write hexadecimal data. The data taken from the spooled file must be of
hexadecimal type.
- EPC (Electronic Product Code): The EPC format is composed of several fields of different sizes
each (size expressed in bits). The data retrieved from the spooled file must be delimited by
commas.
EPC Data Structure:
The user can define the number of fields as well as the size of each field (1 to 64 bits).
RFID Setup:
This option allows the user to select various configuration settings e.g. the « tag type ». Not all the
listed « tag types » are supported by all printers. If you select a « tag type » that isn’t supported by
your printer, the printer will use the default value.
Enable RFID motion:
This command enables or disables RFID motion. By default, labels automatically print at the end of
the format. This command allows you to inhibit the label from actually moving when it reaches the
program position, which is useful for debugging, setup, and custom applications. This parameter is
not persistent (carried over form label to label).
Write protected: (only available in WT mode)
Enables you to protect the writing.
Verify Valid Data:
If « write verify » is enabled, this command verifies the RFID write operation to ensure that the tag
about to be programmed contains the hex data “A5A5” in the first two bytes. This parameter is not
persistent (carried over from label to label).
Page 95 of 109
Chapter 20 – RFID
Number of retries:
This command changes the number of times the printer attempts to write to a particular block of a
single RFID tag. By default, the printer will attempt six retries. This command is persistent and will be
used in subsequent formats if not provided.
Click OK to add the code in the Pre- and Post-printing fields.
IGP language
RFID code is inserted using a command zone in the “Insert IGP” tab. In this tab, users can create
RFID code manually and add Pre-printing and Post-Printing characters around the data retrieved from
the spooled file.
The buttons NewLine>>, ~>>, CREATE>>, ALPHA>>, and STOP>> allow the user to
respectively add line breaks, the character « ~ », and the commands « CREATE », « ALPHA» and
« STOP ».
RFID code is inserted using the RFWTAG>> button, which adds the following syntax first under the
Pre-printing field:
RFWTAG[;LOCKn[;format]];size[;mem bank]
length;[DFn;]format;(D)
and then in the Post-printing field:
(D)
STOP
The user can then select customized settings.
The parameters in square brackets are optional.
LOCKn[;format]: Optional parameter to lock the data block to prevent it from being overwritten. By
default, the data is not locked initially. n is the passcode. The acceptable values for n are X'1' to
X'FFFFFFFF' in hex, a 4-byte data string. When the LOCKn option is used to lock any memory bank,
which at the same time is programmed with write data, the same passcode will be written on ACS
memory bank. The ACS memory bank will also be locked if ACS is not locked at the time of the
Page 96 of 109
Chapter 20 – RFID
operation. If ACS is already locked at the time of the operation, the passcode must match the current
content of ACS so that the memory bank lock takes effect. The passcode (n) can also be of dynamic
format. In dynamic format, enter LOCK<DFn>, where DFn is the dynamic field defined in EXECUTE
mode. format is an optional parameter to specify the format for the passcode data. Enter B for binary,
D for decimal, and H for hexadecimal. The default is decimal if format is not specified.
Size: A decimal number specifying the overall bit length of the RFID tag. mem bank specifies the tag
logical memory area to which this command will be applied. If omitted, it defaults to the EPC memory
area. Other areas include Identification, User Data, Access area and Kill area. Enter one of the
following values: 'EPC' - EPC 12-byte data area (default) 'TID' - Tag identification 8-byte area
(currently not applicable for RFWTAG) 'USR' - User 32-byte area 'ACS' – 4-byte access code area
'KIL' – 4-byte kill code area.
Length: A decimal number specifying the bit length of a field within a tag. The maximum length for
each DFn field is 64 bits for binary or decimal format. In hexadecimal format, the bit length can be up
to the maximum bit length specified for the corresponding memory bank.
DFn: Optional parameter to specify that this field has dynamic data. Replace n with a number ranging
from 1 to 512 to identify the field number of this particular field. If this option is used, the data field
(data retrieved from the spooled file) is ignored, and dynamic data must be entered via the DF
command in EXECUTE mode.
Format: A letter specifying the format of the data field. B - binary, D - decimal, H - hexadecimal (D)
Delimiter designating the start and end of static data for this bit field. Replace (D) with any printable
character, except SFCC and forward slash (/).
Page 97 of 109
Chapter 21 – CreateImage
How to process image files automatically
In this section, you will learn how to use the CreateImage program to convert .BMP, .JPG or .TIF files
to PCL, AFP or ZPL (Zebra) formats. The mapcpysplf command will then use the image zones to
process the PCL, AFP or ZPL files. The name of the PCL, AFP or ZPL file must be exactly the same
(watch for the case!) as the value retrieved from the image zone. The objective is to automate the file
creation process using a DOS command.
This is supported in Mapping iSeries, UNIX and Windows all versions.
On the PC, map a network drive to the system i disk to access the IFS (e.g. F:\mapping\).
The source files must be of .BMP, .JPG or .TIF type.
Program interface
The CreateImage.exe application is stored in the folder where MapDraw is installed. Launch the
application and click on Settings to configure the source and destination folders as shown in the
screen capture below – here for an iSeries config:
Page 98 of 109
The main program interface looks as follows:
Page 99 of 109
In the MapDraw template, design a zone of type Tools / Image to retrieve the desired image.
For example, with CreateImage it is possible to convert an image called Lille.bmp to Lille.pcl.
Then, in the spool file, map the value « Lille » with a Tools / Image zone and the program will look for
the PCL image « Lille » in the lgobitmap folder.
More about CreateImage
To learn more about how to use the CreateImage program, open the MapDraw online
help at CreateImage and Image zones.
Page 100 of 109
This is a preview of the template in MapDraw showing the image in question:
Page 101 of 109
Running the mapcpysplf command on iSeries:
Page 102 of 109
Creating the page segment on the fly on iSeries when the mapcpysplf command is run (AFP):
Page 103 of 109
Command syntax
To view the command syntax, right-click anywhere in the title bar of the CreateImage window.
Choose “About CreateImage” to display the following information:
To process the command, copy it in a .BAT file or use a remote command. Here are the different
parameters for the CreateImage command:
-ImageIn
-ImageOut
-FolderIn
-FolderOut
source file name and extension
destination file name without extension
source directory
image destination directory
-DPI
resolution (depends on the language)
mylogo.bmp
mylogo
C:\images\
F:\mapping\lgobitmap\
where F: is mapped to the AS400 home directory
0
in PCL : 0= 300 dpi , 1 = 600 dpi
in ZEBRA : 0=152 dpi , 1 = 203 dpi , 2 = 300 dpi
in AFP : 0 = 240 dpi , 1 = 300dpi
-KeepSize
to keep or change the original file size
1
0 = same size ; 1 = new size
-KeepProportion
to keep or change the original file proportions
3
0 = same proportions ;
1 = define new width (X) only
2 = define new height (Y) only
3 = define new width and height (X and Y)
-Color
Colour processing
0
-Xsize
image width in dots (if –KeepSize=1)
300 dots = 1 inch = 2,54 cm
image height in dots (if –KeepSize=1)
300 points = 1 inch = 2,54 cm
Processing language
0 or PCL = PCL
1 or ZEBRA = ZEBRA
2 or AFPDS = AFP
0 = No FTP, 1 = Use FTP
0 = No (black and white) ; 1 = Yes (colour)
-Ysize
-Lang
-FtpUse
Page 104 of 109
300
300
PCL
0
-FtpFolder
-FtpLogin
-FtpPassword
-FtpIPAddress
FTP folder
FTP Login
FTP password
Server IP address
Example 1 (image generated in PCL, same size, black and white):
C:\Program Files\MapDraw\createimage “-ImageIn:graph.jpg” “-ImageOut:1243” “FolderIn:c:\tmp\canon\” “-FolderOut:F:\mapping\lgobitmap” “-DPI:0” “-KeepSize:0” “KeepProportion:0” “-Color:0” “-Lang:PCL”
Only parameter "-ImageIn" is compulsory, others parameters may be registry values.
If parameter "-ImageOut" is not set, the created file will have the name of the "-ImageIn" file with a
different extension.
Example 2 (CreateImage with default registry values):
CreateImage "-ImageIn:graph.jpg"
Command syntax
The double quotes are mandatory around each parameter.
If a file with the exact same name already exists in the destination folder, it will be overwritten.
Pay attention to how much time is needed to create the file in the IFS. Make sure the PCL or ZPL file
is created before running themapcpysplf command!
In a Mapping remote command (MAPRMTCMD), enter « lock:// » before the createimage command:
MAPRMTCMD CMD (« lock://c:\program files\mapdraw\createimage.exe …. »)
Page 105 of 109
Batch mode
To automate the use of CreateImage for all the image files in a specific folder, you will need to create
a .BAT file using the following commands:
///////////////////////////////////////////////////////////////////////////////////////
@ECHO OFF
REM This script automates the execution of CreateImage for all the BMP files in a given folder.
REM In this example the parameters ImageOut, FolderIn, FolderOut, KeepSize, and Lang ... are the
default ones.
REM The folder below must be the same as the source directory in CreateImage.exe Preferences
cd "C:\Program Files\MappingWindows\import\lgobitmap\"
FOR %%c in (*.bmp) DO (
REM echo "C:\Program files\MapDraw\CreateImage.exe" "-ImageIn:%%c"
"C:\Program files\MapDraw\CreateImage.exe" "-ImageIn:%%c"
)
///////////////////////////////////////////////////////////////////////////////////////
Page 106 of 109
AFP
In AFP, the name of the resource file must be 8 characters long, the first three characters are always
« S1X » and these are added automatically by MAPPING.
The MapDraw Tools / Image zone must be 5 characters long (Alpha or Numerical).
iSeries:
The file resource created with CreateImage (.afp file) must be copied in the IFS folder “lgobitmap”.
Upon running the MAPCPYSPLF command, an iSeries resource PageSegment will be created
automatically using this file. If this resource already exists in the iSeries, it will not be replaced by the
.afp file from the « lgobitmap » folder.
Unix/Windows:
The resource created with CreateImage (.afp file) must be copied in the Infoprint Manager resource
folder (/usr/lpp/psf/reslib or C:\Program Files\IBM\Infoprint Manager\reslib). This file must have no
extension (no .afp).
Page 107 of 109
Chapter 22 – Embedded PDF fonts
List of embedded fonts in PDF projects
This chapter shows how to choose the fonts that must be embedded when creating PDF projects with
MapDraw (this feature is supported in the Unicode version only).
The steps described in this section have been successfully tested with MapDraw 6.11.0.4 and
MAPPING iSeries 6.0.1.18
Choosing the embedded PDF fonts
Open MapDraw. In File > Preferences, you can now choose between 2 options under Code Page:
•
•
Do not embed fonts in PDF Files
Use the list of PDF fonts
If Use the list of PDF fonts is checked, the list of fonts will be created in a file named
MapFontPDF.txt and located in MapDraw’s installation folder.
The file can be updated in the interface in the Tools menu > PDF Fonts.
Alternatively, other fonts can also be added manually by editing the file in a text editor. The fonts
must be separated with line breaks.
Page 108 of 109
Chapter 22 – Embedded PDF fonts
In the properties of the generated PDF document (in this example), notice that the Comics and BC39L
fonts were embedded.
Page 109 of 109

MAPDRAW – TECHNICAL REFERENCE GUIDE

Transcription

Similar documents

Prismacolor Nupastel Color Chart •www.hyatts.com •(800

by Mary Theresa Rose Wahlmeier

Ejercicios

Mousekeeping Tip Envelopes

Quick Start Guide

Thermal Printer EP / FP-700

Halloween Party Invitations

MAC OS 10.5.2 includes Drivers for Zebra Thermal Printers How to