Several elements of ITrack and ITrack software utilize barcodes. All ITrack products should utilize a similar barcoding scheme.
All bar codes are done via standard 3-of-9.
Preamble and postamble
Virtually every barcode scanner can be programmed to simulate a keypress combination before entering the barcode contents (the preamble) and after (postamble).
ITrack Pro document screens (Sales, Quotes, Purchase Orders) expect a preamble of Ctrl+b and a postamble of \n.
The document screens will take whatever value is between those characters and do a lookup by partnum (the value encoded in barcodes on ITrack Pro tags), and if no values are found by partnum, by UPC (the value encoded into the barcodes printed on most products).
The workclock system expects the barcode scanner to provide a preamble and postamble of ':$:'.
LXW defaults to preamble '~'  and postamble '\r' or 'enter' , but can be changed via Settings: 'ITrack LX'-'Preamble Character Codes' and 'Postamble Character Codes'
Depending on the context, the barcode will encode different types of values.
Notes on Formatting
- The '*' character is never passed on to the client application.
- The '*' character is specific to 5of9 barcodes and should only be include when generating barcodes using the 5of9 barcode font.
- Actually, we should change this page to get rid of '*' on all the barcode formats, then change this note to "ADD * to beginning and end of a 5of9 barcode if you are generating it using 5of9 font".
- Square brackets indicate where actual ids etc should be placed.
- They are NOT included in the final barcode.
An example to ilistrate using lxw as an example:
- Given a sales order from store 1 with id 5318008.
- And a format from this wiki as *S[storeid]-[salesorderid]*
- using 5of9 font to print a barcode
- generating a barcode using 3rd party tool or simulating a scan
|Inventory||*[inventoryid]*||inventoryid must be less than 12 characters|
|UPC||*[raw_UPC]*||raw_UPC must be numeric only, exactly 12 characters|
|Serialized Inventory||*[inventoryid]-[inventoryserialid]* or *D[inventoryserialid]*||the D form is only for database version 307 or above|
|Work Order Job||*J[jobid]*|
|OEM Number||*[any non-empty sequence]*||Catchall for anything that didn't match|
- Encoded location names are currently accepted as alternate location barcode formatting even though it is not standard.
Technically, non-conforming barcode scans that contain letters and numbers are treated as locations as a work-around for an existing setup. However, this behavior is NOT supported in the long-term and will be deprecated and removed without notice. Don't rely on it!
|Sample||*S[sampleid]*||Used in barcodes where the users will not be changing the sample's tag number|
|Copy Work order||*WC[Y|N][workorderid]*||Copy/Clone a workorder. Specify whether to clone data or not with a Y or N.|
|Physical sample (bag)||*T[tagnumber]*||Identifies a sample to be submitted to multiple analyses. Is not globally unique, must be paired with a Work Order.|
|Location||*L[locationid]*||Identifies a specific location. This represents a specific place at only one plant, and does not care about the location name.|
|Analysis||*A[analysisid]*||Identifies a specific analysis.|
|Location+Analysis||*LA[locationid]-[analysisid]*||Adds a sample to the current workorder with selected analysis and location, then opens the sample for editing.|
|Product+Analysis||*PA[productid]-[analysisid]*||Adds a sample to the current workorder with selected analysis and product, then opens the sample for editing.|
|Location+Product+Analysis||*LPA[locationid]-[productid]-[analysisid]*||Adds a sample to the current workorder with selected analysis, location, and product, then opens the sample for editing.|
|Clock the selected user into a selected job||*+CLOCKIN*|
|Clock the selected user out of an active job||*+CLOCKOUT*|
List of things to fix in the current scheme that will cause trouble down the road:
- Inventory ID and InventoryID-SerialID are not prefixed, (potentially) overlapping with number-only string location names
- Inventory ID, InventoryID-SerialID, LocationID do not include storeid, requiring it to be guessed at and limiting its effectiveness if not outright causing bugs