Skip to main content

Label Definitions

A Label Definition is a configuration that defines the label, and its relevant fields, that Smart Label Capture should recognize and extract during scans.

Smart Label Capture provides a Label Definition API, enabling you to configure and extract structured data from predefined and custom labels. This feature provides a flexible way to recognize and decode fields within a specific label layout such as price tags, VIN labels, or packaging stickers without needing to write custom code for each label type.

There are two approaches to using label definitions:

Pre-built Labels​

Smart Label Capture includes ready-made label definitions for common use cases. These pre-built options let you recognize and extract information from standard label types without creating custom configurations:

Loading features...

Example: Price label​

Use the LabelCaptureSettings builder to configure a pre-built label definition for price labels, such as those found in retail environments:

Price Label Example

var settings = LabelCaptureSettingsBuilder()()
    .addLabel(LabelDefinition.priceCaptureDefinitionWithName("price-label"))
    .build();

Custom Labels​

If Smart Label Capture’s pre-built options don’t fit your needs, define a custom label instead. Custom labels can combine your own fields with any of the available pre-built ones.

tip

The following characters are recognized: 0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz ()-./:,$¶".

Custom Fields​

There are two types of custom fields you can define:

Loading features...

The following methods are available to configure custom fields:

MethodOptionalDescription
valueRegexesNoThe regex patterns that identify the target string in the scanned content.
anchorRegexesYesUsed to specify keywords or phrases that help identify the context of the field. This is particularly useful when the label contains multiple fields that could match the same pattern (e.g., when both packaging and expiry dates are present).
symbologiesNoThe barcode symbologies to match for barcode fields. This is important for ensuring that the field only captures data from specific barcode types, enhancing accuracy and relevance.
isOptionalYesWhether the field is optional or mandatory. This is helpful when certain fields may not be present on every scan.

Example: Fish Shipping Box​

This example shows how to create a custom label definition for a fish shipping box, which includes fields for barcode and batch number.

Fish Shipping Box Example

var settings = LabelCaptureSettingsBuilder()()
    .addLabel(LabelDefinitionBuilder()
        .addCustomBarcode()
            .setSymbologies([Symbology.code128])
            .buildFluent("barcode-field")
        .addCustomText()
            .setAnchorRegexes(["Batch"])
            .setValueRegexes(["FZ\\d{5,10}"])
            .setOptional(true)
            .buildFluent("batch-number-field")
        .buildFluent("shipping-label"))
    .build();

Pre-built Fields​

You can also build your label using pre-built fields. These common fields speed up integration because their valueRegexes, anchorRegexes, and symbologies are already predefined.

Customization of pre-built fields is done via the valueRegexes, anchorRegexes, and isOptional methods, which allow you to specify the expected format of the field data.

tip

All pre-built fields come with default valueRegexes and anchorRegexes that are suitable for most use cases. Using either method is optional and will override the defaults.

The resetAnchorRegexes method can be used to remove the default anchorRegexes, allowing you to rely solely on the valueRegexes for detection.

Barcode Fields​

  • SerialNumberBarcode: A barcode field for capturing serial numbers, typically used in electronics and appliances.
  • PartNumberBarcode: A barcode field for capturing part numbers, commonly used in manufacturing and inventory management.
  • ImeiOneBarcode: A barcode field for capturing the first International Mobile Equipment Identity (IMEI) number, used in mobile devices.
  • ImeiTwoBarcode: A barcode field for capturing the second International Mobile Equipment Identity (IMEI) number, used in mobile devices.

Price and Weight Fields​

  • UnitPriceText: A text field for capturing the unit price of an item, often used in retail and grocery labels.
  • TotalPriceText: A text field for capturing the total price of an item, typically used in retail and grocery labels.
  • WeightText: A text field for capturing the weight of an item, commonly used in shipping and logistics.

Date and Custom Text Fields​

  • PackingDateText: A text field for capturing the packing date of an item, often used in food and beverage labels.
  • ExpiryDateText: A text field for capturing the expiry date of an item, commonly used in pharmaceuticals and food products.

Example: Hard disk drive label​

This example demonstrates how to configure a label definition for a hard disk drive (HDD) label, which typically includes common fields like serial number and part number.

Hard Disk Drive Label Example

var settings = LabelCaptureSettingsBuilder()()
    .addLabel(LabelDefinitionBuilder()
        .addSerialNumberBarcode()
        .buildFluent("serial-number")
        .addPartNumberBarcode()
        .buildFluent("part-number")
        .buildFluent("hdd-label"))
    .build();