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.

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.

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.

Back to top