Zapcode

 

Example Name:                              ZCD

 

Language:                                       C#

 

API type:                                           ActiveX

 

API component filename:            ZcClicon.dll

 

Environment:                                  Windows 2000, XP, Vista, (Using Visual Studio 2008, .Net Framework 3.5) 

 

 

What does it do?

 

Demonstrates the use of, communicating with the Capscan Pool Manager, searching, and working with ambiguity lists and additional data sets.

 

 

 

Could be used as a starting point for:

 

Creating an application to capture or verify an address using a postcode.   

 

 

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\ActiveX\Examples\CS

 

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?

 

ConnectionForm.cs                        Form used to select the server running the Capscan Pool                  Manager and to select the required pool.

 

InfoForm.cs                                          Form used to display the pool information and available fields.

 

>ZapcodeForm.cs                              The main form for searching and displaying the results.

 

ZcClicon.Interop.dll                            You need to add a reference to this file if you are going to be             calling the ActiveX from a .net application.

 

ZCD.sln                                                  Visual Studio 2008 solutions file.                  

 

Spider.ini                                              Capscan Client/Server configuration file.

 

 

Preparing to run the example:

 

If you are not using the Capscan OnDemand service, please make sure that you have installed the Capscan Pool Manager and that it is up and running.

 

You will need to register the ActiveX control before you can use it.  To do this:

 

1.       Open a DOS prompt in the same folder as ZcClicon.dll.

 

2.       At the prompt type in the following and press enter:

 

        regsvr32 ZcClicon.dll

 

 

Running the example:

 

1.       Make sure that the API library is in the search path.

 

2.       Open the ZCD.sln solution file using Visual Studio 2008.

 

3.       In the solution Explorer, under References, make sure that there is a valid entry for the ZcClicon.Interop.dll.

 

4.       Make sure that the Solution Configuration is set to Debug.

 

5.       Press F5 to run the example.

 

6.       From the Connection window select the connection type, host server name (and for OnDemand, you account details) and pool and click OK.

 

7.       Once you have connected to the Capscan Pool Manager or OnDemand server you will presented with the main window where you can enter an address to search on.

 

8.       Enter a postcode in the Input field and then press the F4 function key. 

 

 

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 the Capscan OnDemand service make sure that you can see the Internet.

 

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

 

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

 

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