TestRunResults_Update Operation

Applies to QAComplete�14.4, last modified on June 20, 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