Command file: xml file – QuickLabel Designer Pro User Manual

Page 182

Advertising
background image

- 182 -

The order or appearance of the columns in the CSV file is no important.   But it is important that all 
rows in the same CSV file have the same structure.

Session print is used automatically. Session printing is disabled when   you change the printer or label 
within the same CSV file.

All columns in the CSV file are used when setting the values to the   label variables. If the variable 
with the name from CSV does not exist   on the label, no error message is displayed.

 

Command File: XML File

The commands available in the XML command files are a subset from NiceCommands.   You can use 
the following commands: Login, Quit, Label, LabelClose, Set,   Port, Printer, SessionEnd, Ses-
sionStart, SessionPrint, SetDatabase and   SetTable. Of course, the syntax of the commands differs a 
little bit when   used in XML file.

The root element is Nice_Commands   that must be present in the XML command file. The next ele-
ment that must   follow is Label, that specifies   which label to use. Next you have two options for 
label printing:

 1.  Print labels normally using the element Print_Job.
 2.  Print labels in session using the element Session_Print_Job.

You can also change the printer to which the labels will print, you   can set the variable value and you 
can change the database that is currently   used on the label.

 

XML Command File Structure Explained

Below is the description of the command file structure. There are several   elements that contain attrib-
utes. Some attributes are required, other   are optional. Some attributes can occupy pre-defined values 
only, for   other you can specify the custom values.

Nice_Commands: Is root element   with two attributes

 

l

login

: Performs   login procedure into the program. Not required.

 

l

quit

: Closes   the print engine when the actions execute. Will remove the print engine   from 

the memory. Is required.

Label: The element that opens   the label in the print engine. If the label is already opened, it will   be 
re-used. You can use this element several times within the command   file.

 

l

name

: Attribute   contains the label name. It is recommended to include label path and file-

name.   Note: You can provide label name only, but be sure that print engine will   try 
locate the label in the correct folder. Is required.

 

l

close

: The   attribute instructs the print engine, if the label should close after   printing, or it 

should remain open. Possible values: true, false. Is required.

Print_Job: The element that   unions the commands for printing labels. You can use this element sev-
eral   times within the command file.

 

l

printer

:   Use this attribute to override the printer defined on the label. Print   the label to 

some other printer. The other printer must be accessible   from this computer. Use the 
printer name for value of this attribute.   Not required.

 

l

quantity

:   Use this attribute to specify the number of labels to print. Possible   values: 

numeric value, VARIABLE or UNLIMITED. Required.

Advertising