Table of Contents

Search

  1. Preface
  2. Getting started with Informatica Address Verification (On-Premises)
  3. General Settings
  4. Input Parameters
  5. Process Parameters
  6. Address Enrichments
  7. Result Parameters
  8. Output Fields
  9. Assessment Codes and Return Codes
  10. Frequently Asked Questions
  11. Geocode Countries

Developer Guide (On-Premises)

Developer Guide (On-Premises)

The PreferredLanguage Attribute

The PreferredLanguage Attribute

Informatica Address Verification can return address elements in multiple languages for addresses in Belgium, Canada, China, Ireland, and Switzerland. To determine the languages that Address Verification uses for the address elements, configure the
PreferredLanguage
attribute of the
Result
element in
Parameters.xml
.
When the reference data includes elements in multiple languages, Address Verification can return address data in the following languages:
  • The main spoken language of the region to which each address belongs. This is the default language for the address in the reference data.
  • Any other language that Address Verification supports for an address. For example, the Belgium reference data contains address elements in Flemish, French, and German.
The reference data might contain data for a single address element or for a complete address in multiple languages. For example, Address Verification can return all address elements for Ireland in the English language and can return street names, locality names, and province names in the Irish language. Additionally, the reference data might specify different default languages for different parts of a country. For example, in the Switzerland reference data, the default language for addresses from Zurich is German, from Geneva is French, and from Ticino is Italian.
To define a preferred language policy, set one of the following values for the
PreferredLanguage
attribute:
DATABASE
Returns all available address elements in the default language of the address in the reference data.
DATABASE is the default value for the
PreferredLanguage
attribute.
ENGLISH
Returns province and locality information in English if the reference data contains the information. For example, Address Verification can replace München with Munich and Bayern with Bavaria in Germany addresses.
ALTERNATIVE_1, ALTERNATIVE_2, or ALTERNATIVE_3
Returns address elements in one of the alternative languages in the reference data. The alternative languages depend on the country to which the address belongs.
PRESERVE_INPUT
Returns address elements in the same language as the input address. Address Verification preserves the language if the reference data contains the address in the input language.
If the input address contains multiple languages, Address Verification returns the address in the default database language.

Rules and Guidelines for the PreferredLanguage Attribute

Consider the following rules and guidelines when you configure a preferred language:
  • When you set the
    PreferredLanguage
    attribute, verify that the
    PreferredScript
    attribute specifies a character set that can deliver the address data in the characters that you expect.
    For example, to return a Hong Kong address in the English language, set the
    PreferredLanguage
    attribute to English or Alternative_2 and set the
    PreferredScript
    attribute to a Latin-1 or ASCII script. To return address data in the default local language and character set, set the
    PreferredLanguage
    and set the
    PreferredScript
    attributes to DATABASE.
    For more information, see Countries and PreferredScript Options.
  • If you set the
    PreferredLanguage
    attribute to a language that is not available in the reference data, Address Verification returns the address in the default database language. In such cases, Address Verification returns an extended element result status (EERS) value of E. The value indicates that the output uses the default language because the reference database does not contain the information in the language that you specified.
  • The language or the format in which Address Verification returns the country name depends on the value that you configure for the
    CountryType
    attribute of the
    Result
    element.
  • If the input address contains an address element that the reference database does not contain, Address Verification copies the element to the result output. For such elements, Address Verification returns the information in the same language as the address input.
    An element input status (EIS) value of 1 indicates that the reference data does not contain the element.
    An element result status (ERS) value of 1 indicates that Address Verification copied the information from the input because the reference database does not contain the information.
  • If the database contains some but not all address elements in the language you specified, Address Verification returns the address partially in the language that you specified and partially in the default language.
  • If you use Address Verification in the Informatica Cloud®, you can set a
    PreferredLanguage
    value under the
    ValidationParameters
    in the SOAP request.