docs: PI disaggregation categoryCombo note and section cleanup (DHIS2-18745) - #1776
Open
karolinelien wants to merge 5 commits into
Open
docs: PI disaggregation categoryCombo note and section cleanup (DHIS2-18745)#1776karolinelien wants to merge 5 commits into
karolinelien wants to merge 5 commits into
Conversation
… (DHIS2-18745) When setting up Program Indicator disaggregation directly via the metadata API instead of through the Maintenance app, the Program Indicator's own categoryCombo/attributeCombo must also be set to a Category Combination containing the mapped category, or the mapping won't display or be editable in this screen even though it still works in analytics. AI Assisted
…isaggregation section (DHIS2-18745) Corrects several issues in the program disaggregation mappings walkthrough found while cross-checking it against the Maintenance (Preview) app source: the section is actually grouped under "Programs" in the sidebar, not "Other". Also fixes broken step numbering, a typo, inconsistent Visualizer/visualization spelling, sizes the oversized retina screenshots consistently with the rest of the page, and adds notes on save-time mapping validation and the aggregate-export ID fields. AI Assisted
…IS2-18745) The app was renamed from "Maintenance (Preview)" to "Metadata Management" (metadata-management-app commit 77821e6, DHIS2-21090), which also changed its URL slug from maintenance-preview to metadata-management. Updates the PI disaggregation walkthrough to match. AI Assisted
karolinelien
marked this pull request as ready for review
August 5, 2026 13:32
DavidCKen
requested changes
Aug 6, 2026
DavidCKen
left a comment
DavidCKen
left a comment
Contributor
There was a problem hiding this comment.
The link I highlighted should be relative to the anchor, the wrong format was already in the file. and a lot of the screenshots should be changed to show the MMA not the maintenance app preview, do you want to do that in a combined PR or seperate?
|
|
||
| 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) | ||
| [Program Indicator functions and Variable operators](https://docs.dhis2.org/en/use/user-guides/dhis-core-version-242/configuring-the-system/programs.html#program_indicator_functions_variables_operators) |
Contributor
There was a problem hiding this comment.
Contributor
Author
There was a problem hiding this comment.
Fixed - now links to the internal anchor (#program_indicator_functions_variables_operators) instead of the external versioned URL.
… validation (DHIS2-18745) Expands the existing categoryCombo note after confirming against dhis2-core (ProgramCategoryMappingValidator / PiDisagInfoInitializer) that neither completeness nor duplicate-categoryId mappings are checked when a Program or Program Indicator is created/updated via the API - both only surface at analytics query time, and a categoryId collision currently crashes with an unhandled server error rather than a validation message. The Maintenance (Preview)/Metadata Management screen prevents this; the API does not. AI Assisted
…(DHIS2-18745) Per David's review comment on #1776: the target section already exists in this same book, so the link should be a relative anchor instead of an external versioned docs.dhis2.org URL. AI Assisted
Contributor
Author
|
Doing this as a combined PR - I'll swap the outdated Maintenance (Preview) screenshots for the current Metadata Management app in this same PR rather than splitting it out. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
categoryCombo/attributeCombomust also include the mapped Category, or the mapping won't show/be editable in the Maintenance app screen (though it still works in analytics)default)Test plan
#data_exchangeanchor, external JEXL reference) resolve correctly in the built siteAI Assisted