Once the programs are backed up, You can restore them if anything went wrong with your program. From the Program menu, you can select ‘Backup / Restore’ option to open a submenu and select ‘Restore Program’ option to open ‘Available Backup’ popup.
...
If the program has previous backups, you can see a list of those backups in this popup. But if there isn’t any previous backup, then it will show a warning message with ‘No Backups found’ message.
...
In this popup, you can notice two action buttons on the right of each backup.
Restore: This option will open another ‘Restoring’ popup window.
Download: This option will download the specific backup version of that program. You can review the file json file and import it using ‘import / export’ app in DHIS2.
Close: As the name suggest, will close the popup window without affecting anything.
Restoring Program
This popup will allow you to fine tune your requirement for the restoring purpose.
...
Restore Elements: You can choose which object you want to restore from the backup file. You can simply restore Program if your changes were specific to the Program and you can also chose the ‘Data Elements’ which in turn will also restore ‘Program Stage Data Elements’, ‘Program Stages’ and ‘Program’. The indentation shows the Parent-Child relationship between the elements. You cannot restore ‘Child’ without restoring the ‘Parent’.
Select All / Select None: You can use these buttons to check all the Elements or None of them.
Organisation Units: While restoring, you can keep your current Organisation Unit assignment by selecting ‘Keep current settings’ or you can replace all you existing configuration with backup assignment by selecting ‘Overwrite with backed up configuration’.
Sharing Settings: Similar to Organisation Units restore, you can either keep the settings or overwrite them by selecting one of the two option available.
Cancel: As the name suggest, will simply close the popup window without impacting the program.
Dry Run: It will test the import settings without impacting / importing any data.
...
After running the dry run, it will show how many elements will be created or impacted. In above example 291 elements will be impacted, but the number will vary based on the Program you want to restore and Elements you have selected.
| Note |
|---|
Please run ‘Dry Run’ before Restoring the program |
Restore: After selecting all the required option and running dry run, you can click ‘Restore’ button to restore the backed up copy of the program. It will take sometime to restore and will show a Success notification