# Harmony Suite Overview

{% hint style="info" %}
If you are interested in Harmony Suite please arrange a [demo.](https://www.loqate.com/anz/contact/?n=demo)
{% endhint %}

<figure><img src="/files/sEF4k9X2gfozzfu6IlMn" alt=""><figcaption></figcaption></figure>

### Services

#### Product Modules

Product Modules is the grouping of pluggable data processors and standalone modules to perform a large set of data quality operations. **Pluggable Data Processors (PDP's) -** can be chained within a data model to achieve a specific data cleansing objective.

* **Parsers / Standardisation** - standardisation of all data objects such as personal names, commercial names inc trusts, address knowledge based parsers, address AI parsers, phone, email, alias, gender allocation and pre-processors.
* **Identity Match** - Identity Matching Engine. Performance built for matching identities between databases in configurable match classes.&#x20;
* **Address Cleanse** - Keep your address data accurate with Address Cleanse&#x20;
* **Address Lookup & Validation** - Address Typeahead and Validation web service that supports REST or SOAP web app implementations.&#x20;
* **Business Lookup & Validation** - Business/Company Typeahead and Validation web service that supports REST or SOAP web app implementations.&#x20;
* **Business Cleanse** - Cleanse Business/Company records using identifiers or name to ensure business records are accurate and update.
* **Reverse Geocoding / Geocoding -** Lookup addresses using co-ordinates and/or attach co-ordinates to addresses.
* **Postcode -** Lookup and validate using postcodes, localities and suburb information
* **Email Validation** - Validate email addresses at multiple levels with mailbox insights to help decision use of email. Requires call to Loqate Harmony API services.
* **Phone Validation** - Validate phone numbers globally including porting and carrier insights. Requires call to Loqate Harmony API services.

#### Interfaces

* Web Services (REST/SOAP)
* Web Admin for Users
* Batch System
  * Execute large scale batch validation processes

#### Datasets

Data is licensable and can be added to the system.&#x20;

* AUPAF - Australia Post Postal Address File
* GNAF - Australia Geocoded National Address File
* AUSOTS - Combined AU Address File
* NZPAF - New Zealand Postal Address File
* NZAD - New Zealand Address Database
* CNAR - New Zealand Comprehensive National Address Register
* AUBF - Australian Business File
* NZBF - New Zealand Business File
* EMAIL - Email Validation via Harmony (Hosted) API Services&#x20;
* Phone - Phone Validation via Harmony (Hosted) API Services

### Deployment requirements

* JDK 1.8 +
* Web Application servers&#x20;
  * Tomcat,&#x20;
  * IBM WAS&#x20;
* Harmony batch system (HBS)
* Harmony Admin (harmony\_admin.war)
* Harmony Web Services (HarmonyWS.war)
* Harmony Rapid Address (HRAWeb.war)

### Pluggable Data Processing

Harmony PDPs (or components) are pluggable post processing modules that can be chained within a data model to achieve a specific data cleansing exercise.

#### Address PDP's

* AMAS Address Standardization
* AMAS HAVE (AUPAF)
* AU Barcode AllocationAusPost&#x20;
* GNAF Address Standardization&#x20;
* GNAF Validation (GNAF)
* Supplementary (Supplementary Table)
* NZHAVE GeoPAF(NZPAF)&#x20;
* NZAD Validation(NZAD)
* CNAR Geocode(CNAR)
* Match Scoring

#### Name PDP's

* Gender Allocation
* Personal Name Standardization
* Alias Allocation

#### Business PDP's

* Business Lookup
* Business Validation
* Company Name Standardization

#### Phone PDP's

* Phone Validation

#### Email PDP's

* Email Validation

### Parser

Parser converts a string into components using IRIS Parser, KB Parser, Parsing Pre-processor and the AI Parser.&#x20;

Parsing is configurable and extendable in Harmony Suite.

### **Address Lookup & Validation**

Harmony Address Lookup & Validation  (Rapid Address) is part of Harmony Series of customer data quality products. Providing address lookup web services to rapidly accesses and validates a customer’s address against a certified source of truth

* Lucene based search
* Support both RESTFUL and SOAP
* Support multiple source of truth (SOT)
* HRAWeb.war hosted by customers

![](/files/A1FUFplEXpafP7P58Gew)

**GetSimilarAddresses (single line)** - typeahead for full or partial address suggestions

**GetSimilarLocalities** – get all matched localities with the given postcode, locality/suburb, state/towncity&#x20;

**GetLocalitySynonyms** – get all synonym localities or alternate suburbs

**GetSimilarBorderingLocalities** – get all bordering localities or alternate towncities

**ReverseGeocode** – get all matched addresses with the given latitude and longitude within the radius

**GetSubdwellingAddresses –** get all subdwelling addresses under the given address ID

### Identity Matching

Matching is the process of comparing two records to determine the extent to which they represent the same entity.&#x20;

The degree of matching could be qualified in a number of different measures, either indicating the entities are the same or an indication of the relationship between the two entities.

The degree of complexity of customer data because of multiple data models (fields), different sources and formats.

Harmony offers a wide array of Matching configurations and tolerance levels to understand the quality of a match for specific use cases.

**Basic Match classes**

![](/files/AXs6jbH4EGqQot0ltWA9)

### Batch System

Batch system is for processing high data volumes for all PDP's, Matching and Parsing modules.&#x20;

This can be executed by Users via the Admin Panels or CLI.&#x20;

![](/files/gIsIdsBulzjTQz5Qb8CU)

### Use Case Reference Guides

<table><thead><tr><th width="176">Use case</th><th width="198">Licence Module</th><th>Reference Guides</th></tr></thead><tbody><tr><td><p><strong>Platform Management,</strong></p><p><strong>Parsing and Standardisation</strong></p></td><td>Information Integrity Engine</td><td>·       Installation and Upgrade for Unix<br>·       Installation and Upgrade for Windows<br>·       Harmony Management Console<br>·       Harmony Knowledgebase Configuration<br>·       Harmony Web Services<br>·       Harmony Release Notes</td></tr><tr><td><strong>Batch Operations</strong></td><td>Harmony Batch</td><td><p>·       Harmony Batch System Cleanse<br>·       Harmony Management Console<br>·       Harmony Knowledgebase Configuration</p><p>·       Harmony Batch System in z/OS</p></td></tr><tr><td><strong>Customer Matching</strong></td><td>Harmony Match</td><td>·       Harmony Batch System Match<br>·       Harmony Management Console<br>·       Harmony Knowledgebase Configuration<br>·       Harmony Web Services</td></tr><tr><td><strong>Address Lookup &#x26; Validation, Reverse Geocode</strong></td><td> Harmony Rapid Address<br> - Australia,<br>- New Zealand</td><td>·       Harmony Rapid Address Australia<br>·       Harmony Rapid Address New Zealand<br>·       ROAD Source of Truth Installation</td></tr><tr><td><strong>Address Cleanse</strong></td><td>Harmony Post<br>– Australia<br>Harmony Post<br> – New Zealand</td><td>·       Harmony Post Australia<br>·       Harmony Post New Zealand<br>·       ROAD Source of Truth Installation</td></tr><tr><td><strong>Address Cleanse</strong></td><td>Harmony Locate</td><td>·       Harmony Locate<br>·       ROAD Source of Truth Installation</td></tr><tr><td><strong>Suburb Cleanse</strong></td><td>Harmony Postmaster</td><td>·       Harmony Postmaster</td></tr><tr><td><strong>Business Lookup &#x26; Validation, Cleanse</strong></td><td>Harmony Business</td><td><p>·       <a href="https://docs.mastersoftgroup.com/harmony-suite/documentation/version-3.0.0/business-lookup-and-validation/business-lookup">Harmony Business Lookup</a></p><p>·       <a href="https://docs.mastersoftgroup.com/harmony-suite/documentation/version-3.0.0/business-lookup-and-validation/business-validation">Harmony Business Validation</a></p></td></tr><tr><td><strong>Email &#x26; Phone Validation</strong></td><td>Harmony Email &#x26; Phone Validation</td><td>·       <a href="https://docs.mastersoftgroup.com/harmony-suite/documentation/version-3.0.0/email-and-phone-validation">Harmony Email &#x26; Phone Validation</a></td></tr><tr><td><strong>Deployment Mode</strong></td><td>Harmony RealTime</td><td>·       Harmony RealTime</td></tr><tr><td><strong>Extensions</strong></td><td>Harmony Extensions</td><td>·       Harmony Extensions</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mastersoftgroup.com/harmony-suite/harmony-suite.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.