Zapcode

 

Example Name:                              Example2.htm

 

Language:                                       HTML

 

API type:                                           CGI

 

API component filename:            mcdquery.exe

 

Environment:                                  Web Browser

 

 

What does it do?

 

Demonstrates calling the CGI client via the POST method.

 

This example is designed to work with the UK RAF file.

 

 

Could be used as a starting point for:

 

The address verification section of an online order form.

 

 

Where to find the example code:

 

After running the setup from the Zapcode CD to install the client APIs you will find these examples installed (by default) in:

 

C:\Program Files\Capscan\SDK\Zapcode Client API\CGI\Examples

 

If you have installed to another location you will need to change the path where necessary.

 

 

What each file does:

 

File name                                         What does it do?

 

Example2.htm                                     Passes address details from the form to mcdquery.exe to complete the address and return the postcode.   It also allows for interactive resolution of any ambiguities in the address.

 

 

 

Preparing to run the example:

 

Please make sure that you have installed the Capscan Pool Manager and that it is up and running.

 

 

Running the example:

 

1.       Make sure mcdquery.exe is in cgi-bin.

 

2.       Make sure the RAF pool is set in the local spider.ini file.

 

3.       Copy Example2.htm to the document root folder of the web server (wwwroot in IIS).

 

4.       Open Internet Explorer and enter HTTP://themachinename/example2.htm.  Where “themachinename” is the name of the machine that has the HTML page in its document root.

 

5.       When the example page has loaded, enter some address details and click the Submit button.  It will complete the address as far as possible and report the ambiguities for clarification.

 

 

Trouble-shooting and hints:

 

1.       If you are running on a LAN make sure that the Capscan Pool Manager is running correctly.  To do this you can use the PoolMan Admin application that is installed along with the Capscan Pool Manager.

 

2.       If you are using a firewall make sure that it is not blocking this example or the Capscan Pool Manager.  By default the Capscan Client/Server uses port 27920 for sending and receiving data.

 

3.       Try installing and running the Zapcode application to test that the Capscan Pool Manger is working correctly.  The installation for Zapcode can be found on the CD under:

 

                Api\zcd_cs\win32\client\zapcode

 

4.       For more hints and tips please see the SDK bookshelf documentation.