TestSetItem Object

Applies to QAComplete 12.84 SaaS, last modified on July 19, 2021

A TestSetItem object represents an individual item (test) in a test set in QAComplete. Using the QAComplete SOAP API, you can add, load, modify, and delete items in test sets.

To manage items in test sets in QAComplete, you need a user account that belongs to a security group that has the following privileges:

  • The Read privilege for Test Library.

  • Read and Update privileges for Test Management > Test Sets.

You can view and set privileges in  > Setup > Security > Security Group > Manage Security Rights.

Properties

TestSetItemId  :  integer

The unique ID of the item among all items in all test sets in the project.

TestSetId  :  integer

The ID of the test set to which the item belongs.

TestId  :  integer

The ID of the test that corresponds to the item.

Seq  :  integer

The ordinal number of the item in the test set.

IsActive  :  string (max 1 char)

Specifies whether the item is enabled (active) in the test set.

IsStoppedOnFail  :  string (max 1 char)

Specifies whether the test set run will stop if the item fails.

DateCreated  :  dateTime

The date and time when the item was added to the test set.

DateUpdated  :  dateTime

The date and time when the item was updated in the test set.

CreateUserId  :  integer

The ID of the user who added the item to the test set.

UpdateUserId  :  integer

The ID of the last user who updates the item in the test set.

FolderName  :  string (max 511 chars)

The name of the folder to which the test that corresponds to the item belongs.

AssignedToName  :  string (max 78 chars)

The name of the user, to whom the test that corresponds to the item is assigned, in the Last name, First name format.

UserName  :  string (max 78 chars)

The name of the last user, who updated the test to which the item corresponds, in the Last name, First name format.

OwnerName  :  string (max 78 chars)

The name of the user, who owns the test to which the item corresponds, in the Last name, First name format.

LastRunByName  :  string (max 100 chars)

The name of the last user who run the test, to which the item corresponds, in the Last name, First name format.

Version  :  integer

The version of the test to which the item corresponds.

ProjId  :  integer

The ID of the project in QAComplete to which the item belongs.

FolderId  :  integer

The ID of the folder to which the test that corresponds to the item belongs. 0 if the test does not belong to any folder.

Title  :  string (max 100 chars)

The title of the test to which the item corresponds.

TestIsActive  :  string (max 1 char)

Specifies whether the test to which the item corresponds is active (enabled).

StatusCode  :  string (max 100 chars)

The status of the test that corresponds to the item. Possible values are based on the choice list.

ExecutionType  :  string (max 100 chars)

Specifies the execution type of the test to which the item corresponds. Possible values are based on the choice list. If no execution type is specified, empty string.

TestType  :  string (max 100 chars)

Specifies the type of the test to which the item corresponds. Possible values are based on the choice list. If no execution type is specified, empty string.

Priority  :  string (max 100 chars)

The priority of the test that corresponds to the item. Possible values are based on the choice list. If no priority is specified for the test, empty string.

Description  :  string (max 8000 chars)

The description of the test that corresponds to the item. Can include HTML markup. If no description is specified, empty string.

TestDateCreated  :  dateTime

The date when the test that corresponds to the item was created.

TestDateUpdated  :  dateTime

The date when the test that corresponds to the item was last modified.

TestCreateUserId  :  integer

The ID of the user who created the test that corresponds to the item.

TestUpdateUserId  :  integer

The ID of the last user who updated the test that corresponds to the item.

AssigneeUserId  :  integer

The ID of the user, to whom the test that corresponds to the item is assigned.

OwnerUserId  :  integer

The ID of the user who owns the test that corresponds to the item.

OriginalId  :  integer

The original ID if the test that corresponds to the item. If the test was not imported, 0.

ImportId  :  integer

The ID of the operation that imported the test that corresponds to the item. If the test was not imported, 0.

ScriptSourceId  :  integer

Reserved.

NbrFailStatus  :  integer

The number of times the test that corresponds to the item has failed.

NbrPassStatus  :  integer

The number of times the test that corresponds to the item has passed.

AvgRunTime  :  integer

The average run time of the test that corresponds to the item, in seconds.

AvgRunTimeFormated  :  string (max 100 chars)

The average run time of the test that corresponds to the item, in the hh:mm:ss format.

NbrTimesRun  :  integer

The number of times the test that corresponds to the item has run.

LastRunByUserId  :  integer

The ID of the last user who has run the test that corresponds to the item.

LastRunTestSet  :  integer

The ID of the last test set, as part of which the test that corresponds to the item has run.

LastRunTestSetTitle  :  string (max 100 chars)

The name of the last test set, as part of which the test that corresponds to the item has run.

LastRunDate  :  dateTime

