Metadata Packages

Packages content

Metadata is divided in three json files:

1. RDQA Server Attributes

This is the first file to import into the server. This package contains attributes objects, which works as additional fields of information to most of the metadata objects. These attributes are fully compatible with any of the server versions mentioned above.

It is necessary to import this package since some of the objects in RDQA Program package refer to the attributes.

Learn more about RDQA Server Attributes in the Technical Manual.

2. RDQA Program

This file contains all the objects related to the program: Data elements, Tracked Entity Attributes, Option sets, Option Groups, Program, Program stages, program rules, Program indicators and legends.

Learn more about RDQA Program in the technical manual.

3. RDQA Analytics

The Analytics file contains two dashboards:

• Basic Dashboard: Displays four event reports and one pivot table indicating information such as number of assessments in a given period of time, main scores per health area and per donor and indicator.

• RDQA Data Quality Score, Data Verification & M&E Systems Assessment: Displays a pivot table per health with the 3 scores (Overall Data Quality score, Assessment Score and Data verification score). It also displays an event report with the data verification score per dimension per indicator.

Learn more about RDQA Analytics in the technical manual.

Metadata packages location

The three packages are located in the Metadata folder in this repository. Click here to open the folder.

Requirements for installation: User

The minimum roles for a user to import the metadata packages are summarized in the tables below:

1. For RDQA Server Attributes json file:

2. For RDQA Program json file:

3. For RDQA Program json file:

Installation

Download Packages

1. Open the Metadata folder located in this repository.

2. Click on the file and then click on the context menu (three dots).

3. Click on Download option

Importing packages

The same process applies to the three json files but it is important to upload the files in the following order:

1. RDQA Server Attributes

2. RDQA Program

3. RDQA Analytics - This package is optional. It does no affect the data capture behavior.

To import any file:

1. Open the Import/Export App

2. Select the Metadata Import button on the left side menu.

3. Select the correspondent json file.

4. Select JSON as the format.

5. Do a dry run before importing the file - This step will provide information if there is any incompatibility between your server and the file.

6. If the dry run is successful, start the import process.

7. Repeat the process for the next file.

Organisation unit assignment

Now that you have imported the files, it is necessary to add organisation units to the program to be able to capture data.

1. Open maintenance app

2. Open program and select the RDQA Program

3. In the Access Menu, select the capture org units

Sharing

All the packages are configured to have public access to the metadata but to be able to capture information:

1. Open the maintenance app.

2. Open program and select the RDQA Program.

3. Go to Access.

4. In the Roles and access section, click on the program’s name.

5. Click on Public access and change the DATA sharing to “Can capture and view” or add the users/user groups and change the data sharing to them.

6. Click on "Apply" and then click on "Apply to selected stages" to copy the sharing settings to all the stages.

7. Click on the save button to finish the process

Instead of having all the metadata public, it is highly recommended to create two user groups: The RDQA-Admin, which should have access to change metadata and the RDQA-User group, which will include all users that capture data.

To create a user group:

1. Open the user app

2. Select User group on the left side menu

3. Click in the "+" button

4. Write the name of the group and add all the users you need