New versions of the Program Configuration App are constantly being released, implementing new features and improvements of previously added features. The PCA can be installed into a DHIS2 instance either downloading the compiled App or using the DHIS2 Apps Hub directly (recommended).
Latest Version
v2.0.7
Release date:
Key Features
Download Updated Template prompt.
Bug fixes.
Detailed Features
After importing an Excel Template (for Tracker or HNQIS 2.0 Programs) and saving changes, the PCA will prompt the user to download an updated Template, displaying a button to perform this action.
Bug Fixes
Fixed a bug that removed some Program and Program Stage settings after saving changes or Setting Up the Program Logic in the PCA interface.
Fixed an uncommon bug that caused the PCA to stop loading when a Program was configured as a Related Program to itself. This is a bug related to DHIS2.
Known Issues
Sometimes, changes in the contents of a Program Stage may not be reflected in the PCA. Reloading the page should fix this issue.
After transferring HNQIS 1.X Assessments to HNQIS 2.0, some Action Plan Events may display a conflict if the Event Date is set in the future. This issue resolves itself once the Event Date has passed.
Version History
v2.0.6
Release date:
Key Features
HNQIS 2.0 QoC Class calculation (A/B/C) is now performed in a Program Indicator.
Minor changes and bug fixes.
Bug Fixes
Custom Program Rule Variables are no longer removed when Setting Up Programs in Tracker and HNQIS 2.0.
Fixed a bug that removed Program Stage styling settings (Icon and Color) when importing Excel Templates.
Fixed a bug that removed some Program Stage Data Element configurations when importing Excel Templates.
An issue related to "Missing HNQIS 2.0 Metadata" has been addressed.
Known Issues
Sometimes, changes in the contents of a Program Stage may not be reflected in the PCA. Reloading the page should fix this issue.
After transferring HNQIS 1.X Assessments to HNQIS 2.0, some Action Plan Events may display a conflict if the Event Date is set in the future. This issue resolves itself once the Event Date has passed.
v2.0.5
Release date:
Key Features
Changed the way the PCA stores references of automatically generated objects.
Added an option to toggle HNQIS 2.0 Android Analytical Objects generation in the Program Settings. Defaults to "No".
Bug fixes and improvements.
Detailed Features
References of PCA automatically generated objects are now stored using DHIS2's Data Storage. This addresses missing references from some objects when editing using DHIS2's Apps like Event Reports, Pivot Tables, or Maintenance.
HNQIS 2.0 Analytical Objects generation is now optional and can be toggled On/Off within the HNQIS Settings section when editing HNQIS 2.0 Programs.
HNQIS 2.0 Score Calculations now use the Count function instead of CountIfZeroPos for compatibility purposes.
Bug Fixes
Fixed an issue related to the search bar in the Sharing Settings feature. Searching for specific Users or User Groups did not provide feedback on the matched results properly; this has now been addressed, and the search functionality works as expected.
Fixed a bug related to Aggregation Types in HNQIS 2.0 caused when an incompatible Value Type is selected while using Option Sets in Questions. The Aggregation Type is now correctly inferred using the selected Option Set.
Fixed a bug that removed Program Notifications configurations when validating and saving Programs.
Known Issues
Sometimes, changes in the contents of a Program Stage may not be reflected in the PCA. Reloading the page should fix this issue.
After transferring HNQIS 1.X Assessments to HNQIS 2.0, some Action Plan Events may display a conflict if the Event Date is set in the future. This issue resolves itself once the Event Date has passed.
v2.0.4
Release date:
Key Features
New Android Settings added to HNQIS 2.0 Programs configuration.
New Global Score Program Indicator in HNQIS 2.0 Programs.
HNQIS2 Metadata Package v1.1.4
Bugfixes.
Detailed Features
A new section in the New/Edit Program form has been added to include Android Setings in HNQIS 2.0 Programs. Now, the TEI download limit can be defined for each HNQIS 2.0 Program (used by the Android Capture App). This feature requires the Android Settings DHIS2 App to be installed in the server to apply the configurations during the "Set Up Program" process.
A new Global Score Program Indicator has replaced the Global Score Attribute in HNQIS 2.0 Programs. this change improves the usage and update of Analytics. Updating old HNQIS 2.0 Programs (by using the "Set Up Program" feature) is critical to ensure the correct operation of the Programs.
A new HNQIS 2.0 Metadata Package has been released to remove the Global Score Program Attribute. Installing the new package is required to use HNQIS 2.0 features.
Bug Fixes
Fixed a bug where applying Sharing Settings "too quickly" resulted in an error. The "apply" button is now disabled until all the metadata has been loaded.
Known Issues
Searching for Users and User Groups in the Sharing Settings dialog still remains an issue.
Sometimes, changes in the contents of a Program Stage may not be reflected in the PCA. Reloading the page should fix this issue.
After transferring HNQIS 1.X Assessments to HNQIS 2.0, some Action Plan Events may display a conflict if the Event Date is set in a future date. This issue resolves itself once the Event Date has passed.
Modifying the Line Listing that is generated automatically for the Dashboard in HNQIS2 Programs will cause the "Set Up Program" process to fail. This is a bug related to DHIS2 and will be addressed in a future version. A workaround is to delete the Line List manually to re-generate the analytics again.
v2.0.3
Release date:
Please Note: This version is supported on DHIS2 versions between 2.36.x and 2.40.x
Key Features
Extended compatibility to DHIS2 versions above 2.36.
Improved About Screen showing more details on the App’s source code and developers.
Bugfixes.
Detailed Features
The PCA is now compatible with DHIS2 2.36.x up to 2.40.x.
The in-app About Screen now displays more information on the source code (repository link included as well) and the App developers. A list of the main libraries used by the app and their licenses is also included.
Bug Fixes
Previously, there was a bug while importing HNQIS2 Templates. If a Data Element used an Option Set and was assigned a Value Type different to the Value Type of the Option Set, both values would be stored causing important bugs. Now, the Option Set overrides the Value Type of the Data Element, ignoring the Value Type (if provided).
Known Issues
Searching for Users and User Groups in the Sharing Settings dialog still remains an issue.
Sometimes, changes in the contents of a Program Stage may not be reflected in the PCA. Reloading the page should fix this issue.
After transferring HNQIS 1.X Assessments to HNQIS 2.0, some Action Plan Events may display a conflict if the Event Date is set in a future date. This issue resolves itself once the Event Date has passed.
v2.0.2
Release date:
Please Note: This version is supported on DHIS2 versions between 2.37.x and 2.40.x
Key Features
Various bugfixes and improvements.
HNQIS2 Metadata Package v1.1.3
Detailed Features
When Creating/Editing Data Elements, the ‘Form Name’ field is no longer required when when 'Use Auto Naming' is disabled in the Data Element.
Added WASH option to HNQIS2 Health Areas.
Bug Fixes
Editing and saving a HNQIS2 Program no longer removes Global Score Tracked Entity Attribute.
Fixed a bug when if an Option Set is assigned to a Label Data Element from the HNQIS2 UCT and imported into the PCA, the Android Capture App may present bugs. Option Sets are now ignored when a Data Element is set as “Label”.
Validations for this issue were also added to the UCT.
Known Issues
Searching for Users and User Groups in the Sharing Settings dialog still remains an issue.
Sometimes, changes in the contents of a Program Stage may not be reflected in the PCA. Reloading the page should fix this issue.
After transferring HNQIS 1.X Assessments to HNQIS 2.0, some Action Plan Events may display a conflict if the Event Date is set in a future date. This issue resolves itself once the Event Date has passed.
v2.0.1
Release date:
Please Note: This version is supported on DHIS2 versions between 2.37.x and 2.40.x
Key Features
Various bugfixes and improvements.
PCA Metadata Package v1.2.0
Detailed Features
The DB - Program Type Option Set is no longer required nor included with the PCA.
Import and Download Template button has now been separated for easier access.
Added steps navigation while creating and editing Programs.
Added scrollable preview while converting HNQIS Checklists to HNQIS2.
PCA Home Screen now has a new look.
HNQIS2 converted Programs now support the usage of Question Hide Group and Question Hide Type that was used for Parent Logic in old HNQIS 1.X Checklists.
Added a Clear Filter button when searching for existing Data Elements.
The Data Element Form Name maximum length is now validated based on the Data Element Prefix defined for the selected Program when creating and editing Data Elements. This only applies if the Name, Short Name and Code are automatically generated.
Bug Fixes
Correlatives no longer display an error when Saving and Validating Event/Tracker Programs if an Excel Template had never been imported before.
Program Tracked Entity Attributes Sections are now only available for Users with authority to create public Programs.
Fixed a bug that sometimes crashed the app when exporting HNQIS2 Templates.
Data Elements with empty Form Names no longer crash the H1 to H2 Conversion process.
Fixed a minor visual bug when editing Program Tracked Entity Attributes using the PCA UI.
Known Issues
Searching for Users and User Groups in the Sharing Settings dialog still remains an issue.
Sometimes, changes in the contents of a Program Stage may not be reflected in the PCA. Reloading the page should fix this issue.
After transferring HNQIS 1.X Assessments to HNQIS 2.0, some Action Plan Events may display a conflict if the Event Date is set in a future date. This issue resolves itself once the Event Date has passed.
v2.0.0
Release date:
Please Note: This version is supported on DHIS2 versions between 2.37.x and 2.40.x
Key Features
All of the Tracker Features previously implemented are now available for Event Programs.
The PCA now supports Export and Import of Tracker and Event Excel Configuration Templates.
Program Tracked Entity Attributes can now be ordered and configured while creating or updating Tracker Programs.
The Export JSON Metadata has been improved and now supports JSON Files customisation before download.
Detailed Features
The PCA now supports enabling/disabling Auto-Naming for Data Elements in Tracker and Event Programs, this feature is also supported within the Tracker/Event Template.
The PCA now supports Show/Hide Program Rules in Tracker and Event Programs using the Excel Template. These Program Rules are automatically generated in DHIS2 during the Build Program Rules process.
All Programs and Program Stages can be navigated by clicking on them instead of clicking the ▶️ icon as in previous versions, this icon has now been removed.
Event Programs within the PCA now support all the previously enabled Tracker features like: editing Program configurations, creating and updating Program Stage Sections and Data Elements, assigning Sharing Settings and Organisation Units, creating and restoring Backups, as well as Exporting JSON Metadata.
The matching results displayed in the List of Programs are now ordered prioritising the Program Name when a filter is applied.
The PCA now supports changing the Program Indicator Aggregation when creating or updating HNQIS2 Programs.
The PCA now supports the addition and deletion of Program Sections (for Tracked Entity Attributes), as well as reordering and assigning Tracked Entity Attributes to these sections in Tracker Programs.
The Tracker/Event Template allows for the creation, update and removal of Data Elements and Program Stage Sections in bulk. In the case of Tracker Programs, the Template also supports the creation, update and removal of Tracked Entity Attributes and Program Sections.
The Export JSON Metadata has been enhanced to streamline the process of exporting and importing Programs. A Target Server field has been added that automatically preselects the configuration for exporting Programs, either for the current server or for another server. For HNQIS2 Programs, the 'HQNSI2-Enabled server' option is enabled, ensuring error-free Program importing on servers that already host HNQIS2 Programs.
The last filter applied while searching in the List of Programs is now stored to display the same results while navigating the PCA.
PCA Metadata Package v1.1.2
Bug Fixes
The PCA no longer crashes when no Programs are available on the server.
The Sharing Settings Section no longer crashes when a program has no Data Elements assigned to it.
The Program Metadata in the Program Stage Section List is now refreshed after Editing the Program Configuration.
The Organisation Units Selector no longer presents performance issues, even if the server has a large amount of Organisation Units.
Transfering Programs from one server to another no longer produce an error in the Edit Program page if the Organisation Unit ID's are not available in the Target Server.
If a Program does not have any Data Elements, the Sharing Settings are applied correctly.
Restoring a Program Backup while selecting the Restore Options setting no longer results in an error
Clearing the filter in the Assing Organsation Units window no longer crashes the App.
Known Issues
Searching for Users and User Groups in the Sharing Settings dialog still remains an issue.
Sometimes, changes in the contents of a Program Stage may not be reflected in the PCA. Reloading the page should fix this issue.
The HNQIS 2.0 conversion process may fail if the original HNQIS 1.X Program contains one or more Data Elements that lack a Form Name property.
After transferring HNQIS 1.X Assessments to HNQIS 2.0, some Action Plan Events may display a conflict if the Event Date is set in a future date. This issue resolves itself once the Event Date has passed.
Program Tracked Entity Attributes changes on Tracker Programs are kept (but not persisted) even if the Form is not submitted. Reloading the Program Settings form fixes this issue.
Converting HNQIS 1.X Programs to HNQIS 2.0 may present issues if the original HNQIS 1.X Program is too old.
v1.6.3
Release date:
Key Features
Fixes for DHIS2 v2.36.13
DHIS2 max server version updated
PCA Metadata Package v1.1.1
Known Issues
Searching for Users and User Groups in the Sharing Settings dialog still remains an issue.
Sometimes, changes in the contents of a Program Stage may not be reflected in the PCA. Reloading the page should fix this issue.
The Organisation Units selector may present some performance issues if the server has a large amount of Organisation Units.
Clearing the filter in the Assing Organsation Units window sometimes crashes the App, this issue is still under investigation.
Transfering programs from one server to another can produce an error in the Edit Program page if the Organisation Unit ID's are not available in the Target Server.
Sometimes, restoring a Program Backup while selecting the ‘Restore Options’ setting throws an error.
Converting HNQIS 1.X Programs to HNQIS 2.0 may present issues if the original HNQIS 1.X Program is too old.
If a Program does not have any Data Elements, applying Sharing Settings will result in an error.
v1.6.2
Release date:
Key Features
HNQIS 2.0 Import Template bugfixes.
HNQIS 2.0 automatic Program Indicator codes fixed.
Detailed Features
Fixed a bug that caused configurations loss in Data Elements when importing a downloaded Template: After importing, the values in the Data Element Attributes and the Sharing Settings were removed.
Changed the naming convention for the Codes of Program Indicators generated by the PCA for HNQIS 2.0 Programs.
HNQIS2 Metadata Package v1.1.2
Known Issues
Searching for Users and User Groups in the Sharing Settings dialog still remains an issue.
Sometimes, changes in the contents of a Program Stage may not be reflected in the PCA. Reloading the page should fix this issue.
The Organisation Units selector may present some performance issues if the server has a large amount of Organisation Units.
Clearing the filter in the Assing Organsation Units window sometimes crashes the App, this issue is still under investigation.
v1.6.1
Release Date:
Key Features
Added HNQIS 2.0 and PCA Documentation links.
Authorities detection before HNQIS 2.0 Program Set Up.
HNQIS 1.X Conversion and Data Transfer fixes and new functionalities.
Improved UI.
Detailed Features
When converting HNQIS 1.X Programs, a Legend Set is automatically added to the scored Data Elements (must include numerator and denominator) in the HNQIS 2.0 Program.
Fixed some important Metadata conversion bugs when converting from HNQIS 1.X to HNQIS 2.0.
Fixed some important Data integrity bugs when transferring data from HNQIS 1.X to HNQIS 2.0.
HNQIS 2.0: Added a warning during "Set up Program" if the user lacks the "All" authority.
PCA Documentation is now accessible from the "About PCA" window.
HNQIS 2.0 Documentation is now accessible from the "HNQIS 2.0 Status" window.
Improvements in the UI and UX.
QoL improvements.
Minor Bugfixes.
HNQIS2 Metadata Package v1.1.1
Known Issues
Searching for Users and User Groups in the Sharing Settings dialog still remains an issue.
Sometimes, changes in the contents of a Program Stage may not be reflected in the PCA. Reloading the page should fix this issue.
The Organisation Units selector may present some performance issues if the server has a large amount of Organisation Units.
Clearing the filter in the Assing Organsation Units window sometimes crashes the App, this issue is still under investigation.
v1.6.0
Release Date:
Key Features
HNQIS 1.X Program Conversion to HNQIS 2.0.
HNQIS 1.X Data Transfer to HNQIS 2.0.
HNQIS 2.0 Global Analytics and Dashboards generation.
Event and HNQIS 1.X Programs visualization.
Improved UI.
Detailed Features
HNQIS 1.X and Event Programs are now visible in the PCA Programs List.
HNQIS 1.X Programs can now be converted to HNQIS 2.0 using the PCA interface. The converted program is a copy of the original HNQIS 1.X version, meaning that the original is not lost in the process.
HNQIS 1.X Event Data (Assessments and Action Plans) can be transferred to the new HNQIS 2.0 version of the Program. The original data is copied into the HNQIS 2.0 Program, meaning that the original Assessment Data is not lost.
Event Programs are now displayed in the Programs List. Sections and Data Elements can now be Added, Edited and reordered using the PCA.
HNQIS 1.X Programs are now displayed in the Programs List. These are Read Only.
Global Analytics and the Program Dashboard are now generated during the Set Up Program process. The generation of the Global Analytics require new configurations in the Program, which means that existing Programs must be edited using the PCA to add the new required configurations.
New configrations required to create new HNQIS 2.0 Programs: Organisation Unit Root for Global Analytics, Organisation Unit Level for the Visualizations and Organisation Unit Level for the Map. These are used when creating the Global Analytics.
Assign Organisation Units: Search Feature now implemented.
HNQIS 2.0 Validations: Fixed Form Name validations for Labels.
Improvements in the overall UI and UX.
Many other QoL improvements.
Several bugfixes.
PCA Metadata Package v1.1.0
HNQIS2 Metadata Package v1.1.0
Known Issues
Searching for Users and User Groups in the Sharing Settings dialog still remains an issue.
Sometimes, changes in the contents of a Program Stage may not be reflected in the PCA. Reloading the page should fix this issue.
The Organisation Units selector may present some performance issues if the server has a large amount of Organisation Units.
Clearing the filter in the Assing Organsation Units window sometimes crashes the App, this issue is still under investigation.
HNQIS 2.0: Enabling In-App Analytics will fail if the user lacks the "All" authority, This is caused due to how the Android Settings App interacts with DHIS2.
v1.5.0
Release date:
Key Features
Generation of Competency Class and Quality of Care in-app analytics for HNQIS 2.0 Programs.
Creation and Restore of Program Backups (snapshots).
Detailed Features
Competency Class and Quality of Care indicators and visualizations are now generated during the Set Up Program process. If the Android Settings app is enabled in the server, those visualizations are also configured as in-app analytics for the Android Capture App.
Every Program now has the option to create and store multiple backups with the current configurations.
Program backups can be restored completely or partially.
More Program Details can now be displayed in the Programs List.
Fixed a bug that blocked Health Areas from displaying while editing HNQIS 2.0 programs.
Many other QoL improvements.
PCA Metadata Package v1.0.1
HNQIS Metadata Package v1.0.1
Known Issues
Searching for Users and User Groups in the Sharing Settings dialog still remains an issue.
Sometimes changing the Competency Class usage while editing a HNQIS 2.0 program causes Data Elements duplication in the Critical Steps Calculations section. Reloading and opening the Edit Program form again and saving seems to fix the issue.
v1.4.0
Release Date:
Key Features
Tracker Programs Creation, Editing and customization is now possible.
In-app Sharing Settings and Org Unit Assignment now available.
In-app PCA and HNQIS Metadata Checker + Installer.
Detailed Features
If the PCA detects that the minimal Metadata requirements are not met, an installation prompt will be displayed.
The HNQIS Metadata Package can now be checked and installed from the HNQIS 2.0 Status option in the settings menu of the PCA.
The current status of the PCA can now be checked selecting the About PCA option in the settings menu of the PCA.
Any Program can now be edited to change its configurations.
Programs can be filtered by using UID, Name, Short Name or Code by using the new Search Bar.
Programs are now identified by displaying the Program Icon and Color.
The Program Type is now displayed in the Programs List, that no longer displays only HNQIS 2.0 Programs.
Both Tracker and HNQIS 2.0 Programs creation is now supported by the PCA.
Creating a new program filters the programs list to highlight the new Program.
Program Icons and Colors can now be customized while creating and editing Programs.
The Sharing Settings of Programs, Program Stages and Data Elements can now be modified in-app.
The Organisation Units Access of Programs can now be modified in-app.
Accessing program that is not labeled as HNQIS 2.0 will enable Program Stages Creation and Editing.
Basic Form Stages can now be accessed, but Editing is not supported yet.
Any Program Stage can now be accessed, changing the navigation bar options depending on the selected Program's Type.
HNQIS Programs display the Validate, Set Up Program, Download Template, Import Template and Reload buttons.
Tracker Programs display the Save Changes and Reload buttons.
Shortcuts to the Maintenance App for creating new Legend Sets and Option Sets have been added to the Data Element Creation/Editing Form.
Non-HNQIS Data Elements can now be created.
Data Elements now have an option to display Program Rules Triggered by the Data Element and Program Rules that Affect the Data Element.
Many other QoL improvements.
Known Issues
Searching for Users and User Groups in the Sharing Settings dialog currently has an issue. Typing duplicate letters and then deleting one seems to fix the issue.
v1.3.1
Release Date:
Bug Fixes
Imported Template processing fixes.
v1.3.0
Release Date:
Key Features
Program export - JSON format, including core HNQIS2 metadata.
In-app Data Element management (DHIS2 + HNQIS2 metadata).
In-app Program Stage Section management.
Detailed Features
In-app section management: creation, editing, removing of program sections.
In-app data element management (DHIS2 core attributes & HNQIS2 attributes): Creation, editing, adding existing ones, removal of Data Elements from Program.
Programs JSON file export functionality: Uses core export api, but removes sharings, and adds Legends into a single JSON file. This allows to import a HNQIS program into any DHIS2 server.
Upgraded UI to Material Design.
The PROGRAM_TYPE attribute is now assigned dynamically based on servers configurations.
Added action notifications to improve UX.
New validations included:
Feedback Order gaps.
Duplicated Feedback Orders.
Bug Fixes
Removed [C] from critical questions Form Names when downloading templates.
Fixed Legends assignment when downloading Excel templates and updating programs
Fixed a bug where the Health Area in the Excel Template Instructions Tab was always assigned to Family Planning instead of the real Health Area of the Program.
v1.2.1
Release Date:
Bug Fixes
Minor fixes while downloading Excel templates.
Fixed Create New Program UI.
v1.2.0
Release Date:
Features
Create new program from home screen (HNQIS Program)
When an error occurs while Setting up programs (magic button), the process will stop and a new Errors Summary section will appear
The downloaded copy now has the name of the program and the date and time when it was downloaded, for example: XX HNQIS2 Family Planning Counselling - 2022-02-22 [12h 34m].xlsx
New progress indicators are displayed when Setting Up program
Bug Fixes
Fixed an issue with the program rules that caused errors when creating an Action Plan event in the HNQIS2 programs
The download template now downloads only 1 copy of the excel file
Parent names now are updated correctly when reordering questions/sections in the Program Config App
Other small fixes
v1.1.0
Release Date:
Features
Excel template download filled with current assesment’s data
Import Excel template and display new content/values
Improved error display for validations and processing
A new section will appear detailing the errors that caused the "Process ended with errors message"
Added a validation in both the Excel Template and the Config App for the Form Names length (Minimum of 2 and Maximum of 220 charaters).
Added a [C] to the end of the Form Names when a question is critical, this is used to identify which questions are configured as such when the users are working with the checklists.
v1.0.0
Release Date:
Features
Home screen as a Program listing (HNQIS Programs only)
Program Stage Listing for selected program
Section/Data Elements listing for Assessment Stage
Drag and Drop Functionality
Reordering sections
Reordering data elements within the same section
Drag and drop data element between sections
Validations applied
On Excel file while editing
Web Validations when saving changes
Persist changes after reordering sections/data elements (save to dhis2 instance)
Program Rules building automation (program rules related to scoring processes on HNQIS2 Programs)
Add Comment