dhis2-devs team mailing list archive

[Lars Helge Øverland <lars@xxxxxxxxx>]

Hi all,

DHIS version 2.25 is out with a lot of new features, apps and improvements.

Log in with admin/district on the demo <http://play.dhis2.org/demo/> system.


ANALYTICS FEATURES

---

External map layers: The GIS app now supports TMS (Tile Map Service), XYZ
and WMS (Web Map Service) layers. These are all popular protocols for map
data and there are numerous map services available, allowing you to display
maps for rivers, roads, weather, land data and everything else. External
map layers can be set up from the Maintenance app, and then be accessed
from the top bar in the GIS app.

Docs GIS
<https://dhis2.github.io/dhis2-docs/master/en/user/html/using_gis_external_map_layers.html>
| Docs setup
<http://dhis2.github.io/dhis2-docs/master/en/user/html/manage_ext_maplayer.html>
| Screenshot 1
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/external-map-layer-terrain.png>
| Sc 2
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/external-map-layer-arial-imagery.png>
| Sc 3
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/external-map-layer-dark-basemap.png>
| Sc Setup
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/external-map-layer-setup.png>
| Demo 1
<https://play.dhis2.org/demo/dhis-web-mapping/index.html?id=mZKtu7sY0w4> | Demo
2 <https://play.dhis2.org/demo/dhis-web-mapping/index.html?id=qTfO4YkQ9xW>


Push analysis: You can now push data analysis in the form of reports,
charts and maps to your users over email. This allows for improving
awareness and visibility of your data, and can encourage people to more
actively look at analysis. Push analysis is based on dashboards, and can be
set up, run and scheduled from the Maintenance app. You can also run
immediately and preview from the the context menu.

Docs
<https://dhis2.github.io/dhis2-docs/master/en/user/html/manage_push_reports.html>
| Screenshot 1
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/push-analysis-2.png>
| Sc 2
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/push-analysis-1.png>
| Demo
<https://play.dhis2.org/demo/dhis-web-maintenance/#/list/otherSection/pushAnalysis?_k=e5iaox>


Indicator as filter: A single indicator or data set reporting rate can now
be used as filter in charts and pivots. This allow you to create charts for
example with multiple periods and organisation units.

Docs
<https://dhis2.github.io/dhis2-docs/master/en/user/html/data_vis_series_category_filter.html>
| Screenshot
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/analytics-indicator-filter.png>
| Demo
<https://play.dhis2.org/demo/dhis-web-visualizer/index.html?id=D3oOqWAM0az>


Dashboard translations: The names of dashboards can now be translated,
meaning you can have dashboard names appear in user’s local language.

Docs <https://dhis2.github.io/dhis2-docs/master/en/user/html/ch06s06.html>
| Screenshot
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/dashboard-translation.png>


Deep linking of favorites: When opening favorites in the Pivot Table and
Visualizer apps, the browser address bar URL will reflect the current
favorite. This allows for easy sharing of favorites through
copy-and-pasting the URL.

Screenshot
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/analytics-favorites-deep-linking.png>
| Demo <https://play.dhis2.org/demo/dhis-web-pivot/?id=EEfRdOUzScm>


Chart rendering: The chart rendering engine has been rewritten from scratch
and now looks better, renders faster and will allow for new chart types in
the coming releases. The Data Visualizer app’s favorite solution has also
been upgraded.

Screenshot
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/analytics-chart-engine.png>
| Demo
<https://play.dhis2.org/demo/dhis-web-visualizer/index.html?id=tZCI4NSC8dc>

Favorite description: You can now specify description for pivot table and
chart favorites. This allows you to add more information such as the
purpose and method to interpret the analysis favorite. You can also store
titles for pivot tables. Click rename to change it.

Screenshot
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/analytics-favorite-title-description.png>
| Demo
<https://play.dhis2.org/demo/dhis-web-visualizer/index.html?id=Riq1WfQCaVo>


Interpretations in analytics apps: The Pivot Table and Visualizer apps now
have a right-side panel where you can see details and interpretations for
the current favorite. Click the right-side arrow to open the panel.

Docs
<https://dhis2.github.io/dhis2-docs/master/en/user/html/ch12s04.html#d0e12089>
| Screenshot
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/analytics-right-panel.png>
| Demo
<https://play.dhis2.org/demo/dhis-web-visualizer/index.html?id=R9A0rvAydpn>


Data analytics export as raw data: The analytics API now lets you produce
aggregated data exports in the raw data value set format. This is useful
for data exchange, e.g. you can aggregate data in a source system from
facility to district and from months to quarters, and combine data elements
using aggregate indicators or program indicators, before importing as raw
data values in the destination system. You can try it out using the Pivot
table app from Download > Advanced > Data value set XML.

