When you view, create, or update adapter configurations, the information displayed or to be entered is the same. After you view an adapter, you can optionally update its configuration.
Adapter configuration is the same for all third party or custom address validation adapters, but different for the seeded Dun and Bradstreet adapter. D&B adapter configuration is part of the D&B integration setup. See: Setting Up Third Party Data Integration.
This table describes some terms in the pages used for this procedure.
Selected Terminology
| Term | Description |
|---|---|
| Host Address | The D&B HTTPS URL which D&B provides for access to the D&B database. |
| User Name | The user ID that D&B provides for users to log in to the D&B database. |
| Password | The password that D&B provides for users to log in to the D&B database. |
Update the default host address only if D&B provides you a different URL.
Register all users who need access to purchase D&B data online.
Note: The user names you enter become the available values for the HZ: D&B User Name profile option. As part of D&B integration, this profile option must be set with all the available values. If there are multiple user names, then all values are set at the User level.
This table describes some terms in the pages used for this procedure.
Selected Terminology
| Term | Description |
|---|---|
| Invoke Method | The method used to communicate with the adapter, for example HTTP V1.1 Post. |
| Host Address | The host address of the adapter, applicable only if the invoke method is HTTP. |
| Default Batch Size | The default number of records the adapter can handle in one batch. This number is used if the maximum batch size is not defined. |
| Maximum Batch Size | The maximum number of records the adapter can handle in one batch. This number must be greater than or equal to 1. |
| Message Format | The XML message format that the adapter uses. |
| Default Replace Status Code | For adapters used with address validation, the default code that must be reached or exceeded for an address to be updated with data from the adapter service. This default code is used if the caller to address validation adapters does not specify a code. For example, if the code is 2, the service linked to the adapter must validate a TCA address up to at least the street or thoroughfare level before updating that address with the service's standard address. Addresses with validation status 0, 1, or 2 would be updated. |
This table describes the available status codes.
Default Replace Status Codes
| Status | Meaning | Description |
|---|---|---|
| 0 | Valid Address | The highest level of validation. The address has been certified deliverable based on postal authority certifications. |
| 1 | Multiple or Ambiguous Address | Address has been validated to the street level, but there is ambiguity to locate the specific address. |
| 2 | Street or Thoroughfare Match | Address has been validated to the street level, but no further. |
| 3 | Municipality Match | Address has been validated to the city or town level, but no further. |
| 4 | Administrative Subdivision Match | Address has been validated to be within the country's main administrative subdivision, such as province or state, but no further. |
| 5 | Country Match | Address has only been validated to the country level, but no further. |
| 6 | No Match | Address could not be validated in any way. |
Enter the adapter details.
For adapters used with address validation, specify the countries that the adapter supports. For example, if an adapter can validate only addresses from France and Australia, only those two countries should be listed.
Enable the adapter to process addresses for specific countries.
Note: If an adapter is used to set the HZ: Default Location Service Adapter profile option, you cannot disable that adapter unless you set the profile option with another adapter. See: Address Validation Deployment Category.
Indicate if the adapter is the default to use for specific countries. Only one adapter can be the default for each country. For example, if the Gorman adapter is already the default for Italian addresses, and you try to set Elcaro as the default adapter, you can either stay with Gorman or switch to Elcaro.