Command file: xml file – QuickLabel Designer Pro User Manual
Page 182
- 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.