Add a Workflow Rule
Under Workflow Rules in the left settings menu, 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 (Incoming Barcode or Button double-press) and click Save Trigger.
A green Success modal prompt appears with Add Action and Add Condition buttons.
Under Condition, click Add and define it by selecting the relevant settings from the drop down menus. Click Save Condition.
A green Success modal prompt appears with Add Action and Add Condition buttons.
In the Action section, click Add and define the Action and Operation details. Once done, click Save Action.
At the bottom left, select Save Workflow 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 a scanned barcode data is received.
Scanner connects - The rule is executed when a scanner connects to the Android device.
Button double-press - The rule is executed you double-press the scanner's trigger button.
Button triple-press - The rule is executed when you triple-press the scanner's trigger button. This trigger currently supports only one type of Action as a result of the rule execution, and that is to initiate Photo Reporting mode.
Note
You can only add one Trigger per Workflow Rule.
Button double-press as Trigger
When selecting the Button double-press function as a Trigger in Workflow Rules, Conditions are exempt from the logic and there's a single Action for you to select.
Output via Intent - This allows sending a barcode Intent to your integrated system on each double-press in order to send notifications to the worker's MARK Display.
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 to a Workflow Rule. All Conditions must be met for the Workflow Rule to be executed.
If no Conditions are set, the Action will be applied whenever the Trigger happens.
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 contain at position - Actions are only executed if the barcode content contains the entered value at a certain position.
Barcode content does not contain at position - Actions are only executed if the barcode content does not contain the entered value at a certain position.
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.
Barcode length is in range - Actions are only executed if the number of characters in the barcode content is within a defined range.
Barcode length is not in range - Actions are only executed if the number of characters in the barcode content is not within a defined range.
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 three Action types: Execution, Barcode transformation and Output.
Execution
Make a beep - The mobile device beeps.
Screen timeout reset - Resets the sleep timer for your Android device screen.
Trigger keycode - Presses a specific keycode on the virtual keyboard (requires the Software Keyboard integration). Possible keycodes can be found here (all constants starting with KEYCODE_).
Hide keyboard - The on-screen keyboard is hidden.
Open specific link in browser - Opens a specified link in the browser (make sure to include the protocol, e.g. https://insight.proglove.com/home).
Open link from barcode in browser - Opens the specific link contained in the scanned barcode in the browser. Make sure to whitelist the domain for a secure process and that the barcode contains only the link and nothing else.
Trigger photo - Initiates Photo Reporting mode.
Barcode transformation
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).
Insert before text - Inserts the specified string before the defined text/string inside the barcode content.
Insert after text - Inserts the specified string after the defined text/string inside the barcode content.
Replace regex - Enter a Regular Expression and replace it with the designated replacement text (for more information, see Regular Expressions).
Replace range - Replaces the characters between the two specified character positions with the entered replacement text.
Replace all before text - Replaces the content before the specified string with entered replacement text. If you check the Before last checkbox, the replacement is applied before all instances of the specified string within the barcode.
Replace all after text - Replaces the content after the specified string with entered replacement text. If you check the After last checkbox, the replacement is applied after all instances of the specified string within the barcode.
Replace text - Replaces the specified string with the entered replacements text. If you check the Apply to all checkbox, all instances of the specified string within the barcode are replaced.
Delete range - Deletes the characters between the two specified positions (excluding the character marking the Range End).
Delete regex - Deletes the specified Regular Expression from the barcode content. If you check the Apply to all checkbox, all instances of the specified string within the barcode are deleted.
Delete all before - Deletes all characters before the specified string. If you check the Before last checkbox, the characters preceding all instances of the specified string are deleted.
Delete all after - Deletes all characters after the specified string. If you check the After last checkbox, the characters following all instances of the specified string are deleted.
Delete text - Deletes the specified string inside the barcode content. If you check the Apply to all checkbox, all instances of the specified string within the barcode are deleted.
Output
This group of Actions will only display 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.
Paste barcode data - Pastes the exact character order of the scanned barcode content. The ProGlove keyboard must be enabled and set as default. The field, where content is pasted, must be focused.
Type barcode data - Enters the scanned barcode content by simulating keypresses character by character. Special keys (e.g. TAB) are executed as a function. You can adjust the duration of simulated Key hold duration and Time between key presses in milliseconds (ms). The default value is 20 ms.
Send via WebSocket - Sends the scanned barcode content via WebSocket using a pre-defined port number.
Send via MQTT - Sends the scanned barcode content via MQTT using a pre-defined host, client ID and port number.
Send to SDK - Sends the scanned barcode content via the SDK integration path.
Broadcast intent - Sends the scanned barcode content via the Broadcast Intent integration path. You specify the action.
Start the activity with action - Sends the data with the Intent that starts the Activity registered for defined Intent action.
Start the activity with the component - Sends the data with the Intent that starts the defined Activity in the defined application package.
Limitations
Caution
Output action Start activity with component is not supported on Android 11 OS and higher due to Package visibility limitations introduced with this Android OS version. For more information please look into the respective Android documentation.