ActionScript® 3.0 Reference for the Adobe® Flash® Platform
Home  |  Show Packages and Classes List |  Packages  |  Classes  |  What's New  |  Index  |  Appendixes
com.adobe.solutions.prm.domain.impl 

WorkItem  - AS3 Project Management

Packagecom.adobe.solutions.prm.domain.impl
Classpublic class WorkItem
InheritanceWorkItem Inheritance Object
Implements IWorkItem, IEventDispatcher

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10.0
Runtime Versions: Flash Player 10.2, AIR (unsupported)

This class defines a workitem domain entity. It exposes the properties of workitem value object and domain specific operations.

Related API Elements



Public Properties
 PropertyDefined By
  allMemberList : IList
[read-only] The property returns a collection of all members.
WorkItem
  asset : IAsset
Defines the asset of WorkItem.
WorkItem
  attributes : Object
Defines the map of key value pair attributes.
WorkItem
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
  context : IReviewContext
[read-only] This property returns a reference to the workflow template that will be used by the work item.
WorkItem
  createdBy : String
Principal name for a user who created an entity.
WorkItem
  creationDate : Date
Date of creation of an entity.
WorkItem
  description : String
Description.
WorkItem
  documents : ArrayCollection
[read-only] The property returns a collection of associated documents.
WorkItem
  editedTemplate : Boolean
Defines the current value of editedTemplate flag.
WorkItem
  endDate : Date
Defines the end date of a workItem.
WorkItem
  expectedEndDate : Date
Defines the expected end date for a workItem.
WorkItem
  ganttItems : ArrayCollection
[read-only] A collection of the displayable children that are displayed in the Gantt chart if showChildren flag is set to True.
WorkItem
  id : String
Unique identifier.
WorkItem
  inheritDocsFromParent : Boolean
Defines the current value of inheritDocsFromParent flag.
WorkItem
  instanceId : String
Defines the instance ID of the workflow associated with a workItem.
WorkItem
  itemEndDate : Date
[read-only] End date of the item.
WorkItem
  itemName : String
[read-only] Name of the item.
WorkItem
  itemStartDate : Date
[read-only] Start date of the item.
WorkItem
  itemState : String
[read-only] State of the item.
WorkItem
  itemStatus : String
[read-only] Status of the item.
WorkItem
  itemType : String
[read-only] Type of item.
WorkItem
  lastUpdatedBy : String
Principal name for a user who last updated an entity.
WorkItem
  lastUpdatedDate : Date
Date when an entity was last updated.
WorkItem
  memberList : IList
[read-only] The property returns a collection of directly associated members.
WorkItem
  members : IList
Defines a list of members of the project.
WorkItem
  name : String
Defines the name of the workItem, workItem name is a mandatory attribute should not be null.
WorkItem
  operationList : ArrayCollection
[read-only] A collection of operations that are available to a user through the context menu in the Gantt chart.
WorkItem
  owner : IUser
Defines the owner of a workItem.
WorkItem
  parentProject : IProject
Defines the immediate parent of a workItem in the project hierarchy.
WorkItem
  referenceDocuments : IList
Defines the reference documents associated with a workItem.
WorkItem
  reviewContextList : IList
[read-only] Defines the list of reviewContext List, If the workitem is has a running instance of review associated with it, then it gives list of review context each corresponding to a different revision of review.
WorkItem
  reviewTemplate : com.adobe.solutions.rca.domain:IReviewTemplate
Defines the reivewTemplate.
WorkItem
  rootProject : IProject
Defines the root project.
WorkItem
  showChildren : Boolean
A Boolean flag to determine if the children need to be displayed.
WorkItem
  showParent : Boolean
A Boolean flag to determine if the parent needs to be displayed.
WorkItem
  startDate : Date
Defines start date of a workItem.
WorkItem
  state : String
Defines the state of a WorkItem.
WorkItem
  status : String
Defines the status of a WorkItem.
WorkItem
  statusReasonCode : String
