Test object

A Test object represents a test.

You get a Test object from a TestFactory object.

Public methods

This object supports the following methods.

Method	Description
CoverRequirement	Adds the specified requirement to the list of requirements covered by this test. Syntax: `CoverRequirement(req, recursive)` Parameters: req. A string that represents the requirement ID or a Req object. recursive. A Boolean that indicates whether to check coverage for all child requirements. If true, all child requirements are covered by this test. If false, only the specified requirement is covered by this test.
CoverRequirementEx	Adds the specified requirement to the list of requirements covered by this entity. Optionally, also adds child requirements. Syntax: `CoverRequirementEx(req, reqFilter, recursive)` Parameters: req. A string that represents the requirement ID or a Req object. reqFilter. A TDFilter.Text string that specifies which descendent requirements to include. recursive. A Boolean that indicates whether to check coverage for all child requirements. If true, all child requirements are covered by this test. If false, only the specified requirement is covered by this test.
GetCoverList	Gets the list of all requirements covered by this test. Syntax: `GetCoverList()` Return: A list of Req objects
LockObject	Locks the object. Returns True if the object has been changed on the server. For details, see LockObject.
Mail	Mails a list of items. For details, see Mail.
Post	Posts all changed values into database. For details, see Post.
Refresh	Reads saved values, overwriting values in memory. For details, see Refresh.
RemoveCoverage	Removes a requirement from the list of requirements this test covers.
Undo	Undoes changes to field values that have not been posted. For details, see Undo.
UnLockObject	Unlocks the object. For details, see UnLockObject.

Public properties

Property	R/W	Type	Description
Attachments	R	Object	The AttachmentFactory for the test. See AttachmentFactory object.
AutoPost	R/W	Boolean	If true, the database is updated immediately when the field value changes.
AutoUnlock	R/W	Boolean	Indicates whether to make the item changeable to other users automatically after a Refresh or Post.
BugLinkFactory	R	Object	The bug link factory that manages the links of the current test to its associated defects.
CoverageFactory	R	Object	The CoverageFactory for the entity. See CoverageFactory object.
DesignStepFactory	R/W	Object	The design steps factory for the current test. See DesignStepFactory object.
DesStepsNum	R	Number	The number of design steps in the test.
EntitySubtype	R	Object	The current subtype of the entity.
ExecStatus	R	String	The test execution status.
Field	R/W	Any	The value of the specified field. Syntax: `Test.Field[fieldName]` Parameters: fieldName. A string that represents the name of the field in the project database. Use all upper case.
FieldMultiValue	R/W	Object	The MultiValue object of the specified field. See MultiValue object. Syntax: `Test.FieldMultiValue[fieldName]` Parameters: fieldName. A string that represents the name of the field in the project database. Use all upper case.
FolderId	R	Number	The test folder ID.
HasAttachment	R	Boolean	Checks if the test has one or more attachments.
HasCoverage	R	Boolean	Checks if the test covers at least one requirement.
HasLinkage	R	Boolean	Checks if the test has at least one associated Bug.
HasParam	R	Boolean	Checks if the test has at least one parameter.
ID	R	Number	The item ID.
IsLocked	R	Boolean	Checks if the test is locked for editing.
Modified	R	Boolean	Checks if the item has been modified since last refresh or post operation. If true, the field properties on the server side are not up to date.
Name	R/W	String	The test name.
NumOfConfigurations	R	Number	Number of configurations the test has.
TemplateTest	R/W	Boolean	Indicates if the test is a template test.
TestConfigFactory	R	Object	The TestConfigFactory object for the test. See TestConfigFactory object.
TestParameterFactory	R	Object	The TestParameterFactory object that manages the parameters of the current object. See TestParameterFactory object.
Type	R/W	String	The test type.
TypeName	R	String	The field's type.
Virtual	R	Boolean	Checks if this is a virtual item, that is, an item that does not have a corresponding database record.