ActionScript® 3.0 Reference for the Adobe® Flash® Platform
Home  |  Show Packages and Classes List |  Packages  |  Classes  |  What's New  |  Index  |  Appendixes
com.adobe.icc.editors.model 

FragmentLayoutModel  - AS3 Asset Composer

Packagecom.adobe.icc.editors.model
Classpublic class FragmentLayoutModel
InheritanceFragmentLayoutModel Inheritance AssetModel Inheritance EventDispatcher Inheritance Object

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

The FragmentLayoutModel class represents the domain object for the assets of type FragmentLayout. Domain objects can be leveraged to build presentation on top of them. They ease the process of coding views by abstracting all the service calls and maintaining meaningful states.



Public Properties
 PropertyDefined By
 InheritedactiveEndDate : Date
The activeEndDate of the underlying value object.
AssetModel
 InheritedactiveStartDate : Date
The activeStartDate date of the underlying value object.
AssetModel
 Inheritedcategory : Category
The Category of the underlying value object.
AssetModel
 Inheritedcomment : String
The comment of the underlying value object.
AssetModel
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
 InheritedcrxVersion : String
The crx version of the underlying value object.
AssetModel
  cutsomizedLayout : Boolean
The tables of the underlying value object.
FragmentLayoutModel
 Inheriteddescription : String
The description of the underlying value object.
AssetModel
 InheritedextendedProperties : Object
The extended properties of the underlying value object.
AssetModel
  fields : IList
The fields of the underlying value object.
FragmentLayoutModel
  file : FileModel
The file domain object associated with this fragmentLayout.
FragmentLayoutModel
  flowedLayout : Boolean
whether underlying value object is a flowed layout or not
FragmentLayoutModel
 Inheritedid : String
The GUID of the underlying value object.
AssetModel
 InheritedisNew : Boolean
Indicates if this Asset is new.
AssetModel
 InheritedlastChangeBy : String
The lastChangeBy property of the underlying value object.
AssetModel
 Inheritedname : String
The name of the underlying value object.
AssetModel
  shallow : Boolean
Flag to indicate if the underlying value object is shallow.
FragmentLayoutModel
 Inheritedstate : int
The state of the underlying value object.
AssetModel
 InheritedsubCategory : Category
The Sub-Category of the underlying value object.
AssetModel
  tables : IList
The tables of the underlying value object.
FragmentLayoutModel
  targetAreas : IList
The target areas of the underlying value object.
FragmentLayoutModel
 Inheritedversion : int
The version of the underlying value object.
AssetModel
 Inheritedvo : *
The value object which this asset domain object is built atop.
AssetModel
Protected Properties
 PropertyDefined By
 InheritedisCopy : Boolean
Indicates that the object is a copy of an existing Asset.
AssetModel
 InheritedoldId : String
Id of the Asset which was cloned to create this copy.
AssetModel
 InheritedpreferencesManager : PreferencesManager
To manage user preferences for category, subcategory and data dictionary.
AssetModel
Public Methods
 MethodDefined By
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event.
EventDispatcher
  
Creates a copy of the domain object.
FragmentLayoutModel
  
createFromVO(fragmentLayoutVO:FragmentLayout, fetchFromServer:Boolean = true):FragmentLayoutModel
[static] Creates the domain object from the corresponding value object.
FragmentLayoutModel
 Inherited
Dispatches an event into the event flow.
EventDispatcher
  
Fetches the complete value object via remoting call.
FragmentLayoutModel
  
Fetches the complete value object via remoting call.
FragmentLayoutModel
 Inherited
Checks whether the EventDispatcher object has any listeners registered for a specific type of event.
EventDispatcher
 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
  
Indicates if the underlying value object is shallow.
FragmentLayoutModel
 Inherited
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Removes a listener from the EventDispatcher object.
EventDispatcher
  
[override] Saves the underlying value object on the server.
FragmentLayoutModel
  
[static] This method lets you inject a custom implementation of the infrastructure fragmentLayout service.
FragmentLayoutModel
 Inherited
Sets the availability of a dynamic property for loop operations.
Object
 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
 Inherited
Returns the primitive value of the specified object.
Object
 Inherited
Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type.
EventDispatcher
Events
 Event Summary Defined By
 Inherited[broadcast event] Dispatched when the Flash Player or AIR application gains operating system focus and becomes active.EventDispatcher
 Inherited[broadcast event] Dispatched when the Flash Player or AIR application operating loses system focus and is becoming inactive.EventDispatcher
  Dispatched when this Asset is completely fetched from the server.FragmentLayoutModel
  Dispatched when the fragmentLayout is successfully saved.FragmentLayoutModel
  Dispatched when a fault occurs while saving the fragmentLayout.FragmentLayoutModel
  Dispatched when the current fragmentLayout is requested for save.FragmentLayoutModel
Property Detail

cutsomizedLayout

property
cutsomizedLayout:Boolean

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

The tables of the underlying value object.

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



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

fields

property 
fields:IList

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

The fields of the underlying value object.

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



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

file

property 
file:FileModel

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

The file domain object associated with this fragmentLayout.

The file domain object is a representation of the XDP file that is uploaded by the user at the time of creation or updating of this fragmentLayout.



Implementation
    public function get file():FileModel
    public function set file(value:FileModel):void

flowedLayout

property 
flowedLayout:Boolean

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

whether underlying value object is a flowed layout or not

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



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

shallow

