Matchcode

 

Example Name:                              Example3.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 PAF file.

 

 

Could be used as a starting point for:

 

Rapidly capturing customer address information, along with other details (fax/telephone number) for inclusion in a customer database.

 

Where to find the example code:

 

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

 

C:\Program Files\Capscan\SDK\Matchcode Client API\CGI\HTML\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?

 

Example3.htm                                     Passes address details from the form to mcdquery.exe to complete the address and return the postcode.   It also captures non-address information for addition to a customer database.

 

 

 

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 PAF pool is set in the local spider.ini file.

 

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

 

4.       Open Internet Explorer and enter HTTP://themachinename/example3.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.

 

 

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 Matchcode DC application to test that the Capscan Pool Manger is working correctly.  The installation for Matchcode DC can be found on the CD under:

 

Api\mcd_cs\win32\client\dc.

 

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