Defines the status reason code.
WorkItem
  tags : IList
Defines the list of tags that can be associated with an entity.
WorkItem
  templateName : String
Defines the workItem template name.
WorkItem
  type : String
Defines the type of workItem.
WorkItem
  uniqueMemberList : IList
[read-only] The property returns a collection of unique members.
WorkItem
  vo : WorkItemVO
This property refers to an instance of a workItem value object.
WorkItem
  workflowDisposition : String
Stores additional status information about the status of workflow associated with a workItem.
WorkItem
Public Methods
 MethodDefined By
  
WorkItem(value:WorkItemVO, parentProject:IProject, rootProject:IProject)
The constructor of WorkItem class.
WorkItem
  
This remote operation activates the current workitem.
WorkItem
  
This remote operation adds a document from the collection and submits the change on the server.
WorkItem
  
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, weakRef:Boolean = false):void
Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event.
WorkItem
  
This remote operation adds a member to the collection and submits the change to the server.
WorkItem
  
This method adds a reference document to the referenceDocuments collection.
WorkItem
  
This method adds a team member to the collection of the members.
WorkItem
  
Dispatches an event into the event flow.
WorkItem
  
This method returns the title of the member, if any title is assigned to the user.
WorkItem
  
A Boolean function to determine if the item has displayable children.
WorkItem
  
Checks whether the EventDispatcher object has any listeners registered for a specific type of event.
WorkItem
 Inherited
Indicates whether an object has a specified property defined.
Object
 Inherited
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
 Inherited
Indicates whether the specified property exists and is enumerable.
Object
  
This remote operation removes itself from its parent project and updates the change on a server.
WorkItem
  
This remote operation removes a document from the collection and submits the change on the server.
WorkItem
  
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Removes a listener from the EventDispatcher object.
WorkItem
  
This remote operation removes a member from the collection and submits the change to the server.
WorkItem
  
This method removes a team member, at the specified index, from the collections of the members.
WorkItem
  
This method removes a reference document, at the specified index, from the referenceDocuments collection.
WorkItem
  
This remote operation restarts the workflow attached to a workitem.
WorkItem
  
This remote operation saves the current state of a workitem on a server.
WorkItem
 Inherited
Sets the availability of a dynamic property for loop operations.
Object
  
This remote operation terminates the current workitem.
WorkItem
 Inherited
Returns the string representation of this object, formatted according to locale-specific conventions.
Object
 Inherited
Returns the string representation of the specified object.
Object
  
This remote operation updates the tile of a member present in collection and submits the change to the server.
WorkItem
 Inherited
Returns the primitive value of the specified object.
Object
  
Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type.
WorkItem
Property Detail

allMemberList

property
allMemberList:IList  [read-only]

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

The property returns a collection of all members. It takes into consideration any child objects that may be of type IMemberCollection.

This property can be used as the source for data binding. When this property is modified, it dispatches the memberListChanged event.



Implementation
    public function get allMemberList():IList

asset

property 
asset:IAsset

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Defines the asset of WorkItem.



Implementation
    public function get asset():IAsset
    public function set asset(value:IAsset):void

attributes

property 
attributes:Object

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Defines the map of key value pair attributes.



Implementation
    public function get attributes():Object
    public function set attributes(value:Object):void

context

property 
context:IReviewContext  [read-only]

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

This property returns a reference to the workflow template that will be used by the work item. A local template is returned if attached, else parent template is returned.



Implementation
    public function get context():IReviewContext

createdBy

property 
createdBy:String

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Principal name for a user who created an entity.



Implementation
    public function get createdBy():String
    public function set createdBy(value:String):void

creationDate

property 
creationDate:Date

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Date of creation of an entity.



Implementation
    public function get creationDate():Date
    public function set creationDate(value:Date):void

description

property 
description:String

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Description.



Implementation
    public function get description():String
    public function set description(value:String):void

documents

property 
documents:ArrayCollection  [read-only]

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

The property returns a collection of associated documents.

