Overview

FastAddressClient is a windows based desktop application that utilises Hopewiser's Address Lookup 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.

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 which you can download here

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

Demo

Quick Start

Download the FastAddressClient application from here

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.

fastaddressclient-installing

Sign Up for An Account

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

Create a token in the management interface and enter its username and password, then click the Sign In button.

fastaddressclient-signin

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 the "Common errors" section below for more details).

1. 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.

fastaddressclient-search

2. 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:

fastaddressclient-notepad

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

fastaddressclient-select-target-window

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.

fastaddressclient-target-window-options

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.

fastaddressclient-select-output-fields

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

Click the Next >> button.

fastaddressclient-record-keystrokes

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.

fastaddressclient-keystroke-recorder

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.

fastaddressclient-sending-options

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.

fastaddressclient-send

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.

fastaddressclient-notepad-with-1-address

3. Common errors

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

fastaddressclient-error-401

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

fastaddressclient-error-unresolved-host

A "404 Not Found" error indicates an incorrect Host has been entered (it does exist but does not understand Address Lookup requests):

fastaddressclient-error-404

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:

fastaddressclient-error-invalid-maf

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.

1. Where can I use the FastAddressClient application?

This application can be utilised in querying addresses and associated data either via a client hosted AddressServer, or the Hopewiser hosted services (Address Lookup).

2. Why can't I Sign In using the FastAddressClient UI?

Ensure that the service is a valid one (eg, cloud.hopewiser.com for our hosted services) and that your username and password correspond to a token created in the management interface (please note that passwords are case sensitive).

3. What is the Host2 setting for in the Sign In panel?

This allows the stipulation of a secondary service endpoint should the primary one be offline or unavailable. Use of a load balanced service (such as the cloud.hopewiser.com hosted Hopewiser service) should negate the need to make use of this.

4. How do I stop the auto-download of FastAddressClient updates?

Using the argument '--dont-check-for-updates' in a user shortcut to the FastAddressClient application will prevent the update of the application unless prompted by the user, or system-wide.

5. Can FastAddressClient be used over IPV6?

Yes it can. FastAddressClient can utilise either IPV4 or IPV6 protocols.

6. How can I change the appearance of addresses displayed or captured?

Changes to address presentation (how matching results are first shown to you) and captured format (how this is written to the intended target) can be achieved through the Setup facet of the application - specifically the Matching Options within. Here (including the Advanced section potentially), you should be able to find an option to suit the requirement.

7. How can I have my users capture data in a consistent way using FastAddressClient?

FastAddressClient has a setup saving capability (accessed through the toolbar). Here, you can define a processing setup you wish to be used across the department or company, store this centrally, and have this referenced through a user shortcut deployed throughout the business ('...FastAddressClient.exe X:\FACSetup.hpw - g' in the shortcut properties). You can also lock this down using the illustrated -g switch.

8. Can I change the way data is written once captured?

FastAddressClient comes with SendKeys technology allowing the traversing of most controls in most desktop target windows. These can be implemented / adapted using the Setup section Record keystrokes panel. Essentially, you should be able to recreate any keyboard navigation within this definition meaning data is written to the correct target window control given a consistent start point.