HIBC
Overview
The parser supports the ANSI HIBC 2.5 supplier labeling standard. For the complete documentation of the standard please refer to the official website.
Sample usage for HIBC parser and Barcode Capture
First, you need to create a DataCaptureContext, access a Camera and create HIBC parser:
const context = Scandit.DataCaptureContext.forLicenseKey("-- ENTER YOUR SCANDIT LICENSE KEY HERE --");
const camera = Scandit.Camera.default;
context.setFrameSource(camera);
const cameraSettings = new Scandit.CameraSettings();
cameraSettings.preferredResolution = Scandit.VideoResolution.FullHD;
camera.applySettings(cameraSettings);
const settings = new Scandit.BarcodeCaptureSettings();
settings.enableSymbology(Scandit.Symbology.DataMatrix, true);
const barcodeCapture = Scandit.BarcodeCapture.forContext(context, settings);
let parser;
Scandit.Parser.forContextAndFormat(context, Scandit.ParserDataFormat.HIBC).then(p => parser = p);
Then, you need to implement BarcodeCaptureListener:
const barcodeCaptureListener = {
didScan: (_, session) => {
const barcode = session.newlyRecognizedBarcode;
if (barcode == null) return;
// Parse the scan result.
parser
.parseString(barcode.data)
.then(result => {
const fields = result.fieldsByName;
/*
* Extract the fields relevant to your use case. Below, for example, we extract a label,
* which has the type String, and an expiry date, which is represented as a map with keys
* "year", "month", "day".
*/
const serialNumber = fields['lic'].parsed;
const expiryDate = fields['expiryDate'].parsed;
const {year, month, day} = expiryDate;
// Do something with the extracted fields.
})
.catch(error => {
// Handle the parser error
console.log(error.message);
});
}
};
Finally, add the listener to the mode to receive scan results:
barcodeCapture.addListener(barcodeCaptureListener);
For details, go to the API docs.
Example
Parsing following code (without quotes):
"+A123BJC5D6E71G"
will result in following JSON output:
[
{
"name" : "lic",
"parsed" : "A123",
"rawString" : "A123"
},
{
"name" : "pcn",
"parsed" : "BJC5D6E7",
"rawString" : "BJC5D6E7"
},
{
"name" : "uom",
"parsed" : 1,
"rawString" : "1"
},
{
"name" : "metadata",
"parsed" : {
"checksum" : "G",
"primary" : true,
"secondary" : false
},
"rawString" : ""
}
]
Exposed fields
A code might contain a primary and/or secondary section. If it contains a secondary section, it might also contain an additional section for miscellaneous data. To check whether a primary/secondary/additional section is present, check the ‘metadata’ field. The order of the fields corresponds to order in the data string. The ‘metadata’ field, is always the last field.
Primary data fields
Field Name |
Always present? |
Parsed Data Sructure |
Additional Notes |
---|---|---|---|
lic |
yes (if primary present) |
alphanumeric string |
Label Identification Code |
pcn |
yes (if primary present) |
alphanumeric string |
Product or Catalogue Number |
uom |
yes (if primary present) |
One-digit integer |
Unit of Measure |
Secondary data fields
Field Name |
Always
present?
|
Parsed Data Structure |
Additional Notes |
---|---|---|---|
quantity |
no |
integer |
|
expiryDate |
no |
Dictionary with these
key/value pairs:
where YY, MM, DD, HH are
two-digit integers. ‘hour’
is optional and not always
present.
|
|
serial |
no |
string |
Serial number |
lot |
no |
string |
Lot/Batch number |
Additional data fields
Field Name |
Always
present?
|
Parsed Data Sructure |
Additional Notes |
---|---|---|---|
serial |
no |
String
|
Serial number
If the serial number is
specified in the secondary
and the additional data,
then the first is ignored.
|
expiryDate |
no |
Dictionary with these
key/value pairs:
with YYYY, MM, DD
integers
|
If the expiry date
specified in the secondary
and in the additional data,
then the first is ignored.
|
manufactureDate |
no |
Dictionary with these
key/value pairs:
with YYYY, MM, DD
integers
|
Metadata field
Field Name |
Always present? |
Parsed Data Sructure |
Additional Notes |
---|---|---|---|
metadata |
yes |
Dictionary with these
key/value pairs:
The primary and secondary
booleans indicate wether
the corresponding section
is present in the code.
The link string is one
character and is used to
link a separate primary and
secondary code together. It
is only present for
standalone secondary codes.
‘check’ is the checksum
character of the code. The
Scandit parser library
automatically checks the
ingerity of the code.
|