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.
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.
AssigneeUserId : integer
The ID of the user, to whom the test that corresponds to the item is assigned.
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.
CreateUserId : integer
The ID of the user who added the item to the test set.
DateCreated : dateTime
The date and time when the item was added to the test set.
DateLastEscalated : dateTime
The date when the test that corresponds to the item was last processed by an escalation rule.
DateUpdated : dateTime
The date and time when the item was updated in the test set.
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.
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.
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.
FolderName : string (max 511 chars)
The name of the folder to which the test that corresponds to the item belongs.
ImportId : integer
The ID of the operation that imported the test that corresponds to the item. If the test was not imported, 0.
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.
LastEscalationRule : string (max 100 chars)
The name of the last escalation rule that has processed the test that corresponds to the item.
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.
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.
LastRunByUserId : integer
The ID of the last user who has run the test that corresponds to the item.
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.
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.
NbrEscalations : integer
The number of times the test that corresponds to the item was processed by escalation rules.
NbrEvents : integer
Reserved.
NbrFailStatus : integer
The number of times the test that corresponds to the item has failed.
NbrFiles : integer
The number of files attached to the test that corresponds to the item.
NbrFilesNotSecured : integer
Reserved.
NbrNotes : integer
The number of notes attached to the test that corresponds to the item.
NbrPassStatus : integer
The number of times the test that corresponds to the item has passed.
NbrSteps : integer
The number of steps that the test that corresponds to the item has.
NbrTimesRun : integer
The number of times the test that corresponds to the item has run.
NotesDescription : string (max 255 chars)
The latest note attached to the test that corresponds to the item. Can include HTML markup.
OriginalId : integer
The original ID if the test that corresponds to the item. If the test was not imported, 0.
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.
OwnerUserId : integer
The ID of the user who owns the test that corresponds to the item.
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.
ProjId : integer
The ID of the project in QAComplete to which the item belongs.
ScriptName : string (max 510 chars)
Reserved.
ScriptSourceId : integer
Reserved.
Seq : integer
The ordinal number of the item in the test set.
StatusCode : string (max 100 chars)
The status of the test that corresponds to the item. Possible values are based on the choice list.
TestCreateUserId : integer
The ID of the user who created the test that corresponds to the item.
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.
TestId : integer
The ID of the test that corresponds to the item.
TestIsActive : string (max 1 char)
Specifies whether the test to which the item corresponds is active (enabled).
TestSetId : integer
The ID of the test set to which the item belongs.
TestSetItemId : integer
The unique ID of the item among all items in all test sets in the project.
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.
TestUpdateUserId : integer
The ID of the last user who updated the test that corresponds to the item.
Title : string (max 100 chars)
The title of the test to which the item corresponds.
UpdateUserId : integer
The ID of the last user who updates the item in the test set.
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.
Version : integer
The version of the test to which the item corresponds.
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 as0001-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