Referência do ActionScript® 3.0 para Adobe® Flash® Platform
Início  |  Ocultar listas de Pacotes e Classes |  Pacotes  |  Classes  |  Novidades  |  Índice  |  Apêndices  |  Por que inglês?
Filtros: Recuperando dados do servidor...
Recuperando dados do servidor...
com.adobe.icc.editors.model 

LetterModel  - AS3 Asset Composer

Pacotecom.adobe.icc.editors.model
Classepublic class LetterModel
HerançaLetterModel Inheritance AssetModel Inheritance EventDispatcher Inheritance Object

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

The LetterModel class represents the domain object for the assets of type Letter. 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.



Propriedades públicas
 PropriedadeDefinido por
 InheritedactiveEndDate : Date
The activeEndDate of the underlying value object.
AssetModel
 InheritedactiveStartDate : Date
The activeStartDate date of the underlying value object.
AssetModel
  assignments : IList
The consolidated list of variable and field assignments of this letter.
LetterModel
 Inheritedcategory : Category
The Category of the underlying value object.
AssetModel
 Inheritedcomment : String
The comment of the underlying value object.
AssetModel
 Inheritedconstructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto.
Object
 InheritedcrxVersion : String
The crx version of the underlying value object.
AssetModel
  dataDictionary : DataDictionary
The typed DataDictionary object being used by this module.
LetterModel
  dataDictionaryName : String
The name of the data dictionary being used by this module.
LetterModel
  dataDictRegistryService : DataDictionaryRegistryService
[estático] The infrastructure service for data dictionary mainly used internally for fetching data dictionary objects.
LetterModel
 Inheriteddescription : String
The description of the underlying value object.
AssetModel
 InheritedextendedProperties : Object
The extended properties of the underlying value object.
AssetModel
  fields : IList
[somente leitura] Returns the list of fields in the base layout and all the container layouts.
LetterModel
 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
  layout : LayoutModel
The domain object of the layout associated with this letter.
LetterModel
  modules : IList
[somente leitura] The list of data modules being referred in this letter.
LetterModel
 Inheritedname : String
The name of the underlying value object.
AssetModel
  postProcess : String
The postprocess to be executed.
LetterModel
  service : ILetterService
[estático] The letter service instance that is used for saving/retrieving the letter on the server.
LetterModel
 Inheritedstate : int
The state of the underlying value object.
AssetModel
  staticEventDispatcher : IEventDispatcher
[estático] [somente leitura]
LetterModel
 InheritedsubCategory : Category
The Sub-Category of the underlying value object.
AssetModel
  targetAreaAssignments : IList
The list of target area assignments in this Letter.
LetterModel
  testDataFile : FileModel
The test data file that supplies the preview data.
LetterModel
 Inheritedversion : int
The version of the underlying value object.
AssetModel
 Inheritedvo : *
The value object which this asset domain object is built atop.
AssetModel
Propriedades protegidas
 PropriedadeDefinido por
 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
Métodos públicos
 MétodoDefinido por
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento.
EventDispatcher
  
Creates a copy of the domain object.
LetterModel
  
createFromVO(letterVO:Letter, fetchFromServer:Boolean = true):LetterModel
[estático] Creates the domain object from the corresponding value object.
LetterModel
 Inherited
Envia um evento para o fluxo de eventos.
EventDispatcher
  
Returns the target area assignment domain object for the passed target area.
LetterModel
  
Returns the list of variables being referred in this letter.
LetterModel
 Inherited
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento.
EventDispatcher
 Inherited
Indica se um objeto tem uma propriedade especificada definida.
Object
  
Indicates whether the data dictionary defined for this letter has been referred in any of the assignments.
LetterModel
  
The function indicates whether data dictionary is referenced in the nested layout.
LetterModel
 Inherited
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.
Object
 Inherited
Indica se a propriedade especificada existe e é enumerável.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Remove um ouvinte do objeto EventDispatcher.
EventDispatcher
  
Resets all the assignment lists in this Letter.
LetterModel
  
[substituir] Saves the underlying value object on the server.
LetterModel
  
setDataDictionaryName(ddName:String, fetchDataDictionary:Boolean = true):void
Sets the data dictionary name to the one specified and also fetches the corresponding DataDictionary object from the server.
LetterModel
  
[estático] This method lets you inject a custom implementation of the infrastructure data dictionary service.
LetterModel
  
setLayout(layout:LayoutModel, resetAssignments:Boolean = true):void
Sets the layout for this letter.
LetterModel
  
[estático] This method lets you inject a custom implementation of the infrastructure letter service.
LetterModel
 Inherited
Define a disponibilidade de uma propriedade dinâmica para operações de repetição.
Object
 Inherited
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade.
Object
 Inherited
Retorna a representação de string do objeto especificado.
Object
 Inherited
Retorna o valor primitivo do objeto especificado.
Object
 Inherited
Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado.
EventDispatcher
Métodos protegidos
 MétodoDefinido por
  
