A TestSet object represents a test set in QAComplete. Using the QAComplete SOAP API, you can add, load, modify, and delete test sets.
To manage test sets in QAComplete, you need a user account that belongs to a security group that has the following privileges:
-
Read, Add, Update, and Delete for Test Management > Test Sets.
You can view and set privileges in > Setup > Security > Security Group > Manage Security Rights.
Properties
Custom1 … Custom10 : string (max 8000 chars)
Values of custom fields 1 to 10.
Custom11 … Custom90 : string (max 100 chars)
Values of custom fields 11 to 90.
CustomFieldName1 … CustomFieldName90 : string (max 30 chars)
The names of custom fields.
CustomFields : array of strings
An array of custom field values.
CustomFieldNames : array of strings
An array of custom field names.
TestSetId : integer
The unique ID of the test set.
ProjId : integer
The ID of the project in QAComplete to which the test set belongs.
FolderId : integer
The ID of the folder to which the test set belongs. 0 if the test set does not belong to any folder.
CreateUserId : integer
The ID of the user who created the test set.
UpdateUserId : integer
The ID of the last user who updated the test set.
OriginalId : integer
The original ID of the test set as it was specified in an external file before the test set was imported to QAComplete. If the test set was not imported, 0.
ImportId : integer
The ID of the operation that imported the test set from an external file. If the test set was not imported, 0.
OwnerUserId : integer
The ID of the user who owns the test set.
AssigneeUserId : integer
The ID of the user to whom the test set is assigned. 0 if the test set is not assigned to anyone.
Title : string (max 255 chars)
The title of the test set.
IsActive : string (max 1 chars)
Specifies whether the test set is enabled (active).
IsSequential : string
Specifies whether tests in the test set run strictly in the order they are listed in the set.
StatusCode : string (max 100 chars)
The status of the test set. Possible values are based on the choice list.
PriorityCode : string
The priority of the test set. Possible values are based on the choice list. If no priority is specified for the test set, empty string.
ExecutionType : string (max 100 chars)
Specifies how the test set will run. Possible values are based on the choice list. If no execution type is assigned, empty string.
Description : string (max 8000 chars)
The test set description. Can include an HTML markup. If no description is specified, empty string.
DateCreated : dateTime
The date and time when the test set was created.
DateUpdated : dateTime
The date and time when the test set was last updated.
EstStart : dateTime
Reserved.
EstFinish : dateTime
Reserved.
ActStart : dateTime
Reserved.
ActFinish : dateTime
Reserved.
FolderName : string (max 511 chars)
The name of the folder to which the test set belongs.
AssignedToName : string (max 78 chars)
The name of the user, to whom the test set is assigned, in the Last name, First name format.
UserName : string (max 78 chars)
The name of the last user, who updated the test set, in the Last name, First name format.
OwnerName : string (max 78 chars)
The name of the user, who owns the test set, in the Last name, First name format.
NbrTests : integer
The number of tests the test set has.
LastRunStatus : string (max 100 chars)
Specifies the status of the last test set run.
LastRunDate : dateTime
The date when the test set ran last.
LastRunByUserId : integer
The ID of the last user, who ran the test set.
LastRunByUserName : string
The name of the last user, who ran the test set, in the Last name, First name format.
NbrTimesRun : integer
The number of times the test set ran.
AvgRunTime : integer
The test set’s average run time, in seconds.
AvgRunTimeFormated : string (max 100 chars)
The test set’s average run time, in the hh:mm:ss format.
NotesDescription : string (max 255 chars)
The latest note attached to the test set. Can include HTML markup.
NbrEscalations : integer
The number of times the test set was processed by escalation rules.
DateLastEscalated : dateTime
The date when the test set was last processed by an escalation rule.
LastEscalationRuleId : integer
The ID of the escalation rule that processed the test set last. 0 if no escalation rule processed the test set.
LastEscalationRule : string (max 100 chars)
The name of the last escalation rule that processed the test set.
NbrFilesNotSecured : integer
Reserved.
NbrFiles : integer
The number of files attached to the test set.
NbrNotes : integer
The number of notes attached to the test set.
NbrEvents : integer
Reserved.
PctComplete : integer
Reserved.
EstHrs : decimal
Reserved.
ActHrs : decimal
Reserved.
EstHrsRemaining : decimal
Reserved.
ActFinish : dateTime
Reserved.
ActHrs : decimal
Reserved.
ActStart : dateTime
Reserved.
AssignedToName : string (max 78 chars)
The name of the user, to whom the test set is assigned, in the Last name, First name format.
AssigneeUserId : integer
The ID of the user to whom the test set is assigned. 0 if the test set is not assigned to anyone.
AvgRunTime : integer
The test set’s average run time, in seconds.
AvgRunTimeFormated : string (max 100 chars)
The test set’s average run time, in the hh:mm:ss format.
CreateUserId : integer
The ID of the user who created the test set.
Custom1 … Custom10 : string (max 8000 chars)
Values of custom fields 1 to 10.
Custom11 … Custom90 : string (max 100 chars)
Values of custom fields 11 to 90.
CustomFieldName1 … CustomFieldName90 : string (max 30 chars)
The names of custom fields.
CustomFieldNames : array of strings
An array of custom field names.
CustomFields : array of strings
An array of custom field values.
DateCreated : dateTime
The date and time when the test set was created.
DateLastEscalated : dateTime
The date when the test set was last processed by an escalation rule.
DateUpdated : dateTime
The date and time when the test set was last updated.
Description : string (max 8000 chars)
The test set description. Can include an HTML markup. If no description is specified, empty string.
EstFinish : dateTime
Reserved.
EstHrs : decimal
Reserved.
EstHrsRemaining : decimal
Reserved.
EstStart : dateTime
Reserved.
ExecutionType : string (max 100 chars)
Specifies how the test set will run. Possible values are based on the choice list. If no execution type is assigned, empty string.
FolderId : integer
The ID of the folder to which the test set belongs. 0 if the test set does not belong to any folder.
FolderName : string (max 511 chars)
The name of the folder to which the test set belongs.
ImportId : integer
The ID of the operation that imported the test set from an external file. If the test set was not imported, 0.
IsActive : string (max 1 chars)
Specifies whether the test set is enabled (active).
IsSequential : string
Specifies whether tests in the test set run strictly in the order they are listed in the set.
LastEscalationRule : string (max 100 chars)
The name of the last escalation rule that processed the test set.
LastEscalationRuleId : integer
The ID of the escalation rule that processed the test set last. 0 if no escalation rule processed the test set.
LastRunByUserId : integer
The ID of the last user, who ran the test set.
LastRunByUserName : string
The name of the last user, who ran the test set, in the Last name, First name format.
LastRunDate : dateTime
The date when the test set ran last.
LastRunStatus : string (max 100 chars)
Specifies the status of the last test set run.
NbrEscalations : integer
The number of times the test set was processed by escalation rules.
NbrEvents : integer
Reserved.
NbrFiles : integer
The number of files attached to the test set.
NbrFilesNotSecured : integer
Reserved.
NbrNotes : integer
The number of notes attached to the test set.
NbrTests : integer
The number of tests the test set has.
NbrTimesRun : integer
The number of times the test set ran.
NotesDescription : string (max 255 chars)
The latest note attached to the test set. Can include HTML markup.
OriginalId : integer
The original ID of the test set as it was specified in an external file before the test set was imported to QAComplete. If the test set was not imported, 0.
OwnerName : string (max 78 chars)
The name of the user, who owns the test set, in the Last name, First name format.
OwnerUserId : integer
The ID of the user who owns the test set.
PctComplete : integer
Reserved.
PriorityCode : string
The priority of the test set. Possible values are based on the choice list. If no priority is specified for the test set, empty string.
ProjId : integer
The ID of the project in QAComplete to which the test set belongs.
StatusCode : string (max 100 chars)
The status of the test set. Possible values are based on the choice list.
TestSetId : integer
The unique ID of the test set.
Title : string (max 255 chars)
The title of the test set.
UpdateUserId : integer
The ID of the last user who updated the test set.
UserName : string (max 78 chars)
The name of the last user, who updated the test set, in the Last name, First name format.
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 Sets > Actions > Manage Choice Lists.
-
Unassigned date/time values (for example, in
DateUpdated) are represented as0001-01-01T00:00:00.
Example
XML
<TestSet>
<TestSetId>1</TestSetId>
<ProjId>11873</ProjId>
<FolderId>12</FolderId>
<CreateUserId>24661</CreateUserId>
<UpdateUserId>24667</UpdateUserId>
<OriginalId>0</OriginalId>
<ImportId>0</ImportId>
<OwnerUserId>24661</OwnerUserId>
<AssigneeUserId>24661</AssigneeUserId>
<Title>Regression Tests - Release 3.1.0</Title>
<IsActive>Y</IsActive>
<IsSequential>N</IsSequential>
<StatusCode>Approved</StatusCode>
<PriorityCode>1-High</PriorityCode>
<ExecutionType>Manual</ExecutionType>
<DateCreated>2014-07-17T08:30:28</DateCreated>
<DateUpdated>2014-07-20T10:53:07</DateUpdated>
<EstStart>0001-01-01T00:00:00</EstStart>
<EstFinish>0001-01-01T00:00:00</EstFinish>
<ActStart>0001-01-01T00:00:00</ActStart>
<ActFinish>0001-01-01T00:00:00</ActFinish>
<FolderName>Regression Tests</FolderName>
<AssignedToName>Doe, John</AssignedToName>
<UserName>Doe, Jane</UserName>
<OwnerName>Doe, John</OwnerName>
<NbrTests>6</NbrTests>
<LastRunStatus>Passed</LastRunStatus>
<LastRunDate>2014-07-20T10:53:07</LastRunDate>
<LastRunByUserId>24661</LastRunByUserId>
<LastRunByUserName>Doe. John</LastRunByUserName>
<NbrTimesRun>3</NbrTimesRun>
<AvgRunTime>1323</AvgRunTime>
<AvgRunTimeFormated>00:22:03</AvgRunTimeFormated>
<NotesDescription>Test Set Note Content<br></NotesDescription>
<NbrEscalations>2</NbrEscalations>
<DateLastEscalated>2014-07-20T10:53:07</DateLastEscalated>
<LastEscalationRuleId>2</LastEscalationRuleId>
<LastEscalationRule>New test sets, not run for 2 days</LastEscalationRule>
<NbrFilesNotSecured>0</NbrFilesNotSecured>
<NbrFiles>0</NbrFiles>
<NbrNotes>1</NbrNotes>
<NbrEvents>0</NbrEvents>
<PctComplete>0</PctComplete>
<EstHrs>0.000</EstHrs>
<ActHrs>0.000</ActHrs>
<EstHrsRemaining>0.000</EstHrsRemaining>
</TestSet>
See Also
TestSets_Add Operation
TestSets_Load Operation
Test Set Operations