Occurs on calling a method of a tested web service.
Declaration
| Sender | [in] | Required | Variant | |
| Request | [in] | Required | An IXMLDOMDocument object |
|
| Helper | [in] | Required | A WebServiceHelper object |
|
| RequestInfo | [in] | Required | A WebServiceRequestResponseInfo object |
Description
This event occurs when you call a method of your tested web service from a script or keyword test before a request to the web service is made.
You can write the OnWebServiceRequest event handler to perform actions over requests. To access the request content, use the Request parameter of the event handler. You can also add custom SOAP headers to a request by using the Helper parameter.
The event is triggered upon a call to the tested web service method. If in your tests you call several web service methods and you want to process the requests sent only to some of them, use the RequestInfo parameter to determine the name of the called method and the name of the web service to which a request will be sent.
Parameters
The event has the following parameters:
Sender
The Event control that processes the event.
Request
An object implementing the IXMLDOMDocument interface and containing the SOAP request to be sent to the web service. To access and modify data contained in the request, use the properties and methods of the IXMLDOMDocument interface.
For more information on the interface and DOM, see the XML Core Services and Document Object Model article in the MSDN library.
| Note: | The SOAP request generated by the test engine does not contain the Header element. You can use the WebServiceHelper.AddHeader method to add custom headers. |
Helper
A WebServiceHelper helper object that you can use to add custom headers to the SOAP request.
RequestInfo
A WebServiceRequestResponseInfo object that provides information on the tested web service and on the called method.
Remarks
For information on how to create an event handler for this and other TestComplete events, see Creating Event Handlers for TestComplete Events.
Example
The following example demonstrates how to create an OnWebServiceRequest event hander and use it to add custom headers to a web service request:
JavaScript, JScript
// The routine calls methods of the tested web service
function Main()
{
WebServices.SampleWebService.Authenticate();
WebServices.SampleWebService.ProcessData();
…
}
// The OnWebServiceRequest event handler
function GeneralEvents_OnWebServiceRequest(Sender, Request, Helper, RequestInfo)
{
// Determines the name of the tested web service and the called method
var methodName = RequestInfo.MethodName;
var serviceName = RequestInfo.ServiceName;
if ((serviceName == "SampleWebService") && (methodName == "Authenticate"))
{
// Adds custom headers with authentication information to the request
Helper.AddHeader("UserID", "http://tempuri.org/", "jsmith");
Helper.AddHeader("Password", "http://tempuri.org/", "25jeL3n");
}
}
Python
# The routine calls methods of the tested web service
def Main():
WebServices.SampleWebService.Authenticate()
WebServices.SampleWebService.ProcessData()
# ...
# The OnWebServiceRequest event handler
def GeneralEvents_OnWebServiceRequest(Sender, Request, Helper, RequestInfo):
# Determines the name of the tested web service and the called method
methodName = RequestInfo.MethodName
serviceName = RequestInfo.ServiceName
if ((serviceName == "SampleWebService") and (methodName == "Authenticate")):
# Adds custom headers with authentication information to the request
Helper.AddHeader("UserID", "http://tempuri.org/", "jsmith")
Helper.AddHeader("Password", "http://tempuri.org/", "25jeL3n")VBScript
' The routine calls methods of the tested web service
Sub Main
WebServices.SampleWebService.Authenticate
WebServices.SampleWebService.ProcessData
…
End Sub
' The OnWebServiceRequest event handler
Sub GeneralEvents_OnWebServiceRequest(Sender, Request, Helper, RequestInfo)
' Determines the name of the tested web service and the called method
methodName = RequestInfo.MethodName
serviceName = RequestInfo.ServiceName
If serviceName = "SampleWebService" And methodName = "Authenticate" Then
' Adds custom headers with authentication information to the request
Call Helper.AddHeader("UserID", "http://tempuri.org/", "jsmith")
Call Helper.AddHeader("Password", "http://tempuri.org/", "25jeL3n")
End If
End Sub
DelphiScript
// The routine calls methods of the tested web service
procedure Main();
begin
WebServices.SampleWebService.Authenticate();
WebServices.SampleWebService.ProcessData();
…
end;
// The OnWebServiceRequest event handler
procedure GeneralEvents_OnWebServiceRequest(Sender, Request, Helper, RequestInfo);
var methodName, serviceName;
begin
// Determines the name of the tested web service and the called method
methodName := RequestInfo.MethodName;
serviceName := RequestInfo.ServiceName;
if ((serviceName = 'SampleWebService') and (methodName = 'Authenticate')) then
begin
// Adds custom headers with authentication information to the request
Helper.AddHeader('UserID', 'http://tempuri.org/', 'jsmith');
Helper.AddHeader('Password', 'http://tempuri.org/', '25jeL3n');
end;
end;
C++Script, C#Script
// The routine calls methods of the tested web service
function Main()
{
WebServices["SampleWebService"]["Authenticate"]();
WebServices["SampleWebService"]["ProcessData"]();
…
}
// The OnWebServiceRequest event handler
function GeneralEvents_OnWebServiceRequest(Sender, Request, Helper, RequestInfo)
{
// Determines the name of the tested web service and the called method
var methodName = RequestInfo["MethodName"];
var serviceName = RequestInfo["ServiceName"];
if ((serviceName == "SampleWebService") && (methodName == "Authenticate"))
{
// Adds custom headers with authentication information to the request
Helper["AddHeader"]("UserID", "http://tempuri.org/", "jsmith");
Helper["AddHeader"]("Password", "http://tempuri.org/", "25jeL3n");
}
}
See Also
Testing Web Services
Adding Custom Headers to SOAP Requests
OnWebServiceResponse Event
Handling Events
Event Control