property 
shallow:Boolean

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

Flag to indicate if the underlying value object is shallow.

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 shallow():Boolean
    public function set shallow(value:Boolean):void

tables

property 
tables:IList

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

The tables of the underlying value object.

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



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

targetAreas

property 
targetAreas:IList

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

The target areas of the underlying value object.

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



Implementation
    public function get targetAreas():IList
    public function set targetAreas(value:IList):void
Method Detail

copy

()method
public function copy():FragmentLayoutModel

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

Creates a copy of the domain object.

Note that this is different than cloning via ObjectUtil.copy() since a "copied" object needs to be saved via a specific server api.

Returns
FragmentLayoutModel — A copy of current domain object.

createFromVO

()method 
public static function createFromVO(fragmentLayoutVO:FragmentLayout, fetchFromServer:Boolean = true):FragmentLayoutModel

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

Creates the domain object from the corresponding value object.

Value Objects are pure data entities mostly acting as parameters to the server apis. Domain objects are build atop to provide more meaningful business data and behavior thereby enabling faster and convenient UI view development. In some cases, the value objects could be shallow; for instance when obtained via Data Services. The complete value object could be requested by passing the fetchFromServer flag as true. In that case, the value object is obtained from the server via remoting call and the domain object shapes accordingly as the server response arrives.

Parameters

fragmentLayoutVO:FragmentLayout — The value object of the type FragmentLayout
 
fetchFromServer:Boolean (default = true) — Flag to indicate if the complete value object should be obtained from the server

Returns
FragmentLayoutModel — The FragmentLayout domain object corresponding the passed FragmentLayout value object.

fetchComplete

()method 
public function fetchComplete():void

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

Fetches the complete value object via remoting call. This should be called when the underlying value object is shallow.

fetchFromServer

()method 
public function fetchFromServer():void

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

Fetches the complete value object via remoting call. This should be called when the underlying value object is shallow.

isShallow

()method 
public function isShallow():Boolean

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

Indicates if the underlying value object is shallow.

Returns
Boolean

save

()method 
override public function save():void

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

Saves the underlying value object on the server.

Under the hood, separate calls are required for creating a new asset and copying or copying an existing one.

The save() method internally invokes the relevant server calls on the basis of its current state. The domain object constructed from the createFromVO() method would invoke the "update" api, the domain object starightaway instantiated on the client would inoke the "create" fragmentLayout api and the domain object obtained by the copy() method would internally call "copy api".

Invoking the save() implicitly invokes the validate() method to perform the necessary client side validations. Only when the client side validations are successful, is the actual save() call made. A save() method wouldn't proceed past the validation stage unless the object's state is made valid via user input or otherwise.

setFragmentLayoutService

()method 
public static function setFragmentLayoutService(value:IFragmentLayoutService):void

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

This method lets you inject a custom implementation of the infrastructure fragmentLayout service. By default, the class FragmentLayoutServiceDelegate is used as the infrastructure service.

Parameters

value:IFragmentLayoutService — An implementation for IFragmentLayoutService.
Event Detail

fetchComplete

Event
Event Object Type: flash.events.Event
property Event.type = flash.events.Event

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

Dispatched when this Asset is completely fetched from the server. Assets are often kept shallow in the Asset Manager and fetched completely only when necessary. The fetchComplete event is dispatched when the Asset has been retrieved completely from the server.

saveComplete

Event  
Event Object Type: com.adobe.icc.editors.events.AssetEvent
property AssetEvent.type = com.adobe.icc.editors.events.AssetEvent.SAVE_COMPLETE

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

Dispatched when the fragmentLayout is successfully saved.

The AssetEvent.SAVE_COMPLETE constant defines the value of the type property of the event object for a saveComplete event.

The saveComplete event is dispatched when the domain object has been successfully saved on the server. Unlike the saving event, this is dispatched in an aysnchronous manner only after the server has responded with a result for the save api call.

This event can be used to stop UI animations indicating "save in progress" or to popup an info box indicating save success.

saveFault

Event  
Event Object Type: com.adobe.icc.editors.events.AssetEvent
property AssetEvent.type = com.adobe.icc.editors.events.AssetEvent.SAVE_FAULT

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

Dispatched when a fault occurs while saving the fragmentLayout.

The AssetEvent.SAVE_FAULT constant defines the value of the type property of the event object for a saveFault event.

The saveFault event is dispatched when the server reports an error while saving the asset on the server. Unlike the saving event, this is dispatched in an aysnchronous manner only after the server has responded with a result for the save api call.

When this event is dispatched, the fault property contains the fault object encapsulating the error sent by the server. The fault property can be used to determine the faultCode and show an error message accordingly.

This event can be used to stop UI animations indicating "save in progress" or to popup an info box indicating save success.

saving

Event  
Event Object Type: com.adobe.icc.editors.events.AssetEvent
property AssetEvent.type = com.adobe.icc.editors.events.AssetEvent.SAVING

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

Dispatched when the current fragmentLayout is requested for save. This event, being bubbling in nature, can be leveraged by the UI to display a progress bar or animation to indicate the save progress.

The AssetEvent.SAVING constant defines the value of the type property of the event object for a saving event.

The saving event is dispatched when the save() method has been called on the domain object. This event is dispatched before any server api is invoked but after the domain client validations are complete. This is because the actual save starts once the client validations are complete.

This event can be used to start a UI animation indicating "save in progress".