Release object

A Release object represents a release.

You get a Release reference from the ReleaseFactory object or from the Parent property of a Cycle object (Cycle.Parent).

Public methods

This object supports the following methods.

Method Description
LockObject

Locks the object. Returns True if the object has been changed on the server.

For details, see LockObject.

NewList

Gets a list of the node's immediate children.

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.

Syntax: UnLockObject()

Public properties

This object supports the following properties.

Property R/W Type Description

Attachments

R Object

The AttachmentFactory object for the release. See AttachmentFactory object.

Syntax: Release.Attachments

AutoPost

R/W Boolean

If true, the database is updated immediately when the field value changes.

Syntax: Release.AutoPost

AutoUnlock

R/W Boolean

Indicates whether to make the item changeable to other users automatically after a Refresh or Post.

Syntax: Release.AutoUnlock

CycleFactory R Object The CycleFactory object for cycles of this release. See CycleFactory object.
EndDate R/W Date

The release's end date.

Syntax: Release.EndDate

Field

R/W Any

The value of the specified field.

Syntax: Release.Field[fieldName]

Parameter:

  • 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: Release.FieldMultiValue[fieldName]

Parameter:

  • fieldName. A string that represents the name of the field in the project database. Use all upper case.

HasAttachment

R Boolean

Checks whether the release has one or more attachments.

Syntax: Release.HasAttachment

HasMilestones R Boolean

Checks whether the release has at least one milestone.

Syntax: Release.HasMilestones

ID

R Number

The item ID.

Syntax: Release.ID

IsLocked

R Boolean

Checks if defect is locked for editing.

Syntax: Release.IsLocked

IsLocked is set by the LockObject method and is reset by the UnlockObject method.

If the object has an AutoUnlock property and the property is set to True, IsLocked is also reset by a Post or Refresh operation.

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.

Syntax: Release.Modified

Name R/W String

The release's name.

Syntax: Release.Name

Parent R Object

The release's parent release folder.

Syntax: Release.Parent

StartDate R/W Date

The release's start date.

Syntax: Release.StartDate

TypeName

R String

The field's type.

Syntax: Release.TypeName

Virtual

R Boolean

Checks if this is a virtual item, that is, an item that does not have a corresponding database record.

Syntax: Release.Virtual

Back to top