Validation Options

Table 1. ValidateGlobalAddress Validation Options

optionName

Description

ValidateComponent.Department

Specifies whether or not to include the Department field when validating an address.

Y
Yes
N
No (default)

ValidateComponent.FirmName

Specifies whether or not to include the FirmName field when validating an address.

Y
Yes
N
No (default)

ValidateComponent.Building

Option.ValidateComponent.Building

Specifies whether or not to include the Building field when validating an address.

Y
Yes (default)
N
No

ValidateComponent.SubBuilding

Specifies whether or not to include the SubBuilding field when validating an address.

Y
Yes (default)
N
No

ValidateComponent.HouseNumber

Specifies whether or not to include the HouseNumber field when validating an address.

Y
Yes (default)
N
No

ValidateComponent.SubStreet

Specifies whether or not to include the SubStreet field when validating an address.

Y
Yes (default)
N
No

ValidateComponent.StreetName

Specifies whether or not to include the StreetName field when validating an address.

Y
Yes (default)
N
No

ValidateComponent.POBox

Specifies whether or not to include the POBox field when validating an address.

Y
Yes (default)
N
No

ValidateComponent.SubCity

Specifies whether or not to include the SubCity field when validating an address.

Y
Yes (default)
N
No

ValidateComponent.City

Specifies whether or not to include the City field when validating an address.

Y
Yes (default)
N
No

ValidateComponent.USCountyName

Specifies whether or not to include the USCountyName field when validating an address.

Y
Yes (default)
N
No

ValidateComponent.StateProvince

Specifies whether or not to include the StateProvince field when validating an address.

Y
Yes (default)
N
No

ValidateComponent.Principality

Specifies whether or not to include the Principality field when validating an address.

Y
Yes (default)
N
No

ValidateComponent.PostalCode

Specifies whether or not to include the PostalCode field when validating an address.

Y
Yes (default)
N
No

ValidateComponent.Plus4

Specifies whether or not to include the +4 field when validating an address.

Y
Yes (default)
N
No

ValidateComponent.Country

Specifies whether or not to include the Country field when validating an address.

Y
Yes (default)
N
No

ForceUpdate.Department

Specifies whether or not to correct the Country field when validating an address.

Y
Yes (default)
N
No

ForceUpdate.FirmName

Specifies whether or not to correct the FirmName field when validating an address.

Y
Yes (default)
N
No

ForceUpdate.Building

Specifies whether or not to correct the Building field when validating an address.

Y
Yes (default)
N
No

ForceUpdate.SubBuilding

Specifies whether or not to correct the SubBuilding field when validating an address.

Y
Yes (default)
N
No

ForceUpdate.HouseNumber

Specifies whether or not to correct the HouseNumber field when validating an address.

Y
Yes (default)
N
No

ForceUpdate.SubStreet

Specifies whether or not to correct the SubStreet field when validating an address.

Y
Yes (default)
N
No

ForceUpdate.StreetName

Specifies whether or not to correct the StreetName field when validating an address.

Y
Yes (default)
N
No

ForceUpdate.POBox

Specifies whether or not to correct the POBox field when validating an address.

Y
Yes (default)
N
No

ForceUpdate.SubCity

Specifies whether or not to correct the SubCity field when validating an address.

Y
Yes (default)
N
No

ForceUpdate.City

Specifies whether or not to correct the City field when validating an address.

Y
Yes (default)
N
No

ForceUpdate.USCountyName

Specifies whether or not to correct the USCountyName field when validating an address.

Y
Yes (default)
N
No

ForceUpdate.StateProvince

Specifies whether or not to correct the StateProvince field when validating an address.

Y
Yes (default)
N
No

ForceUpdate.Principality

Specifies whether or not to correct the Principality field when validating an address.

Y
Yes (default)
N
No

ForceUpdate.PostalCode

Specifies whether or not to correct the PostalCode field when validating an address.

Y
Yes (default)
N
No

ForceUpdate.Plus4

Specifies whether or not to correct the +4 field when validating an address.

Y
Yes (default)
N
No

ForceUpdate.Country

Specifies whether or not to correct the Country field when validating an address.

Y
Yes (default)
N
No

ReplaceAlias.Department

Specifies whether or not to overwrite the Department field if an alias is found in the Address Now database.

Y
Yes
N
No (default)

ReplaceAlias.FirmName

Specifies whether or not to overwrite the FirmName field if an alias is found in the Address Now database.

Y
Yes
N
No (default)

ReplaceAlias.Building

Specifies whether or not to overwrite the Building field if an alias is found in the Address Now database.

Y
Yes
N
No (default)

ReplaceAlias.SubBuilding

Specifies whether or not to overwrite the SubBuilding field if an alias is found in the Address Now database.

Y
Yes
N
No (default)

ReplaceAlias.HouseNumber

Specifies whether or not to overwrite the HouseNumber field if an alias is found in the Address Now database.

Y
Yes
N
No (default)

ReplaceAlias.SubStreet

Specifies whether or not to overwrite the SubStreet field if an alias is found in the Address Now database.

Y
Yes
N
No (default)

ReplaceAlias.StreetName

Specifies whether or not to overwrite the StreetName field if an alias is found in the Address Now database.

