Address Doctor Setup

AddressDoctor GmbH is a worldwide address verification system that is accessed via the Internet. All communications between OPERA and AddressDoctor are handled through OPERA Web Services.

Addresses entered into OPERA profiles are compared to the global AddressDoctor database of postal address information. Used online, AddressDoctor enables verification of address data in near real time, as it is entered. For each address it checks, AddressDoctor returns a list of suggestions that match or come near to matching the address that was input into OPERA. You may then select from the list of suggestions to auto-populate the profile address fields. Batch address verification is also available. With batch verification, no alternatives or suggestions are returned. The address is flagged as correct if it is accurate, or it can be automatically corrected, or it can be assigned a status that reflects its "deliverability rating." See the AddressDoctor documentation for details.

The following information describes how to configure AddressDoctor address verification in OPERA.

License Code

AddressDoctor address verification is enabled in OPERA PMS when the OPP_ADDO AddressDoctor Interface add-on license code is active.

Note: When the OPP_ADDO AddressDoctor Interface add-on license code is not active, and no other address cleansing is selected (e.g., Quick Address Cleansing, or config_mode=WYNN or MGM) AddressDoctor Setup will still display under Configuration>Profiles>AddressDoctor Setup with a new option on the AddressDoctor Setup screen (Demo button). See section, AddressDoctor Setup Screen (OPP_ADDO License Inactive), for more details.

Application Parameters

The following application parameters control the availability and behavior of address verification.

Profiles>Address Cleansing application function - Set to Y.

Note: The application function Profiles>Address Cleansing is also used to configure external address cleansing interfaces. Therefore it will always be available from the Application Settings menu regardless of whether AddressDoctor is installed or not.

Profiles>AddressDoctor Modes application setting - Available modes are any one or more of the following:

Interactive - Select this mode in order to implement address verification while you are entering or editing address information via the Profile screen. Addresses are cleansed before new or changed address information is added to the OPERA database.
Note: When lines 1 - 4 are left blank in interactive mode, opera will bypass address cleansing on the following screens even if a city, state, country and/or zip code have been entered: Accounts, Contacts, Profiles, Quick Profile and Add/Edit Address screens.
Batch - Select this mode if you wish to automatically invoke address verification during End of Day processing by calling the opera_addressdoctor.cleanse_address procedure in OPERA PMS, Sales and Catering, and SFA. In ORS, batch verification is called by the ORS Background Process (see ORS Batch Cleanse Procedure, below). All addresses in the database for which the Cleansed flag is null (indicating that the record has not been cleansed) are automatically verified. Addresses flagged as having been successfully cleansed, and those flagged as having previously failed cleansing, are not checked by the batch process.
FastCompletion - Select this mode if you wish to invoke address verification using truncated or partially entered data where AddressDoctor will auto-generate suggestions a user can select from concurrent with the data entry task. The minimum data required for return of results are country and postal code.
Note: A maximum of 20 result records will be returned by AddressDoctor, so this mode makes most sense in countries where postal codes define very small areas, e.g., one or two streets only (such as in the UK) if ONLY country and postal code are used. When other address elements (address line 1-4) are entered as well, the FastCompletion mode can also be used for other countries, where the postal code defines larger geographical areas. The countries best suited for FastCompletion mode are the United Kingdom, Canada, Singapore, Netherlands and Argentina.

Profiles>Address Cleansing System application setting - Allows you to select AddressDoctor or another external application as the default Address Cleansing system.

Profiles>AddressDoctor Country Codes application setting - Select the countries for which you want AddressDoctor to validate addresses. Leave this field blank if you want AddressDoctor to cleanse addresses regardless of country.

Profiles>Address Cleansing Timeout application setting - Select the number of seconds (1 to 120) that OPERA will wait for a response from the address cleansing interface.

Note: The application setting Profiles>Address Cleansing Timeout is also used to configure external address cleansing interfaces. Therefore it will always be available from the Application Settings menu regardless of whether AddressDoctor is installed or not.

Profiles>AddressDoctor Batch Cleanse Days application setting - How far back from the current date should the Address Cleansing Batch process go in checking profiles for new and changed address information? Select a number of days. 2000 days is the maximum. The default is 7.

Profiles>AddressDoctor Max Batch Process Time - Select the maximum time (in hours and half hours) that the Address Cleansing batch process should be allowed to run. Options range from 0.5 hour to 24 hours. The default is 1 hour.

Profiles>AddressDoctor Profile Types application setting - Select the profile type(s) for which AddressDoctor will validate address information.

Profiles>AddressDoctor Membership Types - Select the membership type(s) for which AddressDoctor will validate address information.

AddressDoctor Setup Screen (OPP_ADDO License Inactive)

When the OPP_ADDO add-on license code is inactive, and no other form of address cleansing has been selected (Quick Address, etc.) a new feature displays on the AddressDoctor Setup screen which enables you to trial AddressDoctor address cleansing software. Once a demo account ID and password have been established, these are then automatically populated in the AddressDoctor Setup screen Customer ID and Password fields.

The OPP_ADDO AddressDoctor Interface add-on license is then set to active without a license code until such time as the trial period ends. Each time the AddressDoctor option is initiated, OPERA performs a check to verify that the demo account ID and password are still valid. If a message of 'expired' is returned from AddressDoctor's Account Management database, the add-on license OPP_ADDO is disabled along with the AddressDoctor functionality.

