RDQA Metadata Transfer

Program Metadata Tansfer

The metadata from a DHIS2 program contains items necessary for rendering within the enabled DHIS2 server. The DHIS2 server includes an Import/Export tool to generate a JSON or CSV file with all configurations in the server. However, certain attributes may need cleaning to prevent errors during import to the target server. These attributes typically involve references to users that don’t exist in the target server. To streamline the process and avoid manual deletion of each attribute, we can use the Program Configuration App (PCA). You can read more about the PCA here.

The PCA offers the same options as the Import/Export tool available within DHIS2 but automates the process to eliminate any references to organization units, users, or user groups that may cause errors in the target server.

To export the program using the PCA:

1. Open Program Configuration App within DHIS2.

2. Search for 'RDQA' using the filters.

3. Click on the three dots in the upper-right corner of the RDQA Program.

4. Select 'Backup/Restore'.

5. Choose 'Export JSON Metadata'.

6. Select ‘Another Server’ in the target server

7. Click on the ‘Download’ file

8. Log in into the target server

9. Open the Import/Export tool

10. Select the ‘Metadata Import’ Section

11. Upload the file and select the JSON generated in the previous steps

12. Click on the ‘Start dry run’ button

13. Check the Summary Table to ensure that there are no issues.

14. Once the process has been completed without any problems, click on the ‘Start Import’ button.

15. Verify that the RDQA already exists on the server using the Maintenance App.

Dashboards Transfer

RDQA Program has some Dashboard used to review the Program and review the data over time, those Objects are not included in the RDQA Metadata, so we need to use the Import/Export tool in the source server.

1. Log in into the source server

2. Open the Import/Export tool

3. Select Metadata Dependency Export

4. Select ‘Dashboard’ in the Object Type field

5. Type ‘RDQA’ on the object field

6. Check the followings options

   1. JSON

   2. Uncompressed

   3. Skip sharing and access settings

7. Click on the ‘Export Metadata Dependencies’ button

8. we need to open the JSON file using any tool to modify code, we recommend use VSCode , once the file has been opened, we need to eliminate the following attributes:

   1. lastUpdatedBy

   2. createdBy

9. Once the JSON file has been cleaned, we import the JSON in the target File

10. Verify the Summary Report to ensure there are no issues

11. Verify the Dashboard has been created properly

Preparing Organisation Units [Both OU match UIDs, OU do not match]

Exporting data

Preparing data

GET API data

Send data

POST API data