This property can be used as the source for data binding. When this property is modified, it dispatches the propertyChange event.



Implementation
    public function get documents():ArrayCollection

editedTemplate

property 
editedTemplate:Boolean

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Defines the current value of editedTemplate flag. If this Boolean flag is set to True, a template has been locally modified for this work item.



Implementation
    public function get editedTemplate():Boolean
    public function set editedTemplate(value:Boolean):void

endDate

property 
endDate:Date

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Defines the end date of a workItem. As the end date is a calculated field, client should never call the setter.



Implementation
    public function get endDate():Date
    public function set endDate(value:Date):void

expectedEndDate

property 
expectedEndDate:Date

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Defines the expected end date for a workItem. If expectedEndDate is null, then it is inherited from the parent project. For this reason, a root project can not have a null value for the expected end date.



Implementation
    public function get expectedEndDate():Date
    public function set expectedEndDate(value:Date):void

ganttItems

property 
ganttItems:ArrayCollection  [read-only]

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

A collection of the displayable children that are displayed in the Gantt chart if showChildren flag is set to True.

This property can be used as the source for data binding. When this property is modified, it dispatches the ganttItemsChanged event.



Implementation
    public function get ganttItems():ArrayCollection

id

property 
id:String

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Unique identifier.



Implementation
    public function get id():String
    public function set id(value:String):void

inheritDocsFromParent

property 
inheritDocsFromParent:Boolean

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Defines the current value of inheritDocsFromParent flag. If this Boolean flag is set to True, the workItem inherits the reference documents from parent project and so on. If the flag is set to False, then it does not inherit reference documents.



Implementation
    public function get inheritDocsFromParent():Boolean
    public function set inheritDocsFromParent(value:Boolean):void

instanceId

property 
instanceId:String

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Defines the instance ID of the workflow associated with a workItem. Instance ID uniquely identifies an ongoing workflow instance.



Implementation
    public function get instanceId():String
    public function set instanceId(value:String):void

itemEndDate

property 
itemEndDate:Date  [read-only]

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

End date of the item.

This property can be used as the source for data binding. When this property is modified, it dispatches the ganttDataItemDurationChanged event.



Implementation
    public function get itemEndDate():Date

itemName

property 
itemName:String  [read-only]

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Name of the item.

This property can be used as the source for data binding. When this property is modified, it dispatches the ganttDataItemNameChanged event.



Implementation
    public function get itemName():String

itemStartDate

property 
itemStartDate:Date  [read-only]

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Start date of the item.

This property can be used as the source for data binding. When this property is modified, it dispatches the ganttDataItemDurationChanged event.



Implementation
    public function get itemStartDate():Date

itemState

property 
itemState:String  [read-only]

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

State of the item.

This property can be used as the source for data binding. When this property is modified, it dispatches the ganttDataItemStateChanged event.



Implementation
    public function get itemState():String

itemStatus

property 
itemStatus:String  [read-only]

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Status of the item.

This property can be used as the source for data binding. When this property is modified, it dispatches the ganttDataItemStatusChanged event.



Implementation
    public function get itemStatus():String

itemType

property 
itemType:String  [read-only]

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Type of item.



Implementation
    public function get itemType():String

lastUpdatedBy

property 
lastUpdatedBy:String

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Principal name for a user who last updated an entity.



Implementation
    public function get lastUpdatedBy():String
    public function set lastUpdatedBy(value:String):void

lastUpdatedDate

property 
lastUpdatedDate:Date

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Date when an entity was last updated.



Implementation
    public function get lastUpdatedDate():Date
    public function set lastUpdatedDate(value:Date):void

memberList

property 
memberList:IList  [read-only]

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

The property returns a collection of directly associated members.

This property can be used as the source for data binding. When this property is modified, it dispatches the memberListChanged event.



Implementation
    public function get memberList():IList

members

property 
members:IList

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Defines a list of members of the project. Replaces any existing list of members. Team members get a notification of various events during a workItem life cycle.

