New Release: DHIS2 Cancer Registry Toolkit in collaboration with Vital Strategies and IARC

Announcements - Annonces
,
1

400x33

We are pleased to announce the release of the DHIS2 Cancer Registry Toolkit, developed in collaboration with Vital Strategies and the International Agency for Research on Cancer (IARC) to support countries in establishing and strengthening population-based cancer registration within national HMIS platforms.

The toolkit operationalizes international standards for cancer registration by consolidating case-based data collection, ICD-O-3 coding, and built-in data quality checks into a harmonized DHIS2 configuration. By integrating cancer registry functions within existing national DHIS2 infrastructure, the toolkit helps programmes reduce reliance on standalone registry software, strengthen data quality at the point of entry, and improve the availability of reliable cancer incidence data for cancer control planning.

The DHIS2 Cancer Registry Toolkit provides a reference configuration based on the DHIS2 Tracker data model, grounded in IARC’s Cancer Registration: Principles and Methods (Scientific Publication No. 160). A key component of the toolkit is a dedicated custom web application that bridges DHIS2 and CanReg5 — the cancer registry software developed by IARC and widely used by population-based registries worldwide. The application extracts cancer case data from the DHIS2 Tracker program and transforms it into a format directly importable into CanReg5, handling the structural differences between the two systems and consolidating patient, tumor, and source records into a single output file. This enables registries already using CanReg5 for analysis and reporting to continue doing so, while benefiting from DHIS2 as a national data collection and HMIS integration platform.

By combining the DHIS2 Tracker data model with a dedicated CanReg5 interoperability application, the toolkit supports national cancer registries in building sustainable, high-quality cancer surveillance capacity — contributing to progress toward SDG 3.4 and national cancer control priorities.

:page_facing_up: System Design Guide and Installation Guide: Available here

:laptop: Custom Web Application

:bar_chart: Demo: Explore this new toolkit directly within the DHIS2 demo environment to understand its functionalities and adaptability

:rocket: Launch Webinar: Watch the recording here

:open_file_folder: Metadata packages are also available for download and customization for your country or organization via the DHIS2 metadata download section.

7 Likes
Upcoming Webinar Series: DHIS2 Cancer Registry Toolkit // Français + Español live interpretation
Nouvelle publication : Boîte à outils DHIS2 pour les registres du cancer, en collaboration avec Vital Strategies et le CIRC
3

Many thanks Stefano and the team for the DHIS2 Cancer Registry toolkit. Clicking the DHIS2 demo enviroment returns an error code 502, Bad Gateway. Is there a way the team can help with this, thank you.

1 Like
4

Dear @Francis_Okongo,
I have tested the link and it’s working correctly from my end.
The url is: https://demos.dhis2.org/hmis
It’s still not working?

1 Like
5

Dear Stefano, the link is now working perfectly and we are now able to explore all the data elements and organizational units for customization into our local context while preserving the check logics. We look forward to webinar 2 on the installation and set up of DHIS2 Cancer Registry Instance/Enviroment. Once again many thanks for the support, blessings.

1 Like
6

Hey @Stefano , I too can not access the cancer registry program through Capture. Is there anything wrong?

1 Like
7

Dear @duserik,

I have accessed with the demo user in the demo instance and I can access to the program in the capture app.

There could be a caching problem, have you clean the cache of your browser?

1 Like
8

I had to finally use the Incognito windows instead, cleaning cache didn’t seem to work. Thanks

1 Like
9

Dear community,

We have released version 1.0.1 of the Cancer Registry tracker package. This is a corrective patch on top of 1.0.0. No edit-check logic has changed — every check behaves exactly as before. We recommend all implementations running the package upgrade.

What changed and why

Fixed: records could fail to save with an HTTP 500 / StackOverflowError. Several program-rule conditions in the package were written as very long flat boolean chains (one condition had 615 chained || terms). The DHIS2 expression engine evaluates these recursively, and the longest chains exhausted the server’s JVM thread stack during rule evaluation on save — so affected records could not be saved.

We rewrote the 22 affected conditions into balanced expressions: the operands, operators, rule actions, priorities and UIDs are unchanged — only the grouping parentheses differ. This reduces the evaluation depth from linear to logarithmic (the worst case went from ~615 to ~12), which removes the crash. The change was verified as behaviour-preserving (operand/operator preservation plus equivalence fuzz-testing across tens of thousands of evaluations — zero differences vs 1.0.0).

Program-rule cleanup. The release also tidies up the program-rule set; the corrected rules ship with 1.0.1.

Upgrading

  • The new version is available in the Download section of the package documentation.
  • Full details — the affected rules, verification, and upgrade steps — are in the release notes included with the package.
  • As always, test in a staging instance before applying to production.

If you have any questions about upgrading, reply here and we’ll be glad to help.

1 Like