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 depend 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 |
|---|---|---|---|
General |
|||
BAR1 |
Barcode | All | |
BAR2 |
Not used | ||
DESCR1 |
DESC1 |
Short Description | All |
DESCR2 |
DESC2 |
Long Description | All |
CAT1 |
Category | Not used | |
REF1 |
Reference | All | |
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 | ||
Assets |
|||
BAR1 |
Asset Number (Default) OR Barcode (See Notes 3) |
Assets | |
BAR2 |
Barcode (Default) OR Asset Number (See Notes 3) |
All | |
CODE1 |
Stock Item Code | All | |
DESCR1 |
DESC1 |
Asset Name | All |
DESCR2 |
DESC2 |
Description | All |
PDATE1 |
Purchase Date | Assets | |
REF1 |
Reference | All | |
LBL1 |
Label | Inventory | |
WEIGHT1 |
WGT1 |
Weight in units | |
SELLEX1 |
SELLEXCL1 SELL-EXCL1 |
Selling Price Excluding | |
SELLINC1 |
SELLINCL1 SELL-INCL1 |
Selling Price Including | |
ACCESSORIES_GRID11 |
ACC_GRID1 ACC_GRID(CODE,DESCR,QTY) |
Accessories Grid Type 1 Columns: Code, Description, Qty |
|
|
|
ACC-GRID2 ACC_GRID(DESCR,QTY) |
Accessories Grid Type 2 Columns: Description, Qty |
|
ACCESSORIES_GRID31 |
ACC_GRID3 ACC_GRID(QTY,DESCR) |
Accessories Grid Type 3 Columns: Qty, Description |
|
ACC_CODE_0N2 |
Accessories Grid Code Row N | ||
ACC_DESCR_0N2 |
Accessories Grid Description Row N | ||
ACC_QTY_0N2 |
Accessories Grid Quantity Description Row N | ||
ACC_REF_0N2 |
Accessories Grid Line Reference Row N | ||
%PROP1% |
%P1% %PROP1C% %P1C% |
Additional Property 1 Code | |
%PROP2% |
%P2% %PROP2C%%P2C% |
Additional Property 2 Code | |
%PROP3% |
%P3% %PROP3C% %P3C% |
Additional Property 3 Code | |
%PROP1D% |
%P1D% |
Additional Property 1 Description | |
%PROP2D% |
%P2D% |
Additional Property 2 Description | |
%PROP3D% |
%P3D% |
Additional Property 3 Description | |
%PROP4% |
%P4% |
Additional Property 4 | |
%PROP5% |
%P5% |
Additional Property 5 | |
%PROP6% |
%P6% |
Additional Property 6 | |
%PROP7% |
%P7% |
Additional Property 7 | |
%PROP8% |
%P8% |
Additional Property 8 | |
%PROP9% |
%P9% |
Additional Property 9 | |
%PROP10% |
%P10% |
Additional Property 10 | |
%PRED% |
Predicted | ||
%FACTS% |
Facts | ||
%WHSCODEPRN%4 |
%WHS-CODE-PRINT% |
[WIP] Warehouse Code for Warehouses with "Print on Label" enabled when "Print WHS Label" enabled for the Inventory Item. | |
%WHSNAMEPRN%4 |
%WHS-NAME-PRINT% |
[WIP] Warehouse Name for Warehouses with "Print on Label" enabled when "Print WHS Label" is enabled for the Inventory Item. | |
|
Lab Samples |
|||
%SAMPLENO% |
%FIELD-A% %A% |
Sample Number | |
%SUBMITDATE% |
%FIELD-B% %B% |
Submitted Date, YYYY-MM-DD format | |
%USER% |
%FIELD-C% %C% |
User Submitted, First and Last name | |
%DEBTOR% |
%FIELD-D% %D% |
Debtor, Name | |
%ORDERNO% |
%FIELD-E% %E% |
Order Number | |
%APPNO% |
%FIELD-F% %F% |
Application Number | |
%REQDATE% |
%FIELD-G% %G% |
Date Required, YYYY-MM-DD | |
%ITEM% |
%FIELD-H% %H% |
Item Code | |
%ITEMDESCR% |
%FIELD-I% %I% |
Item Description | |
%QTY% |
%FIELD-J% %J% |
Quantity | Lab Samples |
%QTYWUNIT% |
%FIELD-J2% %J2% %QTY-WITH-UNIT% |
Quantity with unit appended | Lab Samples |
%YEAR% |
%FIELD-K% %K% |
Year | Lab Samples |
%TREATED% |
%FIELD-L% %L% |
Treated, Shows as "Treated" if checkbox is ticked, otherwise blank | Lab Samples |
|
PT Job Item [WIP] |
|||
%PBAR% |
%PBARCODE% %PB% %PB1% |
Primary Barcode, the value used depends on which Barcode Print button in the form is clicked. The Job Item Number is used when the button next to it is clicked, and the Barcode is used when the button next to it is clicked. |
|
%JOBITEM% |
%JOBITEM-NAME% %JI-NAME% %JI% %JI1% |
Job Item Name | PT Job Item |
%JOBITEMNUM% |
%JOBITEM-NUM% %JOBITEMNO% %JI-NUM% %JI2% |
Job Item Number | PT Job Item |
%LOC% |
%LOCATION% %L% %L1% |
Location Description | PT Job Item |
%LOCCODE% |
%LOCATION-CODE% %L2% |
Location Code | PT Job Item |
%QC% |
%QC-NAME% %QC1% |
Quality Control Description | PT Job Item |
%QCCODE% |
%QC-CODE% %QC2% |
Quality Control Code | PT Job Item |
%INSPBY% |
%INSPECTED-BY% %I% %I1% |
Inspected By Full Name | PT Job Item |
%INSPBYFN% |
%INSPECTED-BY-FNAME% %I2% |
Inspected By First Name | PT Job Item |
%INSPBYLN% |
%INSPECTED-BY-LNAME% %I3% |
Inspected By Last Name | PT Job Item |
%CUST% |
%CUSTOMER% %C% %C1% |
Customer Name | PT Job Item |
%CUSTCODE% |
%CUSTOMER-CODE% %C2% |
Customer Code | PT Job Item |
%DOCNUM% |
%DOCUMENT-NUM% %DOCNO% %DN% %DN1% |
Document Number | PT Job Item |
%LPLAN% |
%LPLANNING%%LP% %LP1% |
Location Planning Description | PT Job Item |
%LPLANCODE% |
%LPLANNING-CODE%%LP2% |
Location Planning Code | PT Job Item |
%GROUP% |
%G% %G1% |
Group Description | PT Job Item |
%GROUPCODE% |
%GCODE% %G2% |
Group Code | PT Job Item |
%REF% |
%REFERENCE% %R% %R1% |
Reference | PT Job Item |
%DESCR% |
%DESCRIPTION% %D% %D1% |
Description | PT Job Item |
%BAR% |
%BARCODE% %B% %B1% |
Barcode | PT Job Item |
%SERIAL% |
%SERIAL-NUM% %SERIALNO% %SN% %SN1% |
Serial Number | PT Job Item |
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. TheNis replaced with a number referencing the row in the grid, for instanceACC_CODE_01references the Code value in first row. - For barcode printing in the Assets Module the by default the placeholder BAR1 references the Asset Number of the item and the placeholder BAR2 references its Barcode. However, if the Print Barcode button in the General Tab of the Asset Details form is clicked, the values are interchanged, with BAR2 referencing the Asset Number.
Printing from Main Tab in Asset Details Form (Default Behaviour)
Printing from General Tab in in Asset Details Form (Special Case)
- [WIP] The placeholders
%WHSCODEPRN%and%WHSNAMEPRN%will have no effect unless the Inventory Item has the option "Print WHS Label" enabled in its setup form and there is at least one Warehouse with the option "Print On Label" enabled in its setup form, as shown.
[SCREENSHOT_HEADER1]
[SCREENSHOT_IMAGE1]
[SCREENSHOT_HEADER2]
[SCREENSHOT_IMAGE2]
With both options enabled, the placeholders are substituted with values from the Warehouses, with additional labels being printed if there is more than one Warehouse with the "Print On Label" option enabled.
Lab Samples Markers
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.
