# Phone Validation using Harmony Batch System

The designation of Client Role and Locale within the batch setup indicates the PDP utilized for phone validation processes across various geographical contexts.

## Pre Reading

Please ensure you have read and understood the previous configuration steps for Australia and New Zealand.

{% content-ref url="" %}
[](https://docs.mastersoftgroup.com/harmony-suite/user-guides/version-3.0.0/email-and-phone-validation)
{% endcontent-ref %}

Below is the simple illustration of our phone validation processing using a small file in Australia with Harmony Batch System. A more comprehensive guide detailing the instructions on how to set up a batch job can be checked here [Harmony Batch System Cleanse Reference Guide.](https://docs.mastersoftgroup.com/harmony-suite/user-guides/version-3.0.0/batch-system-match-reference-guide)

## **Steps to run Batch Job**&#x20;

### **1. Job Config**

It is expected that the customer has configured the [Setup HostedPhoneValidation PDP](https://docs.mastersoftgroup.com/harmony-suite/user-guides/version-3.0.0/phone-and-email-pdp-configuration-setup#setup-hostedphonevalidation-pdp) prior to executing a batch process.

Log in to HBS UI and select New Cleanse

Select the required Client Role that is attached to the component group that has HostedPhoneValidation PDP added.

Select the Locale as Australia

*Example 1: AU Cleanse job profile*

<figure><img src="https://2735524619-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhp3nSGDGzW6K0AYaMW45%2Fuploads%2FskacJLAbDrecrHSy1FuH%2Fimage.png?alt=media&#x26;token=1deabcdc-dcc0-40b6-9bdb-3a20b452f6a6" alt=""><figcaption></figcaption></figure>

### 2. Input

#### **Click Input on the left panel to display the Input Reader panel. There are seven tabs in this panel, each with its own set of fields.**

Refer Page No 14 of the [**Harmony Batch System Cleanse Reference Guide**](https://docs.mastersoftgroup.com/harmony-suite/user-guides/version-3.0.0/batch-system-cleanse-reference-guide) to get an idea on how to configure the Input file for batch processing.

Quick configuration on how to configure an input file that consists of the fields below is provided here.

**Input File:** File comprises of Id, Input Phone Number.

*Example 2: Sample Input file*

<div align="left"><figure><img src="https://2735524619-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhp3nSGDGzW6K0AYaMW45%2Fuploads%2FLxbCwgStx2jWCG95FqSw%2Fimage.png?alt=media&#x26;token=a06c2c2e-17ef-4602-89bb-31d181675f52" alt=""><figcaption></figcaption></figure></div>

#### **General**

Choose your input file and correct configuration for your phone file.

Full description of the panel is within Harmony Batch System Cleanse Reference Guide.

<figure><img src="https://2735524619-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhp3nSGDGzW6K0AYaMW45%2Fuploads%2Fr1rpeGdZOdKmUjuUGjSX%2Fimage.png?alt=media&#x26;token=ed11e007-70c6-443f-adfb-a7d30c55afd2" alt=""><figcaption></figcaption></figure>

#### **Detail Record**

Ensure you correctly check the details versus your input file.

Full description of the panel is within Harmony Batch System Cleanse Reference Guide.

<figure><img src="https://2735524619-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhp3nSGDGzW6K0AYaMW45%2Fuploads%2FDuKDRgb4v83ur5kJduhy%2Fimage.png?alt=media&#x26;token=7ab3ddbc-1bdb-4e28-ada7-d7c95abaa987" alt=""><figcaption></figcaption></figure>

**Baseline Fields**

Very important step as this information forms part of the Logical Record mapping between your input file and what the HBS system requires to process.

***Auto populate fields:*** If you have ticked 'first detail record represents baseline fields' then right click on white panel and retrieve the field names. This will auto populate the fields.

***Manually enter fields:*** Type your input column names into the table within the panel.

Full description of the panel is within [Harmony Batch System Cleanse Reference Guide.](https://docs.mastersoftgroup.com/harmony-suite/user-guides/version-3.0.0/batch-system-cleanse-reference-guide)

<figure><img src="https://2735524619-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhp3nSGDGzW6K0AYaMW45%2Fuploads%2FbQ4YRj35x0lY8qBdHaii%2Fimage.png?alt=media&#x26;token=5b5cf438-aa71-4c1c-acd9-33716155bf10" alt=""><figcaption></figcaption></figure>

#### **Logical Records**

**HBS Logical Record represents the input baseline fields that are mapped to Harmony data models for batch processing.**

The left column "Name" is Harmony name representation for a field.&#x20;

The right column "Generated By" is the Input File name for the field with the same meaning.

Input Phone Number from the baseline fields has been mapped to HARMONY\_PHONE.

Input Id is the sequential id from baseline fields, it can be mapped to HARMONY\_ID.

Full description of the panel is within [Harmony Batch System Cleanse Reference Guide](https://docs.mastersoftgroup.com/harmony-suite/user-guides/version-3.0.0/batch-system-cleanse-reference-guide).

*Example 3: Mock Logical Record mapping*

<figure><img src="https://2735524619-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhp3nSGDGzW6K0AYaMW45%2Fuploads%2Fnzpc1whG5gCeXnzOZAAl%2Fimage.png?alt=media&#x26;token=c060560e-0723-485d-a42e-970253c7a21f" alt=""><figcaption></figcaption></figure>

### **3. Preprocessor**

Not Applicable

### **4. Output**

#### **Harmony Output on the left panel represents the configuration of the output file and the fields to be returned in the output file.**

**General:** To configure the file layout specifications.&#x20;

<figure><img src="https://2735524619-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhp3nSGDGzW6K0AYaMW45%2Fuploads%2FPXks3hV1vC7e737dBCgF%2Fimage.png?alt=media&#x26;token=c56a8de2-a51b-41b3-8516-f2f4ea157acd" alt=""><figcaption></figcaption></figure>

**Field Definition:** Defines the fields to be output to the output file.

click on ![](https://2735524619-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhp3nSGDGzW6K0AYaMW45%2Fuploads%2F0QfiV7bxPyWk9jI1ikh0%2Fimage.png?alt=media\&token=e311f4d9-1f41-4ba4-8499-b06721b52ae7) to open the Logical field creation window and then select the input baseline fields the user wish to see in the output file, click Done.  The selected field will then be added to the Name column.

To add the Output fields from HostedPhoneValidation PDP to be shown in the output file, click on ![](https://2735524619-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhp3nSGDGzW6K0AYaMW45%2Fuploads%2FzacBP28SfVK9N83jKVqS%2Fimage.png?alt=media\&token=6ef05ba4-1355-471e-8118-24b654bd235b) to add party.phone.fieldname

Examples:&#x20;

party.phone.countryCode -->represents validated phone number country code.

party.phone.phoneStatus--> represents validated number is connected/disconnected/indeterminate etc.

<figure><img src="https://2735524619-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fhp3nSGDGzW6K0AYaMW45%2Fuploads%2FOkXURUzf50PH5XE3dwdx%2Fimage.png?alt=media&#x26;token=ee20109f-7e6f-478b-a0c0-d3499c5a0c45" alt=""><figcaption></figcaption></figure>

**Sample text output:**

Please refer to the sample illustration for phone number validation with [detailed understanding using various samples.](https://docs.mastersoftgroup.com/harmony-suite/user-guides/version-3.0.0/guides/understanding-phone-data#understanding-phone-data-with-various-samples)

### &#x20;**5. Exceptions**

Please refer to the [Harmony Batch System Cleanse System Reference Guide](https://docs.mastersoftgroup.com/harmony-suite/user-guides/version-3.0.0/batch-system-cleanse-reference-guide).

### **6. Report**

Please refer to the [Harmony Batch System Cleanse Reference Guide](https://docs.mastersoftgroup.com/harmony-suite/user-guides/version-3.0.0/batch-system-cleanse-reference-guide).

### **7. History**

Please refer to the [Harmony Batch System Cleanse Reference Guide](https://docs.mastersoftgroup.com/harmony-suite/user-guides/version-3.0.0/batch-system-cleanse-reference-guide).
