Add a Barcode Widget

About this task

Use the Barcode widget to initiate the device's camera to scan and read information delivered through a barcode.

Procedure

  1. In the Canvas, open the Widgets tab.
  2. Double-click or drag and drop the Barcode widget onto the app canvas.
  3. In the Barcode Properties panel, enter a name for the widget in the Name field.
  4. Enter a label for the barcode in the Display text field.
  5. Turn on Save Scanned Value to save barcode values in the Barcode column in reports.
  6. Turn on Overwrite to overwrite previous values with the latest scanned value.
  7. Turn on Allow Continuous Scanning to allow the app user to scan multiple barcodes consecutively. If disabled, the app user must relaunch the barcode widget to scan each barcode.
  8. Select the barcode formats you want to enable. The app won't read barcode formats that not selected.
    It can improve speed and performance to limit the number of barcode formats to only those your app users will commonly encounter.
  9. In the Text Formatting section, change the default formatting settings for text.
  10. Choose how you want to align your widget in the app.
    • Align Left
    • Center
    • Align Right
  11. Optional: Add a requirement rule to the widget.
    Use requirement rules to specify whether the app user must configure this widget or can skip it.
    1. Select Requirement Rule to open the Set Requirement Rule dialog box.
    2. Select whether the requirement rule requires meeting all or any conditions.
    3. From the Field list, select an app field or variable and an operator. Enter the value required for the widget to be visible.
    4. Select Add Condition to add another condition.
    5. Select OK to save.
  12. Optional: Add a visibility rule to the widget.
    Use visibility rules to control when a widget is visible to the app user. For example, you can create a condition that a widget should only appear after the app user fills in a field or submits a form.
    1. Select Visibility Rule to open the Set Visibility Rule dialog box.
    2. Select whether the visibility rule requires meeting all or any conditions.
    3. From the Field list, select an app field or variable and an operator. Enter the value required for the widget to be visible.
    4. Select Add Condition to add another condition.
    5. Select Save.
  13. Decide which name you want to appear in the widget report.
    The Same as widget name setting is the default selection and automatically uses the widget name as the chart title. To choose your own chart title, clear the option and enter a new name.

    You may use special characters except for % & < > { } * | ^ and double spaces.

  14. Move to the Format tab to customize the widget's appearance.
  15. Optional: Add an OnScan event and applicable actions to the widget. Events are activities that you can set to trigger an Action. The OnScan event is triggered when a barcode or QR code is scanned.
    Important: Due to the complex combinations available to use, the following steps are guidelines only. You'll need to replace the listed events and actions with your own to suit your app's needs.

    Learn more about the available events and actions at Events and Actions.

    1. Switch to the Events tab.
      Events tab in Widget configuration panel
    2. Choose the OnScan event from the Events dropdown list and then click Add beside Actions.
    3. Select the Map Scanned Value action and configure it.
      Note: You must configure the Map Scanned Value action before you configure any other actions.
    4. Click Add to apply it to the widget.
    5. Click Save to save the action.
    6. Repeat for any additional event and action combinations and return to the Properties tab.
  16. Select Save in the SOTI Snap banner to apply your changes.
    Save app button

Results

Tip: Select Preview to see how the widget appears in your app.