Replaces the information on the test run result with that from the specified TestRunResult object. Uninitialized properties are cleared.
First, you usually call TestRunResults_Load to get a test run result by ID, change some of its properties, and then pass the updated object to TestRunResults_Update.
Requirements
The authenticating user must belong to a user group that has the Update privilege for Test Library.
Parameters
The operation uses the following parameters:
AuthenticationData : AuthenticationData, required
An AuthenticationData object containing the login information and the project ID that contains the test run results.
TestRunResult : TestRunResult, required
A TestRunResult object that contains updated information of the test run result.
SendEmailAlert : string, required
Y means send an email alert to the subscribed users after updating the test run result.
Any other value (for example, N or empty string) means do not send email alerts.
Result
None.
Example
Sample Code
C#
string login = "[email protected]";
string password = "p@ssword";
int projID = 10372;
// Specifying the test run to update
int ID = 1354;
ServiceSoapClient service = new ServiceSoapClient();
// Preparing AuthenticationData
LoginInfo loginInfo = service.GetLoginInfo("", login, password);
AuthenticationData authData = new AuthenticationData();
authData.AppCode = loginInfo.AppCode;
authData.UserId = loginInfo.UserId;
authData.PassCode = password;
authData.DeptId = loginInfo.DeptId;
authData.ProjId = projID;
// Loading the test run result
TestRunResult TestRunResult = service.TestRunResults_Load(authData, ID);
// Updating the status of the test run result
TestRunResult.StatusCode = "Blocked";
// Updating the test run result
service.TestRunResults_Update(authData, TestRunResult, "N");
Console.WriteLine("The test run item was updated");
Java
String login = "[email protected]";
String password = "p@ssword";
int projID = 10372;
// Specifying the test run item to update
int ID = 1354;
ServiceSoap service = new Service().getServiceSoap12();
// Preparing AuthenticationData
LoginInfo loginInfo = service.getLoginInfo("", login, password);
AuthenticationData authData = new AuthenticationData();
authData.setAppCode(loginInfo.getAppCode());
authData.setUserId(loginInfo.getUserId());
authData.setPassCode(password);
authData.setDeptId(loginInfo.getDeptId());
authData.setProjId(projID);
// Loading the test run result
TestRunResult TestRunResult = service.testRunResultsLoad(authData, ID);
// Updating the status of the test run result
TestRunResult.setStatusCode("Blocked");
// Updating the test run result
service.testRunResultsUpdate(authData, TestRunResult, "N");
System.out.format("Test run item was updated");
Sample Request XML
POST /psws/psws.asmx HTTP/1.1
Host: myteam.mysite.com
Content-Type: text/xml; charset=utf-8
Content-Length: 947 {Insert an appropriate value here}
SOAPAction: "http://www.pragmaticsw.com/TestRunResults_Update"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<TestRunResults_Update xmlns="http://www.pragmaticsw.com/">
<AuthenticationData>
<AppCode>agSP</AppCode>
<DeptId>7154</DeptId>
<ProjId>1032</ProjId>
<UserId>25315</UserId>
<PassCode>p@ssword</PassCode>
</AuthenticationData>
<TestRunResult>
<TestRunResultId>2157</TestRunResultId>
<TestRunItemId>1354</TestRunItemId>
<Seq>1</Seq>
<IsStoppedOnFail>Y</IsStoppedOnFail>
<StatusCode>Failed</StatusCode>
<Step>Select Tools from the application's main menu.</Step>
<ExpectedResults>The Tools dialog opens.</ExpectedResults>
<ActualResults>An error occurred when you click <b>Tools</b>.</ActualResults>
<TestStepId>10</TestStepId>
<ProjId>10372</ProjId>
</TestRunResult>
<SendEmailAlert>N</SendEmailAlert>
</TestRunResults_Update>
</soap:Body>
</soap:Envelope>
SOAP 1.2
POST /psws/psws.asmx HTTP/1.1
Host: myteam.mysite.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: 955 {Insert an appropriate value here}
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<TestRunResults_Update xmlns="http://www.pragmaticsw.com/">
<AuthenticationData>
<AppCode>agSP</AppCode>
<DeptId>7154</DeptId>
<ProjId>1032</ProjId>
<UserId>25315</UserId>
<PassCode>p@ssword</PassCode>
</AuthenticationData>
<TestRunResult>
<TestRunResultId>2157</TestRunResultId>
<TestRunItemId>1354</TestRunItemId>
<Seq>1</Seq>
<IsStoppedOnFail>Y</IsStoppedOnFail>
<StatusCode>Failed</StatusCode>
<Step>Select Tools from the application's main menu.</Step>
<ExpectedResults>The Tools dialog opens.</ExpectedResults>
<ActualResults>An error occurred when you click <b>Tools</b>.</ActualResults>
<TestStepId>10</TestStepId>
<ProjId>10372</ProjId>
</TestRunResult>
<SendEmailAlert>N</SendEmailAlert>
</TestRunResults_Update>
</soap12:Body>
</soap12:Envelope>
Sample Response XML
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: 315 {The server returns an appropriate value here}
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<TestRunResults_UpdateResponse xmlns="http://www.pragmaticsw.com/" />
</soap:Body>
</soap:Envelope>
SOAP 1.2
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: 325 {The server returns an appropriate value here}
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<TestRunResults_UpdateResponse xmlns="http://www.pragmaticsw.com/" />
</soap12:Body>
</soap12:Envelope>
See Also
TestRunResults_Load
TestRunResults_LoadByCriteria
Test Management Operations
Test Run Results Operations
SOAP API Reference