Y
Yes
N
No (default)

ReplaceAlias.POBox

Specifies whether or not to overwrite the POBox field if an alias is found in the Address Now database.

Y
Yes
N
No (default)

ReplaceAlias.SubCity

Specifies whether or not to overwrite the Subcity field if an alias is found in the Address Now database.

Y
Yes
N
No (default)

ReplaceAlias.City

Specifies whether or not to overwrite the City field if an alias is found in the Address Now database.

Y
Yes
N
No (default)

ReplaceAlias.USCountyName

Specifies whether or not to overwrite the USCountyName field if an alias is found in the Address Now database.

Y
Yes
N
No (default)

ReplaceAlias.StateProvince

Specifies whether or not to overwrite the StateProvince field if an alias is found in the Address Now database.

Y
Yes
N
No (default)

ReplaceAlias.Principality

Specifies whether or not to overwrite the Principality field if an alias is found in the Address Now database.

Y
Yes
N
No (default)

ReplaceAlias.PostalCode

Specifies whether or not to overwrite the PostalCode field if an alias is found in the Address Now database.

Y
Yes (default)
N
No

ReplaceAlias.Plus4

Specifies whether or not to overwrite the +4 field if an alias is found in the Address Now database.

Y
Yes
N
No (default)

ReplaceAlias.Country

Specifies whether or not to overwrite the Country field if an alias is found in the Address Now database.

Y
Yes
N
No (default)

CautiousUpdate

This option, used in conjunction with the "Force Update", ensures that no major changes are made to the data during processing.

Y
Yes
N
No (default)

CrossComponentMatch

Specifies whether or not to correct common address standardization and validation errors by performing cross-component matching. Cross-component matching checks for matches between data found in one field in the input data and another field in the Address Now database.

Y
Yes
N
No (default)

UseReferenceDiacritics

Specifies whether or not ValidateGlobalAddress modifies the address to match the diacritics (accents, umlauts, etc.) in the postal database when the only changes to the address are the diacritics . One of the following:

Y
Yes (default)
N
No

For example, if UseReferenceDiacritics is enabled, the following would occur:

Input City: Chalon-Sur-Saône
City in the postal database: CHALON SUR SAONE
Output City: CHALON SUR SAONE

Input City: ARTEMIVS'K
City in the postal database: ARTEMIVSK
Output City: ARTEMIVSK

If UseReferenceDiacritics is not enabled, the following would occur:

Input City: Chalon-Sur-Saône
Reference City: CHALON SUR SAONE
Output City: Chalon-Sur-Saône

Input City: ARTEMIVS'K
Reference City: ARTEMIVSK
Output City: ARTEMIVS'K

Note that this option has no effect on the Transliteration option.

KeepStandardizationChanges

Specifies whether or not standardization changes such as changing "ROAD" to "RD" should be reported in the ACR code.

Y
Yes
N
No (default)

AcceptanceLevel

The Acceptance Level setting specifies the minimum number of address components that must be validated in order for the whole address to be considered validated. The value specified for AcceptanceLevel corresponds to the second character of the ACR code. For more information, see The ACR Code.

The acceptance level differs from the InnerMatchScore option in that acceptance level measures how many components Validate Global Address validated, regardless of how well the validated components matched to address components in the postal databases, whereas InnerMatchScore indicates the probability that the output address is the correct, validated version of the input address.

One of the following:

-1
The acceptance level is automatically set to an appropriate level based on the address's country. For example, U.S. addresses are processed with an acceptance level of 4.
0
No components validated (default)
1
Country only validated
2
City and country validated
3
City, postal code and country validated
4
Street, city, postal code and country validated
5
Premise number, building name, sub-building, PO box, company, street, city, postal code, and country validated

InnerMatchScore

Specifies the minimum confidence level for address validation. Addresses with a value in the Confidence output field greater than or equal to this value is validated, and those that have a lower value will not be validated (the output field Status will contain F.)

Specify any value between 0 and 100. The higher the value, the higher the degree of confidence necessary for effective address validation. The default is 60.

CompanyWeight

A whole number from 0 to 10, indicating the relative importance of the FirmName field compared to the data in the Address Now database. This affects the confidence value, and can be used to tailor the confidence to distinguish correct and incorrect updates. For more information, see The ACR Code.

The default value is 1.

StreetWeight

A whole number from 0 to 10, indicating the relative importance of the StreetName field compared to the data in the Address Now database. A whole number from 0 to 10, indicating the relative importance of this field compared to the others. For more information, see The ACR Code.

The default value is 10.

CityWeight

A whole number from 0 to 10, indicating the relative importance of the City field compared to the data in the Address Now database. A whole number from 0 to 10, indicating the relative importance of this field compared to the others. For more information, see The ACR Code.

The default value is 8.

PostcodeWeight

A whole number from 0 to 10, indicating the relative importance of the PostalCode field compared to the data in the Address Now database. A whole number from 0 to 10, indicating the relative importance of this field compared to the others. For more information, see The ACR Code.

The default value is 8

OuterMatchScoreLines

A value from 0 to 8 indicating the number of address lines to use when calculating the outer match score. The default is 8. For more information on the outer match score, see The Outer Match Score.