Run object

A Run object represents a test run.

You get a Run object reference from the RunFactory object.

Public methods

This object supports the following methods.

Method	Description
CancelRun	Cancels the run.
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.
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

This object supports the following 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 object to its associated defects.
EntitySubtype	R	Object	The current subtype of the entity.
Field	R/W	Any	The value of the specified field. Syntax: `Run.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: `Run.FieldMultiValue[fieldName]` Parameters: fieldName. A string that represents the name of the field in the project database. Use all upper case.
HasAttachment	R	Boolean	Checks if the run has one or more attachments.
HasLinkage	R	Boolean	Checks if the run has at least one associated Bug.
ID	R	Number	The run ID.
IsLocked	R	Boolean	Checks if the run 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 run name.
Status	R/W	String	The run status.
StepFactory	R	Object	The StepFactory object for the current run. See StepFactory object.
TestId	R	Number	The test ID of the test that has been run.
TestInstance	R	Number	The number of this instance of the design test in the test set. For example, if a test is used four times in a test set, Run.TestInstance is a number from 1 to 4, depending on which instance ran.
TestInstanceID	R	Number	The ID of the test instance for the current run.
TestSetID	R	Number	The ID of the test set to which the run belongs.
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.