This property can be used as the source for data binding. When this property is modified, it dispatches the templateChanged event.



Implementation
    public function get members():IList
    public function set members(value:IList):void

name

property 
name:String

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Defines the name of the workItem, workItem name is a mandatory attribute should not be null. [ ] / | * . .. : and trailing spaces are not allowed in the name.



Implementation
    public function get name():String
    public function set name(value:String):void

operationList

property 
operationList:ArrayCollection  [read-only]

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

A collection of operations that are available to a user through the context menu in the Gantt chart.



Implementation
    public function get operationList():ArrayCollection

owner

property 
owner:IUser

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Defines the owner of a workItem. Owner information is based on the Principal Name of the user present in WorkItemVO.

This property can be used as the source for data binding. When this property is modified, it dispatches the ownerUpdated event.



Implementation
    public function get owner():IUser
    public function set owner(value:IUser):void

parentProject

property 
parentProject:IProject

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Defines the immediate parent of a workItem in the project hierarchy. Since a project can have only one immediate parent, only a single instance of project is returned. Please note that for the first level children in a project hierarchy, parent project or root project have the same value. Parent project value is null for a root project itself.



Implementation
    public function get parentProject():IProject
    public function set parentProject(value:IProject):void

referenceDocuments

property 
referenceDocuments:IList

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Defines the reference documents associated with a workItem.



Implementation
    public function get referenceDocuments():IList
    public function set referenceDocuments(value:IList):void

reviewContextList

property 
reviewContextList:IList  [read-only]

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Defines the list of reviewContext List, If the workitem is has a running instance of review associated with it, then it gives list of review context each corresponding to a different revision of review.



Implementation
    public function get reviewContextList():IList

Related API Elements

reviewTemplate

property 
reviewTemplate:com.adobe.solutions.rca.domain:IReviewTemplate

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Defines the reivewTemplate. It keeps the edited value or the populated value of a review template, based on templateName.



Implementation
    public function get reviewTemplate():com.adobe.solutions.rca.domain:IReviewTemplate
    public function set reviewTemplate(value:com.adobe.solutions.rca.domain:IReviewTemplate):void

Related API Elements

rootProject

property 
rootProject:IProject

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Defines the root project. This method is used internally and should not be used by a client.



Implementation
    public function get rootProject():IProject
    public function set rootProject(value:IProject):void

showChildren

property 
showChildren:Boolean

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

A Boolean flag to determine if the children need to be displayed.



Implementation
    public function get showChildren():Boolean
    public function set showChildren(value:Boolean):void

showParent

property 
showParent:Boolean

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

A Boolean flag to determine if the parent needs to be displayed.



Implementation
    public function get showParent():Boolean
    public function set showParent(value:Boolean):void

startDate

property 
startDate:Date

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Defines start date of a workItem. If start date is set in future, then workItem is scheduled to start on the future date. If start date is in past or current date, then such a workItem starts, as soon as the workItem is activated. If the start date of a workItem is null, then the start date is inherited from the parent project.



Implementation
    public function get startDate():Date
    public function set startDate(value:Date):void

state

property 
state:String

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Defines the state of a WorkItem.



Implementation
    public function get state():String
    public function set state(value:String):void

status

property 
status:String

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Defines the status of a WorkItem.



Implementation
    public function get status():String
    public function set status(value:String):void

statusReasonCode

property 
statusReasonCode:String

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Defines the status reason code. Reason codes provide more information about the status and provide reason for specific status being set. In the default implementation, it has only two status, red and green



Implementation
    public function get statusReasonCode():String
    public function set statusReasonCode(value:String):void

Related API Elements

tags

property 
tags:IList

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Defines the list of tags that can be associated with an entity.



Implementation
    public function get tags():IList
    public function set tags(value:IList):void

templateName

property 
templateName:String

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Defines the workItem template name. Every workItem is associated with a RCA template. If a template is not directly assigned to a workItem, then a template is inherited from a parent project in the hierarchy, going from bottom to top. You need to specify only the template name, since it is unique. Ensure that the template exists before it is used.



