Configuración¶

In version 3.3.0 the settings menu was redesigned to provide a cleaner structure and improved navigation experience. This update aligns the screen with the design changes introduced in previous versions and prepares the menu to host future configuration options, such as 2FA-related settings.

Sync data¶

Any user is able to choose from a drop-down list if the data entered in the app is uploaded to the server manually or scheduled every 15 min, 1 hour or 1 Day. By default the app will sync every 24h. This kind of Syncing includes new and updated events and TEI’s.

Sync configuration/metadata¶

Any User is able to choose from a drop-down list if the data entered in the app is uploaded to the server manually or scheduled every day or week. By default the app will sync every 24h. This sync will update changes in programs or configurations in web.

From 3.4, in addition to existing intervals, automatic metadata sync can now run every 6 or 12 hours, allowing for more timely updates and better alignment with data sync behavior.

Sync parameters¶

These parameters allow the user to specify the maximum number of TEI’s and events that can be stored in the local device. The user can also specify if limits apply per organisation unit or in total. Values can be set to default by clicking on “Reset to default”.

Note

Sync data, Sync configuration and Sync parameters can be overwritten using the Android Settings Web App as described [in the specific section][#capture_app_andoid_settings_webapp_synchronization]

Reserved values¶

This will specify the number of reserved Id's available in your device and will allow you to refill them.

Open sync errors log¶

The sync error log gives details about the error and is prepared to be shared with admins.

Two factor authentication (New in 3.5)¶

From version 3.5, you can turn on two-factor authentication in the app. Two-factor authentication adds a second step when you log in: a code from an authenticator app on your device.

The Two factor authentication item appears in Settings only for accounts that log in with OAuth. It does not appear for accounts that log in with a username and password.

The item shows whether two-factor authentication is on or off. To turn it on or off, click the item.

You need an internet connection to turn two-factor authentication on or off. If you have no connection, the screen shows the message Can't connect to network and the Try to reconnect button.

Turn on two-factor authentication¶

To turn on two-factor authentication:

1. In Settings, click Two factor authentication.
2. If you do not have an authenticator app, install one on your device. The screen recommends Google Authenticator. You can use any app that creates time-based one-time passwords (TOTP).
3. In your authenticator app, add an account with the configuration key that the screen shows. To copy the key, click the copy icon next to it.
4. In the Authentication code field, enter the code that your authenticator app shows.
5. Click Turn on.

After you turn on two-factor authentication, the login page of your server asks for the code when you log in with OAuth.

Turn off two-factor authentication¶

To turn off two-factor authentication:

1. In Settings, click Two factor authentication. The screen shows that two-factor authentication is on.
2. Open your authenticator app.
3. In the Authentication code field, enter the code that your authenticator app shows.
4. Click Turn off.

Export database¶

Users are able to export the local database and share it with an admin, who will be able to import it for troubleshooting, being able to replicate the exact environment (database, device, configuration). The exported database is encrypted and the administrator will require the user credentials to be able to access the database

Note

Export database is available only for accounts that log in with a username and password. It does not appear in Settings for accounts that log in with OAuth.

The import button can be found by tapping on the tree dots menu at the login screen.

Delete local data¶

This action will delete local data without having to log out.

Warning

Using this functionality might lead to data loss if changes have not been previously synced to the server.

Reset app data & configuration¶

This action will log out the user and delete all data and metadata, this means user and server information is also deleted. It is similar to resetting the App.

Warning

Using this functionality might lead to data loss if changes have not been previously synced to the server.

SMS Settings¶

This sections allows to check or edit the parameters related to the sms gateway. More information here.

Software Update¶

This feature enables implementation administrators to manage and control the version of the Android app from the DHIS2 user web interface, making it easier to manage app updates and ensure compatibility with the DHIS2 system. Managers will be able to upload the desired version and users will get a prompt message to update when they are not in the last updated version. The management of versions is made through a new Web App.