Please note: this is a legacy article which refers to features or aspects of our tools which have been or will be phased out in the future.

Fieldworkers need to ensure they have the latest version of the forms assigned to them. It is recommended that when forms are modified or assigned/unassigned, these changes are pushed to fieldworkers automatically. This can be done via theĀ Assignments tab. However, it is also possible for fieldworkers to manually check for form updates, as outlined below.

To check for updates, a handset must have connectivity and no pending uploads. Wait for any pending uploads to complete before trying to check for updates.

To check for updates:

  1. Select your project's module from the main menu.
  2. Select 'Check for updates'.
  3. Wait for the updates to download - depending on the number of forms assigned this may take anywhere from a few seconds to several minutes.
  4. Once all updates have downloaded, you can choose to conduct a form, or select Exit to return to the to the Home screen.

Potential errors when checking for updates

Error message
Explanation / troubleshooting

"Network error, please try again"

To resolve this, try checking for updates again in a few moments as there may have been a temporary connectivity problem. Remember to ensure that the handset has airtime, data or is connected to WiFi. The connectivity must also be good (2G or 3G at least). If the problem persists (and there is definitely connectivity) contact the Mobenzi Help desk to investigate the issue further.

"Handset not registered on console. Ensure a handset with IMEI [xxx] has been added then try again"

This error means that the handset has not been linked to your account. Contact a member of your team with the necessary permissions to add the handset.

"Update failed. Please wait, your recent submissions are still being processed"

It normally takes a few moments for previous uploads to be processed once received before you can check for updates. Wait a few minutes and then check for updates again.

"Server Error: Invalid token"
This occurs when the Mobenzi mobile app is deleted (uninstalled) from the handset and then re-installed. For security reasons, a token is automatically generated and assigned to the handset when the app is installed to prevent unauthorised third-parties from emulating the handset and potentially accessing or submitting data.

To resolve, locate the handset from the Handsets tab and click 'View handset' from the menu. Click "Clear" next to the token - a new token will be generated when the handset next connects to the server.