Implementation
    public function get templateName():String
    public function set templateName(value:String):void

type

property 
type:String

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Defines the type of workItem. This attribute is not used in the current implementation, but the provided value is stored and associated with the workItem. A custom implementation can use the type, if required.



Implementation
    public function get type():String
    public function set type(value:String):void

uniqueMemberList

property 
uniqueMemberList:IList  [read-only]

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

The property returns a collection of unique members.

This property can be used as the source for data binding. When this property is modified, it dispatches the memberListChanged event.



Implementation
    public function get uniqueMemberList():IList

vo

property 
vo:WorkItemVO

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

This property refers to an instance of a workItem value object.



Implementation
    public function get vo():WorkItemVO
    public function set vo(value:WorkItemVO):void

Related API Elements

workflowDisposition

property 
workflowDisposition:String

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

Stores additional status information about the status of workflow associated with a workItem. It is not used in the current implementation. It is reserved for future use.



Implementation
    public function get workflowDisposition():String
    public function set workflowDisposition(value:String):void
Constructor Detail

WorkItem

()Constructor
public function WorkItem(value:WorkItemVO, parentProject:IProject, rootProject:IProject)

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10.0
Runtime Versions: Flash Player 10.2, AIR (unsupported)

The constructor of WorkItem class. It creates a workitem using workitem value object and reference to parent project and root project.

Parameters
value:WorkItemVO — workitem value object
 
parentProject:IProject — Reference of parent project to which this work item is assigned.
 
rootProject:IProject — Reference of top level project i.e root node of the tree in which this work item is assigned.
Method Detail

activate

()method
public function activate():mx.rpc:AsyncToken

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

This remote operation activates the current workitem.

Returns
mx.rpc:AsyncToken — It returns a token on which success fault handlers can be attached. The resulting event contains the value object of the activated workitem.

addDocumentAndSave

()method 
public function addDocumentAndSave(doc:ISupportingDocument):mx.rpc:AsyncToken

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

This remote operation adds a document from the collection and submits the change on the server.

Parameters

doc:ISupportingDocument — The document to be added to document collection.

Returns
mx.rpc:AsyncToken — It returns a token on which success or fault handlers can be attached.

addEventListener

()method 
public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, weakRef:Boolean = false):void

Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event. You can register event listeners on all nodes in the display list for a specific type of event, phase, and priority.

After you successfully register an event listener, you cannot change its priority through additional calls to addEventListener(). To change a listener's priority, you must first call removeEventListener(). Then you can register the listener again with the new priority level.

After the listener is registered, subsequent calls to addEventListener() with a different value for either type or useCapture result in the creation of a separate listener registration. For example, if you first register a listener with useCapture set to true, it listens only during the capture phase. If you call addEventListener() again using the same listener object, but with useCapture set to false, you have two separate listeners: one that listens during the capture phase, and another that listens during the target and bubbling phases.

You cannot register an event listener for only the target phase or the bubbling phase. Those phases are coupled during registration because bubbling applies only to the ancestors of the target node.

When you no longer need an event listener, remove it by calling EventDispatcher.removeEventListener(); otherwise, memory problems might result. Objects with registered event listeners are not automatically removed from memory because the garbage collector does not remove objects that still have references.

Copying an EventDispatcher instance does not copy the event listeners attached to it. (If your newly created node needs an event listener, you must attach the listener after creating the node.) However, if you move an EventDispatcher instance, the event listeners attached to it move along with it.

If the event listener is being registered on a node while an event is also being processed on this node, the event listener is not triggered during the current phase but may be triggered during a later phase in the event flow, such as the bubbling phase.

If an event listener is removed from a node while an event is being processed on the node, it is still triggered by the current actions. After it is removed, the event listener is never invoked again (unless it is registered again for future processing).

Parameters

type:String — The type of event.
 
