.NET SOAP Client
- Mahnoor Khan (Deactivated)
- Greg Walsh
When consuming the EngageIP WSDL file using a .NET language you are able to use Visual Studio's built in Service Reference capability to import the WSDL file and automatically generate the code stubs for calling the service.
To get started, right click on the References node for your .NET project and select "Add Service Reference".
An Add Service Reference dialog will appear. In this dialog select the "Advanced" button in the lower left hand corner of the screen.
This will bring up a new dialog for the Service Reference Settings where you can choose the "Add Web Reference" button from the Compatibility area at the bottom of the screen.
In the Add Web Reference dialog enter the path to your downloaded EngageIP WSDL file and select the go arrow.
You are now ready to add the reference to your project by selecting the "Add Reference" button.
To begin using the web reference your application code you'll need to import your new reference with a using clause.
using MyEngageIPClient.WebReference; Next create an instance of the EngageIP web service, configure the target URL, assign your credentials and call the desired EnageIP SOAP method.
EngageIPWebServicesAPI webService = new EngageIPWebServicesAPI();
// Set the target URL for the web service
webService.Url = "https://mydomain/adminportal/webservice.asmx";
// set our authentication credentials
webService.AuthHeaderValue = new AuthHeader();
webService.AuthHeaderValue.Username = "admin";
webService.AuthHeaderValue.Password = "admin";
// Call our desired SOAP method
ViewUser user = webService.GetUserDetail("admin");
MessageBox.Show("name:" + user.Name);These steps should have you up and on your way to completing your EngageIP integration!