Docs
<https://dhis2.github.io/dhis2-docs/master/en/developer/html/webapi_analytics.html#webapi_analytics_data_value_set_format>
| Screenshot
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/analytics-data-value-set.png>
| Demo
<https://play.dhis2.org/demo/api/analytics/dataValueSet.xml?dimension=dx:Uvn6LCg7dVU;OdiHJayrsKo&dimension=pe:LAST_4_QUARTERS&dimension=ou:O6uvpzGd5pu;fdc6uOvgoji&displayProperty=NAME>



GENERAL FEATURES

---

Flexible disaggregation: Data elements can now be disaggregated differently
for each data set they are part of. Put differently, a data element can be
linked to multiple category combinations. When assigning a data element to
a data set, you can define which category combination to use. This is
useful in order to reuse data elements, for instance when different
provinces in a country employ different data disaggregation, or when the
disaggregation change from year to year.

Docs
<https://dhis2.github.io/dhis2-docs/master/en/user/html/manage_data_sets.html#data_set_override_cat_combo>
| Screenshot setup
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/flexible-disaggregation-setup.png>
| Form 1
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/flexible-disaggregation-1.png>
| Form 2
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/flexible-disaggregation-2.png>
| Demo <https://play.dhis2.org/demo/dhis-web-dataentry/index.action>


Soft data value delete: Data values are now “softly” deleted, meaning they
are marked as deleted in the database rather than permanently removed. A
new field deleted has been introduced for data values which is set to true
for deleted values. Softly deleted data can optionally be included when
requesting data through the API by setting the includeDeleted param to
true. This allows clients, such as Android apps and third-party systems, to
react when data has been deleted in DHIS 2.

Docs
<https://dhis2.github.io/dhis2-docs/master/en/developer/html/webapi_data_values.html#webapi_reading_data_values>


Data value audit: The data value import process now generates data value
audit records. This allows for proper auditing of data being ingested from
bulk data imports.

Docs
<https://dhis2.github.io/dhis2-docs/master/en/developer/html/webapi_auditing.html>


Predictors: A new data predictor feature allows you to generate data values
based on an expression and several other parameters. This is useful for
generating targets, thresholds and predicted data in the future.

Docs
<http://dhis2.github.io/dhis2-docs/master/en/user/html/manage_predictors.html>
| Demo
<https://play.dhis2.org/demo/dhis-web-maintenance/#/list/otherSection/predictor?_k=eoqgly>


Profile: The profile section has been rewritten and has received the new
and modern look.

Docs <https://dhis2.github.io/dhis2-docs/master/en/user/html/ch28.html> |
Demo <https://play.dhis2.org/demo/dhis-web-user-profile/#/profile?_k=c6i8qi>


Maintenance: The Maintenance app now includes configuration of tracked
entity attributes, tracked entity attribute groups, relationship types and
tracked entities.

Docs
<https://dhis2.github.io/dhis2-docs/master/en/user/html/manage_program_metadata.html>
| Demo
<https://play.dhis2.org/demo/dhis-web-maintenance/#/list/all?_k=ym3nhk>



TRACKER FEATURES

---

Reminders and notifications: A new notification solution allows for setting
up reminders for upcoming events and notifications for missed events in
tracker programs. Reminders can be sent before and after scheduled events,
directly to people and DHIS2 users. Also, notifications can be sent on
program enrollments and enrollment completion. Messages can be delivered by
SMS, email and as DHIS2 messages.

Docs
<https://dhis2.github.io/dhis2-docs/master/en/user/html/program_notifications.html>
| Screenshot 1
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/program-stage-notification.png>
| Sc 2
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/program-stage-missed-visit-notifcation.png>
| Sc 3
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/program-enrollment-notification.png>


Organisation unit value type: A new value type organisation unit has been
introduced, allowing you to select organisation units for attributes and
data elements in Event Capture and Tracker Capture apps. This means that
you can associate multiple organisation units to an event which is useful
e.g. to store place of infection in addition to place of treatment. Try it
out with the Inpatient morbidity mortality program.

Docs
<https://dhis2.github.io/dhis2-docs/master/en/user/html/manage_data_element.html#d0e3524>
| Screenshot
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/organisation-unit-value-type.png>
| Demo <https://play.dhis2.org/demo/dhis-web-event-capture/index.html#/>


Capture location of enrollment: You can now capture the coordinate /
location of an enrollment. This allows you to know where an enrollment took
place. The location map widget is based on OpenStreetMap. This can be
enabled through the capture coordinates property in program maintenance.

Screenshot
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/enrollment-location-map-widget.png>


Mapzen-based location search: In the location map widget you can now search
for most addresses in the world and store the coordinate of the location.
Click the magnifier icon in the top left corner of the map widget and start
typing your address. Try it out by clicking register, then click on the get
from map icon next to coordinate.

Screenshot
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/location-mapzen-search.png>
| Demo
<https://play.dhis2.org/demo/dhis-web-tracker-capture/index.html#/?program=IpHINAT79UW>


Deletion of tracked entity instances: Tracked entity instances can now be
permanently deleted. This means all related records, including enrollments,
events and audit records will be removed.

