Difference between revisions of "AM3/Ant Tasks"

From Eclipsepedia

< AM3
Jump to: navigation, search
(Added "path" attribute description)
(Added "allowInterModelReferences" attribute)
Line 80: Line 80:
 
|-
 
|-
 
| path      || Path of ATL transformation to run || Yes
 
| path      || Path of ATL transformation to run || Yes
 +
|-
 +
| allowInterModelReferences || Boolean value that determines whether or not references between different EMF models are possible || Yes
 
|}
 
|}
  

Revision as of 07:39, 15 August 2006

This page describes the ant tasks provided by AM3.

Contents


am3.loadModel

Description

This task is used to load a model. This model may be a terminal model or a metamodel. The metametamodels are typically not loaded with this task since they come bundled with a model handler.

Parameters specified as attributes

Attribute Description Required Default value
name Name of model in task context Yes None
metamodel Name of metamodel in task context Yes None
path Path of file to load Yes None
modelHandler Model handler of loaded model No EMF

Parameters specified as nested elements

Examples

<am3.loadModel modelHandler="EMF" name="News" metamodel="MOF" path="/org.eclipse.am3.zoos.atlantic/News.ecore" />
<am3.loadModel modelHandler="EMF" name="IN" metamodel="KM3" path="/org.eclipse.am3.zoos.atlantic/Amble.km3">
 <injector name="ebnf">
  <param name="name" value="KM3" />
 </injector>
</am3.loadModel>
<am3.loadModel name="myXML" metamodel="XML" path="/test/testQuery.xml">
 <injector name="xml" />
</am3.loadModel>

am3.saveModel

Description

This task is used to save a model.

Examples

<am3.saveModel model="myXML" path="/test/opop.xml">
 <extractor name="xml" />
</am3.saveModel>
<am3.saveModel model="news_model" path="/test/news.ecore" />
<am3.saveModel model="IN" path="/test/MyKM3.km3">
 <extractor name="ebnf">
  <param name="format" value="KM3.tcs"/>
  <param name="indentString" value=" "/>
  <param name="serializeComments" value="false"/>
 </extractor>
</am3.saveModel>

am3.atl

Description

The purpose of this task is to execute an ATL transformation. The models used by a transformation are referenced by their IDs as defined at their loading time (see AM3_Ant_Tasks#am3.loadModel).

There is an exception for metametamodels, which are typically already available from the model handler. A metametamodel is referenced by a string composed of a percent character (i.e. '%') followed by the name of the model handler. For instance: '%EMF' refers to Ecore and '%MDR' refers to MOF 1.4.

Parameters specified as attributes

Attribute Description Required
path Path of ATL transformation to run Yes
allowInterModelReferences Boolean value that determines whether or not references between different EMF models are possible Yes

Parameters specified as nested elements

inModel

Attribute Description Required
name Name of model in transformation context Yes
model Name of model in task context Yes

outModel

Attribute Description Required
name Name of model in transformation context Yes
model Name of model in task context Yes
metamodel Name of metamodel in task context Yes
path Name of the output file (mainly needed for filename extension) Yes

library

Attribute Description Required
name Name of library in transformation context Yes
path Path of library Yes

Examples

<am3.atl name="/AMMA-Tools/TCS2Problem.atl">
 <inModel name="IN" model="metamodel.tcs"/>
 <inModel name="TCS" model="TCS"/>
 <inModel name="MM" model="metamodel.km3"/>
 <inModel name="KM3" model="KM3"/>
 <inModel name="Problem" model="Problem"/>
 <library name="KM3Helpers" path="/AMMA-Tools/KM3Helpers.asm" />
 <library name="strings" path="/AMMA-Tools/strings.asm" />
 <outModel name="OUT" model="metamodel.pbs" metamodel="Problem"/>
</am3.atl>