In this service integration the SDK's SOAP interface is called from a simple Windows Forms Application named WindowsFormsTestApp. In our example, we use the approach to integrate the web service as .NET Web Reference and not as Service Reference. According to our experience, this style is easier to handle. But you can also chose to integrate the web service as Service Reference.

1. In Visual Studio's Solution Explorer window, right click the project name and select Add Service Reference... in the menu.
   

2. The Add Service Reference dialog opens. Click Advanced...
   

3. The Service Reference Settings dialog opens. Click Add Web Reference...

   
   

4. The Add Web Reference dialog opens.

   1. Enter the WSDL URL of the Web service (1) (http://localhost:54880/?wsdl)

   2. Press Enter or click the white/green arrow button (2). The service and its methods are displayed.

   3. Enter a meaningful name like CardSDK for the Web reference name (3).

   4. Click Add Reference (4) to create the Web reference and to close the dialog.
      

5. The reference is now ready to use.

To call the capture dialog, enter some code like the following in any method of your application. We use a simple button-triggered event. You may call all other requests of the web service in corresponding way:

private void button1_Click(object sender, EventArgs e)
{
	int iResultId;
	String strResultText;
	String strResultData;
	String strRequestData = "<?xml version=\"1.0\"?>"
	+ "<image type=\"photo\" format=\"jpg\" ><result data=\"\"/></image>";

	CardSDK.IDProductionService ws = new CardSDK.IDProductionService();
	iResultId = ws.ImageCapture(strRequestData,
		out strResultText, out strResultData);
	if (iResultId == 0)
	{
		// ... strResultData contains the request's response XML which contains
		// the returned image. You may process it using any XML parser
		// (e.g. .NET's XmlDocument)
	}
}

The SDK provides the Visual C# example that uses the web service as described here. You can find the examples in the examples directory of the SDK installation.

Using Java and the web service's SOAP interface, the Java API for XML Web Services (JAX-WS) in combination with the wsimport tool, is usually the first choice to access a web service. API and wsimport tool are part of the JDK package since Version 6.

Also Apache Axis can be used. But as Axis requires additional packages, we will only show the wsimport way here.

When developing an application using Java, the SOAP way with wsimport generated wrappers may be easier, as the created classes may support the development (provided that Java 6 or higher is used). But you can also use the equivalent RESTful way.

XMLHttpRequest (XHR) as used here, is the API to send HTTP requests from within a browser. It is available in the described way in all up-to-date browsers (Mozilla, Opera, Chrome and Internet Explorer). However, the way the IE supports XHR does strongly depend on its version:

• IE 5, 5.5 and 6 support XHR, but require a different object instantiation.
• IE 7 allows the usage as described in this article.
• IE 8 and IE 9 support XHR basically but prevent cross-site requests. This is important in our use case: The HTML page is usually provided by an application server with a domain that is different from the production service's domain. Only in the special case of the IDProductionService, application server and production service domain are identical. Instead, Microsoft introduced the XDomainRequest (XDR) object to make cross-domain requests. XDR is a stripped-down XHD.
• IE 10 allows cross-domain requests using XMLHttpRequest. It can be used in the same way as used with Mozilla, Opera and Chrome.

Using XMLHttpRequest and XDomainRequest directly as shown here is the basic way to communicate with a web service using Java script. However, it may be a more convenient way to use a library like jQuery package (http://jquery.com) or one of its alternatives. For more information, refer to the libraries public documentation. The usage of such libraries may help to solve issues using different browsers and their versions.