listener:Function — The listener function that processes the event. This function must accept an event object as its only parameter and must return nothing, as this example shows:

function(evt:Event):void

The function can have any name.
 
useCapture:Boolean (default = false) — Determines whether the listener works in the capture phase or the target and bubbling phases. If useCapture is set to true, the listener processes the event only during the capture phase and not in the target or bubbling phase. If useCapture is false, the listener processes the event only during the target or bubbling phase. To listen for the event in all three phases, call addEventListener() twice, once with useCapture set to true, then again with useCapture set to false.
 
priority:int (default = 0) — The priority level of the event listener. Priorities are designated by a 32-bit integer. The higher the number, the higher the priority. All listeners with priority n are processed before listeners of priority n-1. If two or more listeners share the same priority, they are processed in the order in which they were added. The default priority is 0.
 
weakRef:Boolean (default = false) — Determines whether the reference to the listener is strong or weak. A strong reference (the default) prevents your listener from being garbage-collected. A weak reference does not.

Class-level member functions are not subject to garbage collection, so you can set useWeakReference to true for class-level member functions without subjecting them to garbage collection. If you set useWeakReference to true for a listener that is a nested inner function, the function will be garbge-collected and no longer persistent. If you create references to the inner function (save it in another variable) then it is not garbage-collected and stays persistent.

addMemberAndSave

()method 
public function addMemberAndSave(member:IMember):mx.rpc:AsyncToken

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

This remote operation adds a member to the collection and submits the change to the server.

Parameters

member:IMember — The member to be added to member collection.

Returns
mx.rpc:AsyncToken — It returns a token on which success or fault handlers can be attached.

addReferenceDocument

()method 
public function addReferenceDocument(doc:ISupportingDocument):void

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

This method adds a reference document to the referenceDocuments collection. It adds the document locally and not on a server.

Parameters

doc:ISupportingDocument — A reference document to be added.

addTeamMember

()method 
public function addTeamMember(teamMember:com.adobe.solutions.prm.domain:ITeamMember):void

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

This method adds a team member to the collection of the members. It adds the team member locally and not on a server.

Parameters

teamMember:com.adobe.solutions.prm.domain:ITeamMember — Team Member to be added.

dispatchEvent

()method 
public function dispatchEvent(event:Event):Boolean

Dispatches an event into the event flow. The event target is the EventDispatcher object upon which dispatchEvent() is called.

Parameters

event:Event — The event object dispatched into the event flow.

Returns
Boolean — A value of true unless preventDefault() is called on the event, in which case it returns false.

getMemberTitle

()method 
public function getMemberTitle(member:IMember):String

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

This method returns the title of the member, if any title is assigned to the user.

Parameters

member:IMember — Member instance whose title is required.

Returns
String — It returns the title of the member.

hasChildren

()method 
public function hasChildren():Boolean

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

A Boolean function to determine if the item has displayable children.

Returns
Boolean — It returns a True value if there are displayable children.

hasEventListener

()method 
public function hasEventListener(type:String):Boolean

Checks whether the EventDispatcher object has any listeners registered for a specific type of event. This allows you to determine where an EventDispatcher object has altered handling of an event type in the event flow hierarchy. To determine whether a specific event type will actually trigger an event listener, use IEventDispatcher.willTrigger().

The difference between hasEventListener() and willTrigger() is that hasEventListener() examines only the object to which it belongs, whereas willTrigger() examines the entire event flow for the event specified by the type parameter.

Parameters

type:String — The type of event.

Returns
Boolean — A value of true if a listener of the specified type is registered; false otherwise.

remove

()method 
public function remove():mx.rpc:AsyncToken

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

This remote operation removes itself from its parent project and updates the change on a server.

Returns
mx.rpc:AsyncToken — It returns a token on which success fault handlers can be attached. The resulting event contains the value object of the removed workitem.

removeDocumentAndSave

()method 
public function removeDocumentAndSave(doc:ISupportingDocument):mx.rpc:AsyncToken

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

This remote operation removes a document from the collection and submits the change on the server.

