¶¶Òõ

Skip to main content

Validation Formats

¶¶ÒõCloud Portal → 4-Dot Menu → Data Management → Ordering Settings → Settings → Validation Formats

The Ordering application supports scanning Loyalty and Stored Value barcodes from the Order Entry and Tender screens without requiring the user at the POS to open a separate modal (e.g. Loyalty Identification modal).

Use the Validation Formats editor to:

  • Define the validation format of the scanned barcodes for Loyalty ID and Stored Value entities.

  • Assign specific POS actions and the eligible screens to the validation format.

The following describes the columns on the Validation Format List homepage:

Column

Description

Format Name

Identifies the name of the validation format for barcode scans.

Entity

Identifies the type of entity assigned to the format: Loyalty ID or Stored Value.

Priority

Specifies the priority assigned to the format in relation to other validation formats.

Add Validation Format

¶¶ÒõCloud Portal → 4-Dot Menu → Data Management → Ordering Settings → Settings → Validation Formats

From the upper-right of the Validation Formats homepage, select New Validation Format to add a validation format.

The New Validation Format form includes the following pages:

Page

Description

Description

Describe general settings about the validation format, including its name and assigned entity: Loyalty ID or Stored Value.

Scan Format

Define the format of the entity that is scanned, including the character type, character count, and conditions.

Parsing Rules

Define parsing rules for the scanned entity, including its parameters and their respective position in the string.

Actions

Assign specific POS actions and eligible POS screens to the validation format.

Description

¶¶ÒõCloud Portal → 4-Dot Menu → Data Management → Ordering Settings → Settings → Validation Formats

From the Description page of the Validation Formats editor, define the following:

Setting

Description

Format Name

Type a name for the validation format.

Entity

From the dropdown, select the entity to assign to the validation format.

Priority

Type the numeric priority to assign to the validation format in relation to other validation formats.

Active

Toggle the Active status of the validation format for each site.

Scan Format

¶¶ÒõCloud Portal → 4-Dot Menu → Data Management → Ordering Settings → Settings → Validation Formats

From the Scan Format page of the Validation Formats editor:

  • Define the format of the scanned entity, including the character type, and character count.

  • Define the conditions that the entity string must meet.

From the Scan Format section, define the format of the scanned entity:

Setting

Description

Character Types

From the dropdown, select the type of characters to include in the string.

Minimum Character Count

Type the minimum number of characters that are required.

Maximum Character Count

Type the minimum number of characters that are allowed.

From the Contains section, define the conditions that the entity string must meet:

  1. From the upper-right of the Contains section, select Add Condition.

  2. From the Create Condition window, define the following:

    Setting

    Description

    String Position

    From the dropdown, select the position where the string is located in the scanned entity.

    For example, select Starts With if the string is located at the beginning of the scanned entity.

    String Value

    Type the string value. The eligible characters are dependent on the Character Type selected in the section above.

Parsing Rules

¶¶ÒõCloud Portal → 4-Dot Menu → Data Management → Ordering Settings → Settings → Validation Formats

From the Parsing Rules page of the Validation Formats editor, add rules that determine how the scanned entity is parsed. A parsing rule instructs the application how to read and interpret the values in the scanned entity.

To add a parsing rule:

  1. From the upper-right of the Parsing Rules page, select Add Parsing Rule.

  2. In the Rule Name field, type the name of the parsing rule.

  3. From the Parameters section, select Add Parameter.

  4. From the Add Parameter window, use the provided fields to define the function, position, value, and/or length of the string included in the scanned entity.

    The provided fields are determined by the selected string position. Some fields described below may not be available.

    Field

    Description

    Use As

    From the dropdown, select the function of the string.

    String Position

    From the dropdown, select the location in the scanned entity where the string is located.

    Value

    Type the specific string value.

    Length

    Type the number of characters that make up the string.

    Start Character

    Type the first character in the string.

    Start Character Position

    Type the position value of the first character in the string.

    For example, if the first character in the string occupies the third position in the scanned entity, then type 3.

    End Character

    Type the last character in the string.

    End Character Position

    Type the position value of the last character in the string.

    For example, if the last character in the string occupies the ninth position in the scanned entity, then type 9.

  5. From the lower-right of the Add Parameter window, select Save.

Actions

¶¶ÒõCloud Portal → 4-Dot Menu → Data Management → Ordering Settings → Settings → Validation Formats

From the Actions page of the Validation Formats editor:

  • Identify the screen(s) where the user at the POS is allowed to scan the barcode.

  • Identify the action to execute at the POS when the barcode is scanned.

To add a POS action and associated screen:

  1. From the upper-right of the Actions page, select Add Action.

  2. From the Add Action window, define the following:

    Setting

    Description

    Action Name

    Type a name for the action.

    Screen

    From the dropdown, select the screen where the user at the POS is allowed to scan the barcode.

    Action

    From the dropdown, select the action to execute at the POS when the barcode is scanned.

  3. From the lower-right of the Add Action window, select Save.