.NET example

Intro

The following is an example of how to use Insuma search engine Web Service remotedly from your Windows computer, using the MS .NET platform.

The search keywords which you enter are encoded into a SOAP request and sent to Insuma by .NET software. The results come back, get interpreted and shown to the end user as a nice hit list.

This example was tested under MS Windows 2000 and MS Windows XP, but would probably work in the subsequent versions. You must be experienced in Microsoft web hosting and .NET framework to deploy this example.

This example supports 3 following scenarios:

Simple - You download a self-installing package. When installed you can click on the search icon at your desktop and start searching over the network on our server. This is merely for demonstration of the technology.
advanced - You wish to modify search form, particulary change the engine ID or adjust search layout to your language, you edit the search form file and recompile the project. This can be useful when the service description in WSDL has changed or you would like to compile the whole thing for your particular hardware.
Expert - You downloads the source files and create your own project based on them.

You will need Microsoft Visual Studio .Net in order to execute advanced and expert scenarios.

Simple

Install MS .NET 1.1 Framework. Use your Microsoft .NET installation disk or download it from: http://msdn.microsoft.com/netframework/downloads/howtoget.aspx (Skip this step if you already have .NET 1.1 installed on your computer. )
Download the Simplest.zip and install it.
Run InsumafocusWindowsDotNetExample icon on desktop and the search window starts immediately.

Advanced

Install MS .NET 1.1 Framework. Use your Microsoft .NET installation disk or download it from: http://msdn.microsoft.com/netframework/downloads/howtoget.aspx (Skip this step if you already have .NET 1.1 installed on your computer. )
Download the Advanced.zip and install it.
Open Microsoft Visual Studio .Net 2003 project file: WindowsApplication1.csproj.
Add a reference InsumaFocus under "References" from project folder.

Congratulations, you are done! Now you can improve the search form and the search result screens gradually, using your Visual Studio .NET 2003.

Expert

Install MS .NET 1.1 Framework. Use your Microsoft .NET installation disk or download it from: http://msdn.microsoft.com/netframework/downloads/howtoget.aspx (Skip this step if you already have .NET 1.1 installed on your computer. )
Download the file Form1.cs.
Generate local Web Service proxy class. Generate insumafocus.dll library (it is specific for your hardware platform). The DLL library can be created using existing tools like wsdl.exe or csc.exe (those included in .NET 1.1 Framework). The library provides interaction between your computer and Insuma Focus service. for wsdl.exe it is usually done by the commands:
```
wsdl.exe http://www.insuma.de/wsdl/demo.wsdl 

csc /target:library InsumaFocus.cs
```
where the URL in the parameter is the WSDL contract exposed at Insuma server. Consult wsdl help and internet resources on further details.
Compile application and run:
```
 
csc /target:winexe Form1.cs /r:InsumaFocus.dll
```
Congratulations, you are done! Now you can improve the search form and the search result screens gradually (file: Form1.cs), using your editor.