Screenshot
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/tracker-delete-tei.png>


Messaging widget: The tracker person dashboard now has a messaging widget
which allows for sending messages directly to the person using email or
SMS. The contact info is automatically fetched from the person profile, and
can also be specified directly in the widget.

Docs <https://dhis2.github.io/dhis2-docs/master/en/user/html/ch26s10.html>
| Screenshot
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/tracker-messaging-widget.png>
| Demo
<https://play.dhis2.org/demo/dhis-web-tracker-capture/index.html#/dashboard?tei=kI7ZesK1loF&program=IpHINAT79UW&ou=DiszpKrYNg8>


Locking for completed events: Completed events can now be automatically
locked for further modification after a given number of days. This can be
configured per program through the completed events expiry days field. For
example: if expiry days is set to 7, then events which have been completed
more than 7 days ago can no longer be edited.

Docs
<https://dhis2.github.io/dhis2-docs/master/en/user/html/manage_tracker_programs.html>


Event locking per program: In the Event Capture and Tracker Capture apps,
time periods can be locked in order to prevent new events to be added. This
is configurable through the expiry days and expiry period type properties,
which controls the number of days after a period of a specific period type
for which events can still be added. For example: if expiry days is 7 and
expiry period type is monthly; new events can be added for a month up to 7
days after the end date of that month.

Docs
<https://dhis2.github.io/dhis2-docs/master/en/user/html/manage_tracker_programs.html>


Configurable columns: In the Tracker Capture app, the columns to display in
the list of tracked entity instances can be selected and remembered per
user. In the Event Capture app, the columns to display in the list of
events can be selected.

Docs <https://dhis2.github.io/dhis2-docs/master/en/user/html/ch23s08.html>
| Screenshot 1
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/tracker-configurable-columns.png>
| Sc 2
<https://s3-eu-west-1.amazonaws.com/content.dhis2.org/releases/screenshots/25/event-capture-configurable-columns.png>



HOSTING FEATURES

---

Web server clustering: This release allows for deploying DHIS2 in a web
server cluster. When configured appropriately, each node in the cluster
will ensure that the application caches of the other nodes are kept in
sync. Up to 5 nodes can be configured, allowing for web server horizontal
scalability. For each node, the hostname of the other nodes must be
configured.

Docs
<https://dhis2.github.io/dhis2-docs/master/en/implementer/html/install_web_server_cluster_configuration.html>


Database read replication: DHIS2 now allows for configuring up to 5 read
replicas of the master database. When set up, the application will
automatically offload read-only database queries to the read replicas,
allowing for horizontal scalability of the database read operation
capacity. Each read replica must be specified in the dhis.conf
configuration file.

Docs
<https://dhis2.github.io/dhis2-docs/master/en/implementer/html/install_read_replica_configuration.html>



WEB API FEATURES

---

API versioning: The Web API is now versioned. The versioning is defined
through the request URL with a version number. For example
/api/25/dataElements will return version 25 of the data elements resource.
If you omit the version part of the URL, the system will use the current
API version. The last three versions of the API will be supported.

Docs
<http://dhis2.github.io/dhis2-docs/master/en/developer/html/webapi_browsing_the_web_api.html#webapi_api_versions>


Indicator analytics: The numerator, denominator and factor components of
indicator values can be included separately in analytics responses by
setting the includeNumDen parameter to true.

Docs
<http://dhis2.github.io/dhis2-docs/master/en/developer/html/webapi_analytics.html#webapi_analytics_query_parameters>


Translation in metadata export: Object translations can now be included in
the metadata export payload by setting the translate parameter to true.

Docs
<https://dhis2.github.io/dhis2-docs/master/en/developer/html/webapi_metadata_export.html>


Async metadata import: Metadata imports can now be performed asynchronously
by setting the async parameter to true, which is useful for large metadata
imports.

Docs
<https://dhis2.github.io/dhis2-docs/master/en/developer/html/webapi_metadata_import.html>


Logical operators: You can now specify whether to use the AND or OR logical
operators for filters while using the metadata export resources.

Docs
<https://dhis2.github.io/dhis2-docs/master/en/developer/html/webapi_metadata_object_filter.html#webapi_metadata_logical_operator>




RELEASE INFO

----

You can download Live package, WAR file, sample data and source code here:

https://www.dhis2.org/downloads


You will find documentation and Javadocs here:

https://www.dhis2.org/documentation


You can read the upgrade notes and find upgrade script here:

https://www.dhis2.org/225-upgrade


You can find the *source code* on Github here:

https://github.com/dhis2


The demo application can be found here:

https://play.dhis2.org/demo


Full list of features can be found at the Launchpad page:

https://launchpad.net/dhis2/+milestone/2.25


Instructions for signing up for the DHIS 2 mailing lists here:

https://www.dhis2.org/contact



TESTIMONIALS
---

Thanks goes to EyeSeeTea <http://eyeseetea.com/> for contribution to this
release.




best regards,


the DHIS 2 development team