Barcode Printer Command Template Placeholders

These notes currently apply to GODEX printers.

Placeholders are used for barcode printing with command templates and reference substituted values. When a barcode is printed with a command template, the template is searched for commands that may include the placeholders listed below as parameters. If a parameter is an exact match then it is replaced by the value for the placeholder. If the placeholder is unused, or is not set up to be swapped for any data, then the line with the command is removed before it is sent to the printer. The available placeholders will depending on the item or document being printed.

Printer commands checked for Placeholders

Description	Syntax	Notes
Printer Text	`At,x,y,x_mul,y_mul,gap,rotationInverse,data`	Unformatted text
1D Barcode	`Bt,x,y,narrow,wide,height,rotation,readable,data`	Includes Code39 and Code128
QR Code	`Wx,y,mode,type,ec,mask,mul,len,roatae<CR>data`	`len` must be the length of the placeholder. Data starts at new line

Valid Placeholders

Placeholder	Alternative Placeholders	Description	Used In
`BAR1`		Barcode	All
`BAR2`			Not used
`DESCR1`	`DESC1`	Short Description	All
`DESCR2`	`DESC2`	Long Description	All
`CAT1`		Category	Not used
`LBL1`		Label	Inventory
`REF1`		Reference	All
`PDATE1`		Purchase Date	Assets
`JOB1`	`JOBNO1`	Job Number	All
`VER1`		Version	Not used
`ORDER1`	`ORDNO1`	Order Number	[TBC]
`CUST1`		Customer Name	[TBC]
`DOC-DESC1`	`F-DESCR1`	Document Description	[TBC]
`DOC-REF1`	`F-REF1`	Document Reference	[TBC]
`DOC-JOBNO1`	`F-JOB1`	Document Job	[TBC]
`ADDR1`		Address Line 1	[TBC]
`ADDR2`		Address Line 2	[TBC]
`ADDR3`		Address Line 3	[TBC]
`ADDR4`		Address Line 4	[TBC]
`POST1`		Postcode	[TBC]
`WEIGHT1`	`WGT1`	Weight in units	Inventory
`SELLEX1`	`SELLEXCL1` `SELL-EXCL1`	Selling Price Excluding	Inventory
`SELLINC1`	`SELLINCL1` `SELL-INCL1`	Selling Price Including	Inventory
`ACCESSORIES_GRID1`¹	`ACC_GRID1` `ACC_GRID(CODE,DESCR,QTY)`	Accessories Grid Type 1 Columns: Code, Description, Qty	Inventory
`ACCESSORIES_GRID2`¹	`ACC_GRID2` `ACC_GRID(DESCR,QTY)`	Accessories Grid Type 2 Columns: Description, Qty	Inventory
`ACCESSORIES_GRID3`¹	`ACC_GRID3` `ACC_GRID(QTY,DESCR)`	Accessories Grid Type 3 Columns: Qty, Description	Inventory
`ACC_CODE_0N`²		Accessories Grid Code Row N	Inventory
`ACC_DESCR_0N`²		Accessories Grid Description Row N	Inventory
`ACC_QTY_0N`²		Accessories Grid Quantity Description Row N	Inventory
`ACC_REF_0N`²		Accessories Grid Line Reference Row N	Inventory

Notes

Sizing and layout can be determined by a sequence of table graphic commands directly following the command containing the placeholder. The size of the font in the table will be the size of the placeholder font. See the section Accessory Grid Printing for more details about Accessory Grid Printing.
Placeholders for column values of the Accessories grid can be set in the template instead of setting ACCESORIES_GRID. The N is replaced with a number referencing the row in the grid, for instance ACC_CODE_01 references the Code value in first row.

Accessory Grid Printing

To include a table with accessory data for an inventory item a placeholder that begins ACCESORIES_GRID is used or one of the alternate placeholders for it. Alternatively individual values can be referenced with the ACC_CODE_0N, ACC_DESCR_0N, ACC_QTY_0N, and ACC_REF_0N placeholders, where N is replaced with the row number of the table.

There is currently one type of accessories table available although more types can be added if required.

The data for the grid is found in the Inventory Setup window for an item, in the Manage Accesories form which is opened through the Functions menu.

For the label commands of the table data to be generated successfully it is important that the table drawing commands in the template appear immediately after the ACCESSORIES_GRID1 placeholder label command.

The spacing of the table is determined by the layout of the lines of the table in the template. The table can be drawn with the table drawing tool located in the left side bar in GoLabel II. Labels are placed at the top left corner of their corresponding cell. Headers are added automatically and are one font size larger than the font for the table data. There is by default a 20 dot indentation for the table values. Quantity values are right aligned, using white space characters, within the space of the widest quantity value.

If there is more data than there are rows drawn in the template table then the additional rows are added automatically based on the size of the last row.

Without enough horizontal spacing the values in the table may overlap. Currently this issue is ignored but having extra horizontal space will help mitigate it. Limiting the number of characters and using a fixed width font may be one option to fix this in the future.