Introduction

Web services signal a new age of trivial distributed application development. While Web services are not intended nor do they have the power to solve every distributed application problem, they are an easy way to create and consume services over the Internet. One of the design goals for Web Services is to allow companies and developers to share services with other companies in a simple way over the Internet. Web services take Web applications to the next level. Using Web services, your application can publish its function or message to the rest of the world.

Web services use XML to code and decode your data and SOAP to transport it using open protocols.

Using Web services, you can exchange data between different applications and different platforms.

With Microsoft .NET platform, it is a simple task to create and consume Web Services. In this article, I am going to show how to call a published Web service inside a Web project. I use a test published Web service; Extentrix Web Services 2.0 Application Edition that Extentrix published for the developer community to help them in testing and developing.

So I'll simply explain the functions of this Web services APIs. In general Extentrix Web Services for Citrix Presentation Server helps you get information about a published application for a specific client with the specified details, server types, and client types. It also returns the ICAfile description to be used to launch an application with a given parameter and checks the user's credentials and returns true if they are valid.

For more information, visit this website. You can find more samples, use this web service, and test it here.

Background

Knowledge in ASP.NET is preferred.

Using the Code

Simple Steps to Consume a Web Service

Create a Web Site project

Add a Web Reference

Call the Web services APIs inside the code

First Step: Create a Web Site Project

To create a new Web Site project, choose New from File menu, then choose Web Site as shown below:

Choose ASP.NET Web Site. Name the project and click OK:

Second Step: Add a Web Reference

After creating the Web Site project, it’s time to add a Web reference for our Web service.

In the solution explorer, right click the project node, choose Add Web Reference:

Set the values for Citrix credentials. I set the credentials values for the test of Extentrix Web Service:

//set credentials
//these values are according to Citrix testdrive presentation server
//for which Extentrix published a web service for developers to use it
//as a test web service.
credentials.Password = "demo";
credentials.UserName = "citrixdesktop";
credentials.Domain = "testdrive";
//because it is a sample, we will use no encryption method.
//so the password will be sent as a clear text.
credentials.PasswordEncryptionMethod = 0;
//set the domain type to windows domain
credentials.DomainType = 0;

Now we can call any Web services available. It is as simple as calling any ordinary function.

Call the GetApplicationsByCredentialsEx Web service. This web service takes the following parameters:

I am not going to explain Extentrix Web services APIs, if you are interested, you can go here and look for it.

This API returns an array of ApplicationItemEx. This class will be built for you once you add the Web reference.

This class contains the published application properties. I used this Web service to get all the published applications, and then I created an ImageButton for each application.

// 1) Get all the published applications list by calling GetApplicationsByCredentialsEx
// web service.
// 2) create an ImageButton for each application
// 3) Create Image for the application
// 4) Add it to the AppList panel.
// 5) Set the event handler for each ImageButton, so when clicking it the associated
// application will run calling the web service
ApplicationItemEx[] items = proxy.GetApplicationsByCredentialsEx
(credentials, Request.UserHostName,
Request.UserHostAddress, newstring[] { "icon","icon-info"}, newstring[]{ "all" },
newstring[] { "all"});
//loop for each published application
for (int i = 0; i < items.Length; i++) {
//create the ImageButton
System.Web.UI.WebControls.ImageButton app = new System.Web.UI.WebControls.ImageButton();
//set the Image URL to the created image
app.ImageUrl = createIcon(items[i].InternalName,items[i].Icon);
//set the ToolTip to the name of the published application
app.ToolTip = items[i].InternalName;
//add the ImageButton to the AppList panel
AppList.Controls.Add(app);
//set the event handler for the ImageButton.
app.Click += new
System.Web.UI.ImageClickEventHandler(this.OnApplicationClicked);
}

Finally, another example in calling a Web service is to launch the published application. In this example, in the event handler of the applications ImageButtons I launch the clicked application.

I get the ICA file content by calling LaunchApplication Web service. Then I write the ICA file content to the response to launch the application.