Adding a Repeater Widget

About this task

Use the Repeater widget to enable your device users to submit multiple entries within a single record.

Procedure

In the Canvas, open the Widgets tab.
Double-click or drag the Repeater widget onto the app canvas.

The Repeater Properties panel displays on the right with its sections.
From the Widgets Tab, you can drag other widgets inside the Repeater widget.
In the General section, set the following fields:
1. Enter an ID and Name for the widget or keep the defaults.
In the Repeater Options section, set the following fields:
1. For the Max amount of entries field, enter the number of maximum entries a device user may enter. You may leave this field blank to represent unlimited entries.
In the Repeater Pagination section, set the following fields:
1. For the Styles field, select the appearance of the pagination user interface.
2. For the Position field, select the location of the pagination user interface. Choose from:
  - Top
  - Bottom
  - Both
In the Background section, set the following fields:
1. For the Fill field, select whether you want to use a Color or Image for the background.
  - Color: From the Color Scale, enter a color code or a select a color.
  - Image: Upload Image from your device and then select a Scale. Choose from:
    - Fit
    - Fill
    - Stretch
    - Tile
    - Center
In the Widget Alignment section, choose how you want to align your widget in the app.
- Align Left
- Center
- Align Right
Optional: In the Rules section, 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. Select an app field or variable and an operator from the Field list. Enter the value required for the widget to be visible.
4. Select Add Condition to add another condition.
5. Select Save.
Optional: In the Miscellaneous section, 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.
Move to the Format tab to customize the widget's appearance.
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 the user selects it.
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.
2. Choose one of the following events from the Events list:
  - On Repeater Load: Triggers when SOTI Snap Device Agent loads and initializes the repeater widget.
  - On Repeater Update: Triggers every time the device user successfully does one of the following
    - Add a new entry and SOTI Snap Device Agent renders the new entry. The current entry is null.
    - Update and Save an existing entry, then SOTI Snap Device Agent renders the next entry. The current entry is next one after the Save.
    - Delete an existing entry and SOTI Snap Device Agent renders the next entry. The current entry is next one after the Delete.
  - On Entry Render: Triggers when the device user renders an existing entry using pagination arrows or Back/Next. The current entry is the rendered entry.
  - On Before Entry Save: Triggers just after the device user successfully selects Add or Save and just before the user interface switches to the new/updated entry. The current entry is the entry the device user is trying to add/save.
  - On Before Entry Delete: Triggers when the device user attempts to delete the entry regardless of whether the user confirmed the deletion or not. The current entry is the entry the device user is trying to delete.
  - On New Entry Display: Triggers after the user interfaces switches a new entry when the device user selects Add.
3. Select Add beside Actions.
4. Select an action such as Run Blockly and configure the action. Select Add to apply it to the widget.
5. Select Save to save the action.
6. Repeat for more event and action combinations and return to the Widget Properties tab.
Select Save in the SOTI Snap banner to apply your changes.

Results

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