Harmony Release Notes

Here you will find information on the major features for each new product release. For a more detailed schedule of features and functions contact us.

9 August 2018

We are pleased to announce Harmony Suite version 2.10, which comprises many new features including the introduction of GNAF Plus and a standalone Harmony Suite Rapid Address demo.

We have made other enhancements and resolved several issues in this release.

1. Introduction of GNAF Plus in Harmony Suite

GNAF Plus is an enriched version of PSMA’s GNAF dataset. In addition to the existing GNAF attributes appended to an address GNAF Plus provides attributes associated with the address based on the 2016 Census Data SEIFA (Socio-Economic indexes for the Areas) from the Australian Bureau of Statistics (ABS). For further information regarding the ABS data please go to http://abs.gov.au/websitebs/censushome.nsf/home/seifa.

2. Country name allocation during parsing

A new PDP (Pluggable Data Processing) module incorporating country name allocation is introduced into this version. This is specifically relevant when processing both Australia and New Zealand addresses in a single instance. The PDP will automatically allocate country name if it is not provided as part of the input.

3. Multiple address lines now available within the cleanse API

In this latest version, users now have the option to expose multiple address lines within the cleanse API response (e.g. address line 1 contains street information, address line 2 contains locality information and so on). This automatically assembles multiple address lines in the response.

4. Harmony Suite licensing update via Console

The Harmony Suite Administration Console has been updated to support software license updates. This provides Harmony admin users with the ability to update the license by just clicking a button.

5. Improved handling of terms in brackets in the input

A new pre-processor has been added to handle terms in brackets and to segregate the terms in another field. Pre-processors are modules built to support the parsing capability.

6. Introduction of local Harmony Suite Rapid Address demo

A stand-alone Harmony Suite Rapid Address demonstration is available within this release. The Rapid Address service is available for organisations that want a ready-made browser-based Rapid Address look-up using their existing Harmony Suite installations.

15 February 2016

We are pleased to announce Harmony Suite version 2.7, which features many new features for address parsing in general and the geocoding of Australian addresses in particular.

We have also resolved several issues and made other improvements to the software.

Geocoding of Australian Addresses 

This release introduces many new features to improve the geocoding of Australian Addresses by adding and enhancing the services below. 

Introduction of a Pre-Processor
Pre-processors are introduced to better prepare input data for the Harmony Parsing service. These Pre-processors, when used in conjunction with semi-structured address mapping and Left to Right KB, will significantly increase parsing rates.

Introduction of Custom Knowledgebase
To achieve higher parse rates and mitigate risks when fine-tuning the Core Knowledge Base (KB), a separate custom KB can now be configured by the user. Any bespoke address lexical / patterns can now be created without impacting the Core KB.

Handling of Semi-component Input
Harmony will now accept semi-component input address structures. This means separated semi-structured input (e.g. Address Line 1, Address Line 2, Suburb, State and Postcode) are now accepted by Harmony for processing in both Harmony Batch and Harmony web services.

Introduction of Address Reformatter
A new tool is introduced in Harmony Web services Style 2 to allow users to reformat the Harmony address output components to a preferred presentation format.

Introduction of PDP Change Policy
PDP results can now be configured to control the persistence of field values pre-or post-PDP processing. This allows users to persist the value from the input or from PDP processing results through all Harmony processing.

Harmony Rapid Address RESTful APIs
Harmony Rapid Address (HRA) for Harmony Suite 2.7 implements RESTful APIs for address search and other related rapid address web service calls.

New Module – Enhanced G-NAF Validation Engine
Users often have the need to modify validation rules or create their own to manage data conditions not handled by standard Harmony HAVE engines. Introducing bespoke rules into standard Harmony validation engines would compromise their integrity and is not permitted for accredited applications such as Australia Post AMAS processing.

New Module – ARCGIS Geocode PDP
A new PDP is introduced to resolve residual below-point matches (including Group, Locality and No matches) from the GNAFValidation PDP.

New Module – GNAF Lookup PDP
The GNAFLookup PDP facilitates the manual review of non-validated records (i.e. GNAF address message attribute is empty) from upstream processing.


  • Increased AU parsing rate with the standard Harmony Locate product
  • Order of HRA SOAP address results enhanced
  • Merged NZHRAWeb with HRA Web
  • HRA Restful API getSimilarAddresses can be filtered by State, Postcode and Suburb
  • The HRA Restful API getSimilarAddresses allows to set State preference
  • Postal type without postal number is now recognized as Postal Type
  • Postal Type and Postal Number without space are now parsed correctly
  • Enhanced rules for Supplementary Locality Table processing
  • Improvements to Ambiguous Locality Match:

a. If there is more than one occurrence of a Locality/State/Postcode combination in the reference data, GNAFHAVE treats it as an ambiguous match and allocates no match, while GNAFValidation provides a Locality match based on the priority rules below:

1. Has Geocode and a gazetted Locality locality_class=’G’ (best case)
2. Only one Locality/State/Postcode combination has geocode
3. Has Geocode and a District Locality locality_class=’D’
4. Has Geocode and a Topographic Locality locality_class=’T’

b. If there is more than one Gazetted Locality with the same Locality/State/Postcode combination, the first Gazetted Locality in the candidate list is returned.

Bug fixes

  • Over-matching of Postcode and State to the G-NAF Locality table is rectified in the new PDP GNAFValidation
  • Supplementary Locality Table PDP is rectified to populate MeshblockID2011 field value in addition to the Mesh block ID field in cases where geocode is obtained from Supplementary PDP
  • Harmony will match the locality name with an entry in the Supplementary Locality Table and return the geocode coordinates for that entry, irrespective of what is entered in other fields (e.g. Place name)
  • Onlooker-like Key generation compress function was added to existing key generation functions
  • Reverse lookup by DPID/G-NAF PID is rectified to obtain the related address
  • Handling of Phantom Address exposure in Rapid Address
  • Rural delivery number exposure in NZHRA Restful response
  • HRA logging configuration is now enabled from Harmony console
  • GNAF Lot number overmatch for ambiguous address rectified
  • KB modification using Tomcat 7 is now working
  • Parsing of NZ Phone number which starts with 022
  • Bells Line of Road and Headlam Road Area are now allocated DPIDs
  • Various AU parsing issues were resolved


14 February 2014

Within just four months of our previous release, we bring you Harmony Suite 2.5. We have worked hard to deliver these updates early this year and to build momentum for our 2014 product roadmap. As with any release, we have corrected some minor bugs for smooth operation. In addition, we have also prioritised requests from clients for new functionality. New features include:

  1. For our New Zealand Postal Address File users, we have implemented a single-line address lookup using the NZPAF source of truth so customers can enter a free-form address search that will return a list of candidates into separated fields
  2. Address filter capabilities by type; this allows our customers to determine what form of address they want returned, whether it be one form or multiple. This includes:
  • Postal – if a postal type exists
  • Doorstop – apartment detail, where secondary information exists
  • Rooftop – with only reference to the building, no sub dwelling detail
  • Single – for houses with no sub dwellings, where no secondary information is available

To request a detailed copy of the Harmony Suite 2.5 release notes or to send your valuable feedback, please contact us here.