Backup and Restore SORMAS DB on Android Devices

[isaacanip]

Feature Description

1. Some android devices cannot sync to the SERVER DB due to poor internet connectivity.
2. There could be data loss due to SORMAS version incompatibility.

Added Value/Benefit

1. The back up feature will allow for users to backup DB, send DB file via mail to approved locations to have it synched, submit back to user and have it restored on user's device.
2. The backup feature will allow users to backup SORMAS DB before upgrading to latest SORMAS version. In a case where a user looses data, the user can restore the SORMAS DB using the restore functionality.

NB: During data restore, make sure to use the apk file that was used to take the backup.

Acceptance Criteria

Steps to Backup and Restore SORMAS DB in Android
Backup DB Steps

• 1. Launch the SORMAS application on device.
• 2. On the main SORMAS menu, go to "Settings"
• 3. Click on the 'SORMAS Version' label five times consecutively.
• 4. The action in point Get go-ahead from GHS to push SORMAS version 1.68.0 from training to production #3 will display a page with the two new functionalities (i.e. "Back up", "Restore") among existing features like Change pin, change password etc.
• 5. Click on the "Backup" button and this automatically copies the SORMAS DB onto the download folder on the device. The file format is "sormas_db_[yyyy-mm-dd]_[hh-mm-ss].db".
• 6. Note down your credentials since you will need it during the restore process.

Restore DB Steps

• 1. Uninstall the apk on the android.
• 2. Install apk file that was used to take backup.
• 3. After installation, instead of typing the URL in the URL field, click on the 'SORMAS Version' label five times consecutively.
• 4. The action in point Get go-ahead from GHS to push SORMAS version 1.68.0 from training to production #3 will add two buttons (i.e. "Backup DB", "Restore DB") in addition to the information on the settings page
• 5. Click on the "Restore DB" button, select the backup file in the backup folder. where backup file was copied to. Selecting the backup file will replace the SORMAS DB on the device with the backup file.
• 6. Click on the back navigation button to access the login page.
• 7. Provide the necessary credentials, click on the sign in button to view your restored records.

Implementation Details

No response

Mockups

Additional Information

No response