Add a Workflow Rule
Under Add Workflow Rules, click Add Rule.
The Workflow Rule page displays the Trigger section automatically.
In the top left corner, type in the Rule Name.
In the Trigger section, select the action that initiates the rule and Save Trigger.
The Success modal window displays the Add Action and Add Condition buttons.
In the left panel, under Condition, click Add or select Add Condition in the Success modal.
The Condition section displays in the right-side panel.
In the Condition section, define the condition by selecting from the drop-down menus and Save Condition.
The Success modal window displays the Add Action and Add Condition buttons.
In the left panel, under Action, click Add or select Add Action in the Success modal.
The Action section displays in the right-side panel.
In the Action section, define the action by selecting from the drop-down menus and Save Action.
The Success modal window displays
At the bottom left, select Save Rule.
The rule displays in the Workflow Rules section.
Trigger
When creating a rule, select a Trigger to designate when the rule is applied:
Incoming Barcode - the rule is executed when scanned barcode data is received
Button - Double Trigger - the rule is executed when you double-press the triggering button on the glove (trigger).
Note
You can only add one Trigger per Workflow Rule.
Conditions
If you select the Incoming Barcode as the Trigger, you can add certain Conditions to specify when the rule is executed.
Important
You can add multiple Conditions in a Workflow Rule. All Conditions must be met for the Workflow Rule to be executed.
You can add Conditions for:
Barcode content
For the Barcode content condition, you can select the following operations:
Barcode content is equal - Actions are only executed if the barcode content is identical to the entered value
Barcode content is not equal - Actions are only executed if the barcode content is different from the entered value
Barcode content does contain - Actions are only executed if the barcode content contains the entered value
Barcode content does not contain - Actions are only executed if the barcode content does not contain the entered value
Barcode content does match Regex - Actions are only executed if the barcode content matches the entered Regular expression
Barcode content does not match Regex - Actions are only executed if the barcode content does not match the entered Regular expression.
Barcode length
For the Barcode length condition, you can select the following operations:
Barcode length is equal - Actions are only executed if the number of characters in the barcode content is identical to the entered number
Barcode length is not equal - Actions are only executed if the number of characters in the barcode content is different than the entered number.
Symbology
For the Symbology condition, you can select the following operations:
Symbology is one of - Actions are only executed if the scanned barcode symbology matches the selected symbologies
Symbology is not one of - Actions are only executed if the scanned barcode symbology does not match any of the selected symbologies.
Actions
After you selected the Trigger and the Condition, you can specify what happens when they are met by defining and Action.
There are two Action types: Barcode transformation and Output.
Barcode transformation
This category of actions describes how barcode content can be manipulated.
Note
Actions using Key Combinations are only available when using USB HID as an Integration Path on the Gateway.
Prepend text - the entered string is inserted as the prefix of the barcode
Append text - the entered string is inserted as the suffix of the barcode
Insert at position - inserts the specified string inside the barcode content starting at the selected position (e.g. from the third character)
Replace range - replaces the characters between the two specified character positions with the entered replacement Text
Replace Regex - you can enter a Regular Expression and replace it with the designated replacement Text (To learn more, see Regular Expressions)
Prepend Key Combination -the specified Key Combination is inserted as the prefix of the barcode
Append Key Combination -the specified Key Combination is inserted as the suffix of the barcode
Insert Key Combination at Position - inserts the specified Key Combination inside the barcode content starting at the selected position (e.g. from the third character)
Replace Range with Key Combination - replaces the characters between the two specified character positions with the specified Key Combination
Replace Regex with Key Combination - you can enter a Regular Expression and replace it with the specified Key Combination (To learn more, see Regular Expressions)
Output
This group of Actions only displays if you select a Custom Integration path. It allows you to define a custom way of transferring the barcode and applying the workflow rule.
Note
Output Actions are always executed last, regardless of the order inside the workflow rule.
Send via WebSocket - sends the scanned barcode content via WebSockets using a pre-defined port number
Send via USB - sends the scanned barcode content via USB
Send via MQTT - sends the scanned barcode content via MQTT
Key Combinations
With the Gateway v1.11.0 release the support for Key Combinations has been introduced. When using the USB HID Integration Path.
A Key Combination is the combination of a Key (an HID keycode or an ASCII character) associated with a group of Modifiers. A maximum of 6 keys can be pressed simultaneously. The Gateway ensures that all keys are released and do not stay pressed forever.
The following Modifiers are supported:
Left Control
Left Shift
Left Alt
Left Super
Right Control
Right Shift
Right Alt
Right Super.