Parameters

doc:ISupportingDocument — The document to be removed from document collection.

Returns
mx.rpc:AsyncToken — It returns a token on which success or fault handlers can be attached.

removeEventListener

()method 
public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void

Removes a listener from the EventDispatcher object. If there is no matching listener registered with the EventDispatcher object, a call to this method has no effect.

Parameters

type:String — The type of event.
 
listener:Function — The listener object to remove.
 
useCapture:Boolean (default = false) — Specifies whether the listener was registered for the capture phase or the target and bubbling phases. If the listener was registered for both the capture phase and the target and bubbling phases, two calls to removeEventListener() are required to remove both: one call with useCapture set to true, and another call with useCapture set to false.

removeMemberAndSave

()method 
public function removeMemberAndSave(member:IMember):mx.rpc:AsyncToken

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

This remote operation removes a member from the collection and submits the change to the server.

Parameters

member:IMember — The member to be removed from member collection.

Returns
mx.rpc:AsyncToken — It returns a token on which success or fault handlers can be attached.

removeMemberAt

()method 
public function removeMemberAt(index:int):com.adobe.solutions.prm.domain:ITeamMember

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

This method removes a team member, at the specified index, from the collections of the members. It removes a team member locally and not on a server.

Parameters

index:int — Index of the member to be removed.

Returns
com.adobe.solutions.prm.domain:ITeamMember — It returns a reference to the removed member.

removeReferenceDocumentAt

()method 
public function removeReferenceDocumentAt(index:int):ISupportingDocument

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

This method removes a reference document, at the specified index, from the referenceDocuments collection. It removes the document locally and not on a server.

Parameters

index:int — Index of the document to be removed.

Returns
ISupportingDocument — It returns a reference to the removed document.

restartSchedule

()method 
public function restartSchedule(file:File, stageNumber:int):mx.rpc:AsyncToken

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

This remote operation restarts the workflow attached to a workitem. While restarting a new file can be provided, to be used in the restarted workflow. User has the option of restarting a schedule from a specific stage.

Parameters

file:File — New asset to be used in the restarted workflow.
 
stageNumber:int — Stage number from which the schedule should restarted.

Returns
mx.rpc:AsyncToken — It returns a token on which success or fault handlers can be attached.

save

()method 
public function save():mx.rpc:AsyncToken

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

This remote operation saves the current state of a workitem on a server. If save is successful, it refreshes the current object with the new value object returned from the server.

Returns
mx.rpc:AsyncToken — It returns a token on which success or fault handlers can be attached. The resulting event contains the value object of the saved workitem.

terminate

()method 
public function terminate():mx.rpc:AsyncToken

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

This remote operation terminates the current workitem. If the operation is successful, it refreshes current object with the new value object returned from a server.

Returns
mx.rpc:AsyncToken — It returns a token on which success or fault handlers can be attached. The resulting event contains the value object of the terminated workitem.

updateTitleAndSave

()method 
public function updateTitleAndSave(member:IMember, title:String):mx.rpc:AsyncToken

Language Version: ActionScript 3.0
Product Version: Project Management Building Block 10
Runtime Versions: Flash Player 10.2, AIR (unsupported)

This remote operation updates the tile of a member present in collection and submits the change to the server.

Parameters

member:IMember — The member to be removed from member collection.
 
title:String — The title of the member.

Returns
mx.rpc:AsyncToken — It returns a token on which success or fault handlers can be attached.

willTrigger

()method 
public function willTrigger(type:String):Boolean

Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type. This method returns true if an event listener is triggered during any phase of the event flow when an event of the specified type is dispatched to this EventDispatcher object or any of its descendants.

The difference between hasEventListener() and willTrigger() is that hasEventListener() examines only the object to which it belongs, whereas willTrigger() examines the entire event flow for the event specified by the type parameter.

Parameters

type:String — The type of event.

Returns
Boolean — A value of true if a listener of the specified type will be triggered; false otherwise.