The Primary API is supplied with a simple text-based application, called SingleLineTestHarness64.exe or SingleLineTestHarness32.exe (qs_sl on UNIX), and with sample code. Together these can be used to verify that you have installed Pro API correctly, and to demonstrate some of the API's key functionality.
The test harness is not intended to be used as a commercial application.
The test harness enables you to obtain matching addresses and picklists from input address information that you type in on the command line.
The examples in this section use the C version of the test harness.
If you are using Windows, run the test harness from the shortcut (C Primary API Program) in the Program Group which was created when you installed Pro API.
The test harness appears.
To perform a Single Line search, follow these steps:
Press Enter again to select the default dataset.
Alternatively, type ? and press Enter to display a list of all datasets with their identifiers. Type the relevant code (for example, DEU for Germany, AUS for Australia) and press Enter to select the related dataset.
Once you have selected a dataset, enter a search string, separating each part from the next with a comma, and press Enter. For example (if you are using the GBR dataset):
linden gardens, london
For examples of searches with other datasets, see the Data Guide supplied with each dataset.
There are 181 possible matches, as shown by the Match Count.
Type 30 and press Enter to refine the picklist and to therefore reduce the number of matches. Press Enter at any prompt to remove the refine and return the list to the way it was.
There are now two matches displayed. Note that they are numbered from 1 to 2 in the picklist.
Type #1 and press Enter to select the first picklist entry.
The full address is returned.
If your text appears odd, this may be because any diacritics in the text (for example, accents and umlauts) are not displaying correctly in the DOS Console. You can remove diacritics with the OemCharacterSet setting.
The Pro API User Interface API is supplied with a very simple application called qs_ui.exe (32-bit) or qs_ui64.exe (64-bit), and with sample code. Together these can be used to verify that you have installed Pro API correctly, and to demonstrate some of the API's key functionality.
The test harness enables you to obtain matching addresses and picklists from input address information that you type in.
The UI integration scenario is the preferred solution on Windows because it uses the standard Pro dialog, thereby minimising the size and complexity of the integration, and meaning that you have access to all available search modes, as well as the standard User Interface functionality (selection of layouts and databases, menus, toolbars etc.).
If you are running the UI API test harness in client/server mode, any loss of connection between client and server results in the display of appropriate warnings.
The examples in this section use the C version of the test harness.
Run the test harness from the shortcut (C User Interface API Program) in the Program Group which was created when you installed Pro API.
The test harness appears, this is the Pro User Interface.
In the example below, you are searching for 7 Sand Lake Road in Orlando, FL, USA.
For examples of searches from other datasets, see the Data Guide supplied with your data.
Enter this search string:
orlando
The test harness starts searching as soon as you type the first character. After typing 'orlando', the test harness returns only one match for this search string.
Type sandl.
In this example it is the second match in the list that you want.
Use the arrow down cursor key to move the focus to Sand Lake Rd Orlando FL. Click the Select button (or press Enter) to step into Sand Lake Rd.
There are too many matches to display in a picklist.
Type 7.
The match that you want is returned at the top of the picklist.
Pro also returns several other matches, and, where appropriate, has split the matches into odd and even number ranges.
Click on the Select button or press Enter.
The full address is returned to the address edit screen.
Enter a search string, separating each part from the next with a comma, and select the Search button (or press Enter). For example (if you are using the Australia dataset):
65 Rushton St, Carnarvon, WA
The test harness returns only one address which precisely matches your search criteria, it returns it directly to the address edit screen.
For examples of searches from other datasets, see the Data Guide supplied with your data.
For example (if you are using USA Names dataset), type in the telephone number, 703 815 7850, and press Enter.
A picklist is returned, containing the property details and a list of all registered occupants.