@dhis2/analytics

Analytics

master

24.x

Overview

The analytics library contains components and modules that are used in DHIS 2 analytics apps, including:

• dhis2/dashboards-app
• dhis2/data-visualizer-app
• dhis2/maps-app
• dhis2/line-listing-app

Module layout documentation

Publishing

The analytics package is published to npm as @dhis2/analytics.

To publish, mark the commit using semantic release terminology (see notes below for branch-specific restrictions). Once committed, github actions will take care of publishing the new version to npm.

master branch

The master branch follows semantic versioning according to spec.

.x branches

Commits to .x branches (e.g. 24.x) cannot trigger a major version bump, even if it is technically a breaking change. This is because the next version has already been published. Additionally, branches that use .x for the patch version (e.g. 11.0.x, 2.4.x), cannot trigger a minor version bump. In the unlikely case that you need to commit a change that would trigger a version bump that's not possible, you will have to mark it to only trigger a patch or minor bump respectively, then make sure to update the apps that are locked to the .x version of analytics

Publishing pre-release versions during app development

Builds for all non-production branches are automatically copied to d2-ci/analytics for use during development and testing, prior to production release.

To test changes in a development branch, change the analytics dependency of package.json of the app you are testing with. There are a few options:

• point to a specific commit:

"dependencies": {
        "@dhis2/analytics": "git+https://github.com/d2-ci/analytics.git#70249ebe8be39051fa10142f850de449e1ec488c",
        ...
}

• point to a branch:

"dependencies": {
        "@dhis2/analytics": "git+https://github.com/d2-ci/analytics.git#chore/some-chore",
        ...
}

Report an issue

The issue tracker can be found in DHIS2 JIRA under the LIBS project.

Deep links:

• Bug
• Improvement
• New Feature
• Task

Changelog

28.0.1 (2025-05-20)

Bug Fixes

• translations: sync translations from transifex (master) (#1778) (7485bfc)
• upgrade Highcharts from v10 to v12 (#1728) (6598cad), closes #1731

Bug Fixes

• do not fetch subscribers as that should be fetched already (#1777) (af5868c)

BREAKING CHANGES

• As a quick workaround for renaming bugs, a solution was implemented where the preparePayloadForSave function would fetch the subscribers property so that it would not be overwritten during a rename. However, it is still possible to overwrite other newer changes by a different user. The best solution to deal with the lack of a PATCH is that each app fetches the entire visualization object prior to rename. Thus, the only job for the preparePayloadForSave function is to handle name and description changes.