Configure an Address Validation Provider

If, when you install an address validation service, you select to configure your validation provider at a later time, use this procedure to configure Satori or another validation provider such as a web service.

Note: To use an address validation provider other than Satori, you must first create a new Class Library project and add a reference to the Blackbaud.AppFx.AddressValidation.Service.exe. Within this project, create a class that implements the four interfaces required for address validation providers: IValidationProvider, IAddressValidation, IAddressBrowser, and IAddressPresort. After you create the class in the project, build and copy the *.dll file to a location on your address validation server. When you configure the provider, you must map to the *.dll file.

  1. On the application start page, select Utilities. The Utilities, Gadgets and Reference page appears.

  2. Under ClickOnce Utilities, select Address Validation Service Deployment. The Address Validation Install utility appears.

  3. Under Installation Type, select Configure validation provider and select Next. The Validation Provider Type screen appears.

  4. For Provider, select Satori and select Next. The Satori Data File Location screen appears.

  5. Under Satori Data File Location, browse to the Postal Tools folder created when you install the validation service.

  6. Select Next. The Satori Configuration Review screen appears.

  7. Under Satori Configuration Review, verify your installation settings are correct. To adjust a setting, select Previous to access the applicable screen of the installation utility.

  8. Select Finish. After the utility successfully sets up the web server, a message appears.

  9. Select OK. You return to the Utilities, Gadgets and Reference page.

    Warning: Web server configuration is independent of the validation provider. Unless you remove the validation service, move it to another location, or change connectivity ports, you only need to set up the web server once. For information about how to configure your web server, refer to Configure the Web Server for Address Validation.

  1. On the application start page, select Utilities. The Utilities, Gadgets, and Reference page appears.

  2. Under Utilities, select Address Validation Service Deployment. The Address Validation Install utility appears.

  3. Under Installation Type, select Configure validation provider and select Next. The Validation Provider Type screen appears.

  4. For Provider, select Other and select Next. The Web Service Options screen appears.

  5. In the Assembly field, browse to the assembly *.dll file created for the address validation service.

  6. If the selected *.dll file defines a single provider, the Provider field displays the defined provider. If the *.dll file defines multiple providers, select the provider to use.

  7. In the Service URL field, enter the web address to the address validation service.

  8. If the validation provider requires login credentials, enter the user name and password used to access the service.

  9. Select Next. The Installation Review screen appears.

  10. Under Installation Review, verify your installation settings are correct. To adjust a setting, select Previous to access the applicable screen of the installation utility.

  11. Select Finish. After the utility successfully sets up the web server, a message appears.

  12. Select OK. You return to the Utilities, Gadgets, and Reference page.

    Warning: Web server configuration is independent of the validation provider. Unless you remove the validation service, move it to another location, or change connectivity ports, you only need to set up the web server once. For information about how to configure your web server, refer to Configure the Web Server for Address Validation.