TestRunResults_Update Operation

Applies to QAComplete 14.3, last modified on February 19, 2024

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

Highlight search results