Add a Check Box Widget

About this task

Use the Check Box widget to add a set of check boxes to your app.

Note: App users can select multiple options from the check box widget. If you want app users to be able to only select one of the provided options, use the Radio Button widget instead.

Procedure

  1. In the Canvas, open the Widgets tab.
  2. Double-click or drag and drop the Check Box widget onto the app canvas.
  3. In the Check Box Properties panel, enter a name for the widget in the Name field.
  4. Enable the Required check box if you want to force app users to select at least one of the options before they can submit the form.
  5. Enter display text for each of the options. Click Add beside an option to add a new option.
  6. Choose how you want your options to be aligned.
    • Auto-wrap text
    • Set Column – Defines the number of columns for options. This is only available if Auto-wrap is not selected.
    • Align Top – Aligns text with the top of the option
    • Align Center – Aligns text with the center of the option
    • Horizontal spacing between options
    • Vertical spacing between options
  7. Choose how the records for this widget should appear when exported to reports or using data export connections. To let the external source decide them automatically, leave Default selected. If you want to customize how they appear, clear Default and update the Data settings: Format field to your preferred format.
    1. Expand the dropdown icon above the right corner of the field to enter macros that represent the data in each display column. Double percentage signs encase macros: %%macro%%. You cannot manually enter a macro.
    2. Enter text characters.
    3. Repeat to add more macros or text characters.
    Do not leave the Data settings: Format field in the middle of creating your format. You could lose your work because the field reverts to the last valid format whenever you leave the field.
  8. In the Text Formatting section, change the default formatting settings for text.
  9. Choose how you want to align your widget in the app.
    • Align Left
    • Center
    • Align Right
  10. 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.
  11. 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.
  12. 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.

  13. Move to the Format tab to customize the widget's appearance.
  14. Optional: Add events and actions to the widget.
    Events are activities that you can set to trigger an Action. For example, you can configure a widget to navigate to a new section in the app when selected by the user.
    Important: Events and actions offer a wide range of combinations. The following steps are guidelines only. Replace the listed events and actions with ones that suit your app's needs and structure.

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

    1. Move to the Events tab.
      Events tab in Widget configuration panel
    2. Choose an event such as On Click from the Events list and then select Add beside Actions.
    3. Select an action such as Navigate and configure the action. Select Add to apply it to the widget.
    4. Select Save to save the action.
    5. Repeat for any more event and action combinations and return to the Widget Properties tab.
  15. 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.