The Form Completion Behaviour settings allow you to control exactly how a fieldworker can suspend, resume and complete a form, and what happens next. You can find these settings under 'Advanced Form Options' in your form Design tab.


When you click on 'Form completion behaviour' in the panel on the right, you will see the different settings that you can enable/disable by selecting/deselecting the tick boxes and clicking 'Save'. 


You can learn more about each setting by hovering over the information ('i') icon next to it. 





Confirm before quit

A fieldworker can choose to quit a form at any point while it is being conducted. By default, they will not be prompted to first confirm if they wish to quit the form that is in progress. This is because by default they can resume the form at a later stage. If you decide to disable the "Allow resume" option (see below), then it may be useful to enable the "Confirm before quit" option to prevent the fieldworker from accidentally quitting the form and losing the data they captured in the form.


For this option to work, a handset must have Mobenzi Researcher version 4.14.1 or higher.



Allow resume

If this option is enabled, a fieldworker will be able to resume an incomplete form that they previously quit. This is enabled by default.


Note: If disabled, a fieldworker will lose any responses captured to that point when they quit. It is recommended that you enable "Confirm before quit" (see above) if you choose to disable "Allow resume".


For this option to work, a handset must have Mobenzi Researcher version 4.15.0 or higher.



Allow multiple incomplete instances

By default, a fieldworker can only have one incomplete form in progress at a time (assuming that 'Allow resume' is enabled). This means that they must complete the current form before they can begin the next. In some situations, you may prefer to allow the fieldworker to have multiple forms in progress. This may, for example, be useful where a fieldworker is frequently interrupted during the interview process and needs to be able to continue with another interview (using the same form) and return to the original interview at a later stage. 


Note: this option has no effect if "Allow resume" has been disabled.


A form that has been suspended (when the fieldworker quits the form) is labelled by adding a reference to the form name. This reference allows the fieldworker to identify each in-progress form in the form listing. By default, the reference is the start date and time of the submission, but it can be changed by the fieldworker (e.g. to use the name of the respondent or some other meaningful identifier). 


Note: The reference is not uploaded as part of the submission.


When selecting an incomplete form, the fieldworker may choose 'Keep & start new' from the options menu (bottom left). This will keep the selected in-progress form and start a new form (which can also be suspended if necessary). There is no limit to the number of in-progress forms that the fieldworker can have. 


For this option to work, a handset must have Mobenzi Researcher version 5.3.0 or higher.



Allow restart

If a previously suspended form is selected from the form listing, the fieldworker may choose to resume the suspended form (assuming that "Allow resume" has been enabled) or keep the suspended form and start a new instance of the form (assuming "Allow multiple incomplete instances" has been enabled). If "Allow restart" has been enabled, they may also choose to discard the selected in-progress form and start the form from the beginning. Any responses previously captured for the selected in-progress form will be discarded permanently. The "Allow restart" option is enabled by default.


For this option to work, a handset must have Mobenzi Researcher version 4.15.0 or higher.


Allow incomplete submissions

By default, a fieldworker must complete a form before any captured responses are uploaded to the console. By enabling "Allow incomplete submissions", the fieldworker can submit an incomplete instance of the form. An incomplete submission can be submitted by selecting the form instance and selecting "Submit incomplete" from the options menu. The fieldworker will be need to capture a reason why they were unable to complete the form, which will be available when reviewing the submission in the console. Once the incomplete form has been submitted, it will be removed from the fieldworker's handset.


For this option to work, a handset must have Mobenzi Researcher version 4.15.0 or higher.



Unassign on complete

By default, a fieldworker can complete any number of submissions of a form until it is manually unassigned from their handset by a form designer/administrator. By enabling the "Unassign on complete" option, access to the form will be removed automatically once a form is completed by the fieldworker. The form can be re-assigned to the fieldworker from the console if necessary. This option can be used to ensure that only one submission of a particular form can be captured by a fieldworker.


This option works for all versions of Mobenzi Researcher.



Check for updates after upload

If a form is being modified regularly, it would be useful to enable the "Check for updates after upload" option to ensure that fieldworkers always have the latest version of the form. If enabled, their handset will automatically check for updates after all pending submissions on the handset have been uploaded.



Note: If all uploads complete while a fieldworker is conducting another form, the automatic update check will only occur when the fieldworker next navigates back to the main menu, i.e. automatic "Check for updates" will never interrupt the conducting of a form.


For this option to work, a handset must have Mobenzi Researcher version 4.10.0 or higher.