Note: Prior to de-activating the OPP_ADDO add-on license after the trial period expires, you are taken to a URL which will provide you the option to purchase licensing for the AddressDoctor software.

Demo. Contacts AddressDoctor for a demo account ID and password.

To obtain an AddressDoctor demo account ID and password and initiate the trial period, select the Demo button from the AddressDoctor Setup screen. AddressDoctor receives your request and returns and account ID and password, at which time the Customer ID and Password fields are automatically populated with the demo account ID and password and the Demo button disappears. This begins the initial activation of the AddressDoctor trial period. Once this step is completed, you have sixty days to demo the software.

Note: The AddressDoctor demo period (60 days from activation) allows for up to 1000 interactive (or FastCompletion) and 500 batch transactions.

When the demo license acquired from AddressDoctor has expired the following message displays: 'AddressDoctor Demo License has expired. Please contact AddressDoctor for License Information.' At this point you are logged into the AddressDoctor's Account Management Web Services to review your licensing options. This will occur at any time after the demo period has expired and address cleansing is initiated.

AddressDoctor Setup Screen (OPP_ADDO License Active)

Next, access Configuration>Profile>AddressDoctor Setup. The AddressDoctor Setup screen appears.

Provide the following information and select the OK button.

Note: See AddressDoctor.pdf documentation provided in the Tools/ORS directory of your OPERA installation for complete information.

Customer ID. This information provided by AddressDoctor when you set up a user account.

Password. This information provided by AddressDoctor when you set up a user account.

Campaign ID. A tag that will be passed to AddressDoctor to identify a specific request for verification for billing purposes. Up to 20 characters.

Country of Origin. Select the down arrow to choose how country information should be handled. Options include:

COO_ALWAYS_USE_DESTINATION_COUNTRY - This is the default. The country name will always be used in the formatted address.
COO_NEVER_USE_DESTINATION_COUNTRY - The country name will never be used in the formatted address.
COO_code - Select the country code for the country if a specific country is to be assumed for all addresses. (e.g., select COO_ARW if the country portion of the address is always to be assumed to be Aruba). The country codes are ISO3 country codes.

Country Type. The ISO country type controls the format of the country part of the verified address returned from AddressDoctor. The default is ISO2.

Preferred Language. Overall language used for the returned address. PFL_LATIN_SCRIPT is the default. With this Preferred Language selected, a Greek address, for example, would be returned in Latin script (Romanized).

Capitalization. The letter case used for the returned verified address. The default is UPPER_CASE.

HTTP Server

Interactive. Web URL of the AddressDoctor server that processes your verification requests using the AddressDoctor's Interactive Web Service. This information is provided by AddressDoctor. The default is http://validator2.AddressDoctor.com/addInteractive/Interactive.asmx. The Interactive Web Service accepts one address at a time for validation then returns suggestions for incorrect addresses.

Action. This field contains an HTTP header which provides access to the AddressDoctor's Interactive Completion Web Service. This information is provided by AddressDoctor. The default is http://validator2.AddressDoctor.com/addInteractive/Interactive/Validate.

FastCompletion. Web URL of the AddressDoctor server that processes your verification requests using the AddressDoctor's FastCompletion Web Service. This information is provided by AddressDoctor. The default is http://validator2.AddressDoctor.com/addFastCompletion/FastCompletion.asmx. The FastCompletion Web Service will automatically complete the data entered or generate meaningful suggestions that a user can pick from.

Action. This field contains an HTTP header which provides access to the AddressDoctor's FastCompletion Web Service. This information is provided by AddressDoctor. The default is http://validator2.AddressDoctor.com/addFastCompletion/FastCompletion/Validate. The AddressDoctor will initiate its search for the most likely results when the fields Country and Postal Code are populated on these screens; Profile screen, Accounts screen, Contact screen, Quick Profile screen, Addresses screen. In FastCompletion mode only, results are limited to 20 suggestions per entry. This is done to prevent overloading a user with only partially relevant information.

Batch. Web URL of the AddressDoctor server that processes your verification requests using the AddressDoctor's Batch Web Service. This information is provided by AddressDoctor. The default is http://validator2.AddressDoctor.com/addBatch/Batch.asmx. The Batch Web Service can process multiple addresses at once (up to ten) then returns results, marked either valid or invalid, but does not provide any suggestions for incorrect addresses.

Action. This field contains an HTTP header which provides access to the AddressDoctor's Batch Web Service. This information is provided by AddressDoctor. The default is http://validator2.AddressDoctor.com/addBatch/Batch/Validate.

User Permissions

Separate user permissions control access to AddressDoctor configuration options (AddressDoctor Setup) and the ability to resubmit an address that has been previously cleansed (Recleanse Address).

S&C Cleanse Address Procedure

With OPERA Sales and Catering, the Cleanse Address batch process can be run as a background process. Select Configuration>Database>Process Scheduling to access the Background Processor Setup screen.

ORS Cleanse Address Procedure

To implement the Cleanse Address batch process in ORS, Select Configuration>Setup>Background Process Setup to display the Background Processor Setup screen.

Edit the Cleanse Address procedure to make it active and to set run parameters.