Create a Material#
Configuration#
To enable barcode scanning when creating a material, you need to configure which fields the system should extract from a scanned barcode and map them to the corresponding input fields in the Create Material wizard. This configuration ensures that, upon scanning, values are automatically populated - speeding up material registration and reducing manual input errors.
This is done by inserting records into the LabelSpecificationField Generic Table. Each record corresponds to a specific segment of the barcode, identified by a prefix, and defines where in the interface that value should be displayed. In this example, we will use the GS1 label specification, but the same approach applies to other supported formats, provided the structure is appropriately defined.
Below is the list of fields typically required for material creation. Each one has an associated prefix that the system uses to identify the segment in the barcode string. These prefixes must match the format used in your barcode labels.
| Label Specification | Field Name | Field Sequence | Field Data Type | Field Prefix | Target Field |
|---|---|---|---|---|---|
| GS1 | Material Name | 1 | String | AX | Material.Name |
| GS1 | Material Description | 2 | String | BX | Material.Description |
| GS1 | Material Type | 3 | String | CX | Material.Type |
| GS1 | Material Facility | 4 | String | DX | Material.Facility.Name |
| GS1 | Material Product | 5 | String | EX | Material.Product.Name |
| GS1 | Material Form | 6 | String | FX | Material.Form |
| GS1 | Material Flow | 7 | String | GX | Material.Flow.Name |
| GS1 | Material Step | 8 | String | HX | Material.Step.Name |
| GS1 | Material Primary Quantity | 9 | Long | IX | Material.PrimaryQuantity |
| GS1 | Material Primary Units | 10 | String | JX | Material.PrimaryUnits |
| GS1 | Material Order Number | 11 | String | KX | Material.OrderNumber |
Table: Fields required to enable Smart Barcode Scanning in the Create Material wizard
Once you have entered these values into the LabelSpecificationField Generic Table, refresh your application to apply the changes. You should now see the full list of configured fields, as illustrated below.
Barcode Scanning in Action#
With the configuration complete, you can now scan a barcode to create a material. The barcode must follow the same structure as defined in the configuration - while the order of the segments is not important, you must use the exact prefixes configured.
For example, the following string encodes values for each of the configured fields:
AXCookie012%BXCookie 012%CXProduction%DXCookie Factory%EXCookie-A%FXLot%GXCookiesFlow%HXMixing%IX20%KXKg%KXOrder123
Each segment (for example, AXCookie012, BXCookie 012) corresponds to a prefix and value pair. And as previoulsy explained, the % characters acts as a separator for each segment.
The barcode generated from this string is shown below:
The video demonstrates how scanning this barcode in the Create Material wizard automatically fills in the fields using the configured logic:
Info
Continue to Process a Material for another scenario.