Fetches the data dictionary corresponding to the name specified.
LetterModel
Eventos
 Evento Resumo Definido por
 Inherited[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo.EventDispatcher
 Inherited[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo.EventDispatcher
  Dispatched when the letter has been completely fetched from the server.LetterModel
  Dispatched when a module assignment is added to any of the target area assignments.LetterModel
  Dispatched when a module assignment is removed from any of the target area assignments.LetterModel
  Dispatched when the letter is successfully saved.LetterModel
  Dispatched when a fault occurs while saving the letter.LetterModel
  Dispatched when the current letter is requested for save.LetterModel
Detalhes da propriedade

assignments

propriedade
assignments:IList

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

The consolidated list of variable and field assignments of this letter.

Essa propriedade pode ser usada como a origem para o vínculo de dados. Quando essa propriedade é modificada, ela despacha o evento assignmentsChange .



Implementação
    public function get assignments():IList
    public function set assignments(value:IList):void

dataDictionary

propriedade 
dataDictionary:DataDictionary

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

The typed DataDictionary object being used by this module. Assigning a value to this property updated the dataDictionaryName as well but not the other way round.

Essa propriedade pode ser usada como a origem para o vínculo de dados. Quando essa propriedade é modificada, ela despacha o evento ddChange .



Implementação
    public function get dataDictionary():DataDictionary
    public function set dataDictionary(value:DataDictionary):void

dataDictionaryName

propriedade 
dataDictionaryName:String

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

The name of the data dictionary being used by this module. Merely setting this property wouldn't cause the dataDictionary to be retrieved. If the dataDictionary needs to be updated, setDataDictionaryName() method must be used instead.

Essa propriedade pode ser usada como a origem para o vínculo de dados. Quando essa propriedade é modificada, ela despacha o evento ddNameChange .



Implementação
    public function get dataDictionaryName():String
    public function set dataDictionaryName(value:String):void

Elementos da API relacionados

setDataDictionaryName()

dataDictRegistryService

propriedade 
dataDictRegistryService:DataDictionaryRegistryService

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

The infrastructure service for data dictionary mainly used internally for fetching data dictionary objects.

Essa propriedade pode ser usada como a origem para o vínculo de dados. Quando essa propriedade é modificada, ela despacha o evento propertyChange .



Implementação
    public static function get dataDictRegistryService():DataDictionaryRegistryService
    public static function set dataDictRegistryService(value:DataDictionaryRegistryService):void

fields

propriedade 
fields:IList  [somente leitura]

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 10
Versões de runtime: AIR (unsupported), Flash Player 10.2

Returns the list of fields in the base layout and all the container layouts.

Essa propriedade pode ser usada como a origem para o vínculo de dados. Quando essa propriedade é modificada, ela despacha o evento fieldAssignmentsChange .



Implementação
    public function get fields():IList

layout

propriedade 
layout:LayoutModel

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

The domain object of the layout associated with this letter.

Essa propriedade pode ser usada como a origem para o vínculo de dados. Quando essa propriedade é modificada, ela despacha o evento propertyChange .



Implementação
    public function get layout():LayoutModel
    public function set layout(value:LayoutModel):void

modules

propriedade 
modules:IList  [somente leitura]

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

The list of data modules being referred in this letter.



Implementação
    public function get modules():IList

postProcess

propriedade 
postProcess:String

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

The postprocess to be executed.



Implementação
    public function get postProcess():String
    public function set postProcess(value:String):void

service

propriedade 
service:ILetterService

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

The letter service instance that is used for saving/retrieving the letter on the server. This service is internally invoked by the LetterModel class for performing CRUD operations.

Essa propriedade pode ser usada como a origem para o vínculo de dados. Quando essa propriedade é modificada, ela despacha o evento propertyChange .



Implementação
    public static function get service():ILetterService
    public static function set service(value:ILetterService):void

staticEventDispatcher

propriedade 
staticEventDispatcher:IEventDispatcher  [somente leitura]



Implementação
    public static function get staticEventDispatcher():IEventDispatcher

targetAreaAssignments

propriedade 
targetAreaAssignments:IList

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

The list of target area assignments in this Letter.

Essa propriedade pode ser usada como a origem para o vínculo de dados. Quando essa propriedade é modificada, ela despacha o evento targetAreaAssignmentsChange .



Implementação
    public function get targetAreaAssignments():IList
    public function set targetAreaAssignments(value:IList):void

testDataFile

propriedade 
testDataFile:FileModel

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

The test data file that supplies the preview data.



Implementação
    public function get testDataFile():FileModel
    public function set testDataFile(value:FileModel):void
Detalhes do método

copy

()método
public function copy():LetterModel

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

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.

Retorna
LetterModel — A copy of current domain object.

createFromVO

()método 
public static function createFromVO(letterVO:Letter, fetchFromServer:Boolean = true):LetterModel

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

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.

Parâmetros

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

Retorna
LetterModel — The Letter domain object corresponding the passed letter value object.

fetchDataDictionary

()método 
protected function fetchDataDictionary():void

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

Fetches the data dictionary corresponding to the name specified.

getTargetAreaAssignment

()método 
public function getTargetAreaAssignment(area:*):com.adobe.icc.editors.model:TargetAreaAssignmentModel

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

Returns the target area assignment domain object for the passed target area.

Parâmetros

area:* — The target area

Retorna
com.adobe.icc.editors.model:TargetAreaAssignmentModel — The target area assignment domain object

getVariables

()método 
public function getVariables():IList

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

Returns the list of variables being referred in this letter. This is a consolidated list of all the variables from all the referred modules.

Retorna
IList — The list of variables being referred in this letter

isDDReferenced

()método 
public function isDDReferenced():Boolean

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

Indicates whether the data dictionary defined for this letter has been referred in any of the assignments.

Retorna
Boolean — true, if the data dictionary is referred. false, otherwise.

isDDReferencedInNestedLayouts

()método 
public function isDDReferencedInNestedLayouts(targetAreaAssignments:IList):Boolean

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 10.0
Versões de runtime: AIR (unsupported), Flash Player 10.2

The function indicates whether data dictionary is referenced in the nested layout.

Parâmetros

targetAreaAssignments:IList — list of target area assignments

Retorna
Boolean — flag indicating whether data dictionary is referenced in the nested layout.

resetAssignmentLists

()método 
public function resetAssignmentLists(layout:LayoutModel):void

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

Resets all the assignment lists in this Letter.

Parâmetros

layout:LayoutModel — Layout Model

save

()método 
override public function save():void

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

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" module 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.

setDataDictionaryName

()método 
public function setDataDictionaryName(ddName:String, fetchDataDictionary:Boolean = true):void

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

Sets the data dictionary name to the one specified and also fetches the corresponding DataDictionary object from the server.

Parâmetros

ddName:String — Name of the data dictionary
 
fetchDataDictionary:Boolean (default = true) — flag to indicate if the corresponding data dictionary object needs to be fetched from the server.

setDataDictRegistryService

()método 
public static function setDataDictRegistryService(value:DataDictionaryRegistryService):void

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

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

Parâmetros

value:DataDictionaryRegistryService — An implementation for DataDictionaryRegistryService.

setLayout

()método 
public function setLayout(layout:LayoutModel, resetAssignments:Boolean = true):void

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

Sets the layout for this letter.

Parâmetros

layout:LayoutModel — The domain object of the layout that needs to be associated with this Letter
 
resetAssignments:Boolean (default = true) — Whether the various assignment lists should be reset or not.

setLetterService

()método 
public static function setLetterService(value:ILetterService):void

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

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

Parâmetros

value:ILetterService — An implementation for ILetterService.

Detalhe do evento

fetchComplete

Evento
Tipo do objeto de evento: flash.events.Event
propriedade Event.type = flash.events.Event

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

Dispatched when the letter has been completely fetched from the server.

moduleAssignmentAdd

Evento  
Tipo do objeto de evento: flash.events.Event
propriedade Event.type = flash.events.Event

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

Dispatched when a module assignment is added to any of the target area assignments.

moduleAssignmentRemove

Evento  
Tipo do objeto de evento: flash.events.Event
propriedade Event.type = flash.events.Event

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

Dispatched when a module assignment is removed from any of the target area assignments.

saveComplete

Evento  
Tipo do objeto de evento: com.adobe.icc.editors.events.AssetEvent
propriedade AssetEvent.type = com.adobe.icc.editors.events.AssetEvent.SAVE_COMPLETE

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

Dispatched when the letter 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

Evento  
Tipo do objeto de evento: com.adobe.icc.editors.events.AssetEvent
propriedade AssetEvent.type = com.adobe.icc.editors.events.AssetEvent.SAVE_FAULT

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

Dispatched when a fault occurs while saving the letter.

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

Evento  
Tipo do objeto de evento: com.adobe.icc.editors.events.AssetEvent
propriedade AssetEvent.type = com.adobe.icc.editors.events.AssetEvent.SAVING

Versão da linguagem: ActionScript 3.0
Versão de produto: Asset Composer Building Block 9.5
Versões de runtime: AIR (unsupported), Flash Player 9, Flash Player 10

Dispatched when the current letter 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".





[ X ]Por que inglês?
O conteúdo na Referência do ActionScript 3.0 aparece em inglês

Nem todas as partes da Referência do ActionScript 3.0 estão traduzidas em todos os idiomas. Quando um elemento de um idioma não está traduzido, ele é exibido em inglês. Por exemplo, a classe ga.controls.HelpBox não está traduzida em nenhum idioma. Por isso, na versão da referência em português do Brasil, a classe ga.controls.HelpBox é exibida em inglês.