form builder elements
What is the Timer element?
How does the Timer element work?
The Timer element has two functions (start) and (stop) and each widget may start and stop many times resulting in a cumulative elapsed time.
- If a timer is active when a user completes a record by pressing "Done" the timer will be stopped and the elapsed time will be saved and submitted with the rest of the data.
- If a timer is active when a user saves a record or enters a subform, the timer will not stop recording the elapsed time.
- To reset a timer back to 0, press and hold the widget until a pop-up appears prompting you to reset the timer.
How do I add the Timer element to my form?
To add the Timer element, please follow the instructions below.
From inside the form builder, click the Timer button from the left-hand menu. You'll see it populate the device view.
On the right-hand side, you'll see the element properties. Enter the name of your element (A), and if you like, a description of what information should be entered in the element when collecting (B).
Note that if you check the Based on Label option, it will create a data column based on the Label on the element.
Save your form.
How do I parse the Timer data?
To parse the Timer data into another field, follow these instructions.
Create a Text element under the Timer widget.
In the Dynamic Value of the Text element, put record_timer.timeInSeconds. In this example, record_time is the data column name of the Timer element.
Test it on your device.