Skip to content

Update program_indicator_disaggregation.md #125

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
DavidCKen merged 1 commit into from
Nov 19, 2025
Merged

Update program_indicator_disaggregation.md #125

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
79 changes: 2 additions & 77 deletions content/maintenance_use/program_indicator_disaggregation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,81 +10,6 @@ The Program Indicator Disaggregation mappings, defined at the Program level, pro

![Table Example](resources/images/Table_Example.png){ .center width=30% }

The following sections will illustrate how this new feature can be used.
How to configure program indicator disaggregation can be viewed in the [user guide]
(#program_disaggregation_mapping)

## Setting up new Program disaggregation Mappings

1. Install or update the new Maintenance app (Preview)

If the your instance does not already have the new version of the maintenance app installed go to the App Management App and search for Maintenance in the App Hub and install the app. If you already have it installed, then you should update the app to the latest version. Updates to this app are continuously released so it is good to make sure that you are using the most recent release.

![Note Version 0.63.0 might be superseded by a newer version by the time you read this, update to the latest](resources/images/App_Management_Maintenance_App_Preview.png)


2. Load the Program Disaggregation section of the Maintenance (Preview) App by selecting Program Disaggregations under the Other section or browsing to _yourinstanceurl_/apps/maintenance-preview#/programDisaggregations/

![Program Disaggregation screen](resources/images/Maintenance_App_PI_Disaggregation.png)

3. Select a Program from the drop down to enter the edit section and add Mappings to, for this example we will use the **Inpatient morbidity and mortality** program

4. This will load the Program Indicator Mapping and Categories definition screen

![Program Indicator Selection](resources/images/Edit_PI_DIsaggregation.png)

3. Select a Program Indicator from the drop down list, in this example we will use **BMI**

4. Under Disaggregation category combination Select **Gender and U5y** (you may need to create a new category combination containing the categories **Gender** and **Under 5/5 and above of age** if not present)

![](resources/images/Disaggregation_Category.png)

Loading this category combination will display the Mapping selection drop down for each of the categories defined, as this is the first time these categories have been selected there are no mappings currently available.

7. Under the Disaggregation categories section you should see both of the categories from the combination added as suggestion. Click **Add category** for both both **Gender** and **U5y**

![](resources/images/Disaggregation_Mappings.png)


## Create the category mappings

8. In the text field under each Category enter an expression using the Program Data Elements and Attributes that defines the category. The expression uses the same syntax as the Filter section of the Program Indicator creation screen. It is recommended to open a Program Indicator within the Program you are mapping, use the Filter screen to construct the expression and then copy it into this field. This allows you to use the inbuilt expression validation of the Program Indicator filter builder.
[Program Indicator functions and Variale operators](https://docs.dhis2.org/en/use/user-guides/dhis-core-version-242/configuring-the-system/programs.html#program_indicator_functions_variables_operators)

![](resources/images/Disaggregation_Mappings_Expanded.png)
![](resources/images/Program_Indicator_Filter_Expression.png){ .center width=30% }

This example is linking the value selected in the **Gender** data element in the Program to the category option. Since the Option set in this case is a text field the expression is set to match the text ‘Female’. The next example for age shows a different way to define the relationship.

![](resources/images/PI_Disaggregation_Gender_Mapping.png)

To add the mapping for the Under 5 years and 5 years and above, since it is a numerical field you can use the operators `>` `>=` `<` `<=` `==` `!=` to define the relationship

![](resources/images/PI_Disaggregation_Age_Mapping.png)

10. When mappings for all the category options click Save and exit


11. Open Data Visualizer, first let’s look at how these data were previously displayed. To do this create a visualisation to show the data of the 5 existing Program indicators with the built in disaggregations shown below.

![](resources/images/DV_Before.png){ .center width=30% }

![](resources/images/DV_Before2.png)

12. Now remove the 4 Program Indicators with disaggregations specified and leave only the BMI Program Indicator.

![](resources/images/DV_only_PI.png)

14. You can now add **Gender** and **Under 5/5 and above of age** as disaggregation categories from the Your Dimensions column for the Program Indicator, click update and see the results.

![](resources/images/DV_PI_Disaggregated.png)

You can now compare the data from the two separate program indicators and the single program indicator that has been disaggregated.

# Transferring Program Indicator data via the Aggregate data exchange app

In addition to viewing a disaggregated Program Indicator in the Data Visualiser you can now transfer the Program Data, via the Disaggregated Program indicator, into a Data Element that shares the same Category Combination.

![](resources/images/PI_Disaggregation_Data_Exchange.png)

By adding the ID of a Data Element in the **Data element for aggregate data export** field and then setting up the aggregate data exchange app* to transfer data you can save Program data in the aggregate data model

![](resources/images/PI_Disaggregation_DE_for_Data_Exchange.png)
Loading