The date when the test that corresponds to the item has run last.

LastRunStatus  :  string (max 100 chars)

Specifies the status of the last run of the test that corresponds to the item.

NbrSteps  :  integer

The number of steps that the test that corresponds to the item has.

NotesDescription  :  string (max 255 chars)

The latest note attached to the test that corresponds to the item. Can include HTML markup.

NbrEscalations  :  integer

The number of times the test that corresponds to the item was processed by escalation rules.

DateLastEscalated  :  dateTime

The date when the test that corresponds to the item was last processed by an escalation rule.

LastEscalationRuleId  :  integer

The ID of the last escalation rule that processed the test that corresponds to the item. 0 if no escalation rule has processed the test.

LastEscalationRule  :  string (max 100 chars)

The name of the last escalation rule that has processed the test that corresponds to the item.

NbrFilesNotSecured  :  integer

Reserved.

NbrFiles  :  integer

The number of files attached to the test that corresponds to the item.

NbrNotes  :  integer

The number of notes attached to the test that corresponds to the item.

NbrEvents  :  integer

Reserved.

ScriptName  :  string (max 510 chars)

Reserved.

Relevant Operations

Remarks

  • Some string property values are based on choice lists defined in your QAComplete project. You can find these values in Test Management > Test Library >  Tools >  Manage Choice Lists.

  • Unassigned date/time values (for example, in DateUpdated) are represented as 0001-01-01T00:00:00.

Example

XML

<TestSetItem>
  <TestSetItemId>1</TestSetItemId>
  <TestSetId>1</TestSetId>
  <TestId>1</TestId>
  <Seq>1</Seq>
  <IsActive>Y</IsActive>
  <IsStoppedOnFail>Y</IsStoppedOnFail>
  <DateCreated>2014-07-17T08:30:28</DateCreated>
  <DateUpdated>2014-07-20T10:53:07</DateUpdated>
  <CreateUserId>24661</CreateUserId>
  <UpdateUserId>24661</UpdateUserId>
  <FolderName>RegressionTests</FolderName>
  <AssignedToName>Doe, John</AssignedToName>
  <UserName>Doe, John</UserName>
  <OwnerName>Doe, John </OwnerName>
  <LastRunByName>Doe, John</LastRunByName>
  <Version>2</Version>
  <ProjId>11873</ProjId>
  <FolderId>12</FolderId>
  <Title>Test Input Data</Title>
  <TestIsActive>Y</TestIsActive>
  <StatusCode>Approved</StatusCode>
  <ExecutionType>Manual</ExecutionType>
  <TestType>Regression</TestType>
  <Priority>2-Medium</Priority>
  <Description>Test input data for the application<br></Description>
  <TestDateCreated>2014-07-17T08:30:28</TestDateCreated>
  <TestDateUpdated>2014-07-20T10:53:07</TestDateUpdated>
  <TestCreateUserId>24661</TestCreateUserId>
  <TestUpdateUserId>24661</TestUpdateUserId>
  <AssigneeUserId>24661</AssigneeUserId>
  <OwnerUserId>24661</OwnerUserId>
  <OriginalId>0</OriginalId>
  <ImportId>0</ImportId>
  <ScriptSourceId>0</ScriptSourceId>
  <NbrFailStatus>2</NbrFailStatus>
  <NbrPassStatus>4</NbrPassStatus>
  <AvgRunTime>375</AvgRunTime>
  <AvgRunTimeFormated>00:06:15</AvgRunTimeFormated>
  <NbrTimesRun>6</NbrTimesRun>
  <LastRunByUserId>24661</LastRunByUserId>
  <LastRunTestSet>1</LastRunTestSet>
  <LastRunTestSetTitle>Regression Tests - Build 3.1.0</LastRunTestSetTitle>
  <LastRunDate>2014-07-20T10:53:07</LastRunDate>
  <LastRunStatus>Passed</LastRunStatus>
  <NbrSteps>10</NbrSteps>
  <NotesDescription>Test note content</NotesDescription>
  <NbrEscalations>2</NbrEscalations>
  <DateLastEscalated>2014-07-19T10:26:12</DateLastEscalated>
  <LastEscalationRuleId>1</LastEscalationRuleId>
  <LastEscalationRule>New Tests, not updated for 2 days</LastEscalationRule>
  <NbrFilesNotSecured>0</NbrFilesNotSecured>
  <NbrFiles>0</NbrFiles>
  <NbrNotes>1</NbrNotes>
  <NbrEvents>0</NbrEvents>
  <ScriptName/>
</TestSetItem>

See Also

TestSetItems_Add Operation
TestSetItems_Load Operation
Test Set Items Operations

Highlight search results