0845 600 9231 Hopewiser on Facebook Hopewiser on Twitter

Hopewiser Web Services

AddressServer Desktop Client

Contents

Introduction

FastAddressClient is a windows based desktop application that utilises Hopewiser's AddressServer to provide an easy method for address capturing. You can search on either an incomplete address or postcode and send the results to another application.

To use the application you will require a Hopewiser web service account. If you don't already have an account, then please register on-line or alternatively contact us.

Intended Audience

This documentation is aimed at customers who wish to perform address capture via a standalone desktop application. It covers an overview of the FastAddressClient features to help you get up and running quickly. For further information, the program contains full online help and includes a printable PDF manual as part of the installation.

If you require a embedded solution, then please refer to our service APIs.

How do I install the desktop client?

Download the FastAddressClient application from the AddressServer Downloads page (please note that you will need the username and password specified during registration to access the downloads page).

  AddressServer Downloads

Uncompress the downloaded FastAddressClient.zip file and then run FastAddressClientSetup.exe. When prompted, allow the program to run at the "Unknown Publisher" warning.

Follow the setup instructions, choosing the default options, until the installation is complete.

How do I sign in to my account?

The first time you run FastAddressClient you will be prompted to sign in to the AddressServer. You can also access the Sign in window from the Settings menu.

Enter your username and password, then click the Sign In button.

You should then select the Master Address File (MAF) you wish to use and click OK. The uk-rm-paf-internal MAF is the dataset for which free clicks were created during registration. If you purchase a different dataset, then you will need to select it here.

An appropriate error message will be displayed if the sign in fails (please refer to Common errors).

How do I perform an address search?

From the FastAddressClient home page enter the required search criteria and click the Search button. The search criteria can be a postcode, full or partial address. Single character (?) and multi character (*) wildcards are also supported. Please note that separating individual address elements with a comma yields better results, for example "Downing Street, London".

Select the appropriate item from the Possible Matches text box, by double clicking on the item text. When a complete address is reached it will be displayed in the Completed Address text box.

How do I send address fields to another application?

FastAddressClient is installed with a predefined SendKeys configuration that will send address labels to the foremost window with each element output on a new line.

This section covers a step-by-step guide to setting up the SendKeys functionality. It sends keys to Notepad as a demonstration. Sending to other applications simply requires substituting the appropriate target window and key combinations for navigating between fields.

First, start an empty Notepad. You should have a screen such as the following:

Return to FastAddressClient, click the Setup icon in the toolbar and then click the Select Target Window link from the left hand options.

Select the window you wish to send the address fields to. In this case toggle the By Z-Order/By Title button so that Untitled - Notepad is displayed and select it, then click the Next >> button.

If you wanted to, you can now choose to start the target application each time address fields are sent to it by clicking the Configure Target Application Startup... button (Please refer to the online help for further information).

Click the Next >> button.

Choose the fields that you would like to send to the target application. For the demonstration we will choose to send an address label and a UDPRN.

Click the Next >> button.

This page allows you to specify key strokes that are applied between each output field, such as tabs to navigate the cursor within the target application. For demonstration purposes we will change the predefined configuration to place a comma between each field.

Highlight the Final Keys column for all fields except the final UDPRN field, then click the Edit/Record Keys... button.

Click the Clear All button, enter a comma and then click the OK button.

If the Final Keys value for the UDPRN field is not {ENTER}, then highlight the value, click Edit/Record Keys.. and repeat the above actions entering a carriage return instead of a comma.

When finished the page should look similar to that shown above.

Click the Next >> button.

Next, choose what you want FastAddressClient to do after an address has been sent. You may select to close FastAddressClient after sending an address for example, then click the Done button.

Finally toggle the Send/Copy/Copy and Send button to specify a Send button, by clicking on the ... button and selecting Send from the available options.

The previous image shows a captured address ready to be sent to Notepad.

When you have matched an address click the Send button to send the address fields to the target application, in this case Notepad. The address fields will be sent to Notepad as seen in the image below.

Common errors

The most common problem is "401 Unauthorized" which indicates that an invalid username or password was entered:

A "Could not resolve host" error indicates you have entered an incorrect Host (and no such host exists):

A "404 Not Found" error indicates you have entered an incorrect Host (it does exist but does not understand AddressServer requests):

A "MAF invalid" error indicates that an incorrect or unavailable value was used for the Dataset. Check that the user has permission to use the dataset:

Any other errors are likely to be related to your firewall and/or proxy setup. Searching for the final part of the message online may help, alternatively email the support team with your settings and the exact error and they will be happy to help.



Previous page: Authorisation Code Generator
Next page: Mobile App