dhis2-devs team mailing list archive

[Morten Olav Hansen <morten@xxxxxxxxx>]

Hi Martin

I will forward you an email with a bit more details about the new format

-- 
Morten Olav Hansen
Senior Engineer, DHIS 2
University of Oslo
http://www.dhis2.org

On Tue, Oct 18, 2016 at 2:39 PM, Martin Van Aken <martin@xxxxxxxxxxxxxxxx>
wrote:

> Hi !
> Good job with the release. By testing our API against the demo version, we
> just noticed that the status info looks to have changed quite a bit:
>
> - status is now "OK" instead of "SUCCESS" when good
> - "import_type_summaries" have disappeared in favor of a "stats" object
>
> I could not find this on the upgrade notes - do you have some place where
> the API changes are detailed at that level?
>
> While it may looks like a small change, it is breaking several of our
> cases. Do you have any advice on how to maintain an API client through
> various DHIS2 versions?
>
> Thanks,
>
> Martin
>
> On Thu, Oct 13, 2016 at 12:51 PM, Lars Helge Øverland <lars@xxxxxxxxx>
> wrote:
>
>>
>> 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
>>
>>
>>
>>
>>
>>
>> _______________________________________________
>> Mailing list: https://launchpad.net/~dhis2-devs
>> Post to     : dhis2-devs@xxxxxxxxxxxxxxxxxxx
>> Unsubscribe : https://launchpad.net/~dhis2-devs
>> More help   : https://help.launchpad.net/ListHelp
>>
>>
>
>
> --
> *Martin Van Aken - **Freelance Enthusiast Developer*
>
> Mobile : +32 486 899 652
>
> Follow me on Twitter : @martinvanaken <http://twitter.com/martinvanaken>
> Call me on Skype : vanakenm
> Hang out with me : martin@xxxxxxxxxxxxxxxx
> Contact me on LinkedIn : http://www.linkedin.com/in/martinvanaken
> Company website : www.joyouscoding.com
>
> _______________________________________________
> Mailing list: https://launchpad.net/~dhis2-devs
> Post to     : dhis2-devs@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~dhis2-devs
> More help   : https://help.launchpad.net/ListHelp
>
>