blob: b175c86356d0cadc24421c878fad6c6f9ecddc20 [file] [log] [blame]
<html><head><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>4.4.5.&nbsp;Move Rule</title><link href="style.css" rel="stylesheet" type="text/css"><meta content="DocBook XSL Stylesheets V1.72.0" name="generator"><link rel="start" href="index.html" title="The VIATRA2 Model Transformation Framework"><link rel="up" href="sec_ASMModelManipulationRules.html" title="4.4.&nbsp;Model Manipulation Rules"><link rel="prev" href="def_CopyRule.html" title="4.4.4.&nbsp;Copy Rule"><link rel="next" href="def_ElementUpdateRule.html" title="4.4.6.&nbsp;Element Update Rule"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">4.4.5.&nbsp;Move Rule</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="def_CopyRule.html">Prev</a>&nbsp;</td><th align="center" width="60%">4.4.&nbsp;Model Manipulation Rules</th><td align="right" width="20%">&nbsp;<a accesskey="n" href="def_ElementUpdateRule.html">Next</a></td></tr></table><hr></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="def_MoveRule"></a>4.4.5.&nbsp;Move Rule</h4></div></div></div><div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Tip: Description"><tr><td valign="top" align="center" rowspan="2" width="25"><img alt="[Tip]" src="images/tip.png"></td><th align="left"><a name="def_MoveRule_Description"></a>Description</th></tr><tr><td valign="top" align="left"><p>
The <span class="strong"><strong>move rule</strong></span><a name="N11DE0" class="indexterm"></a> changes the location of an entity in the
containment hierarchy.
</p></td></tr></table></div><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Important: Syntax"><tr><td valign="top" align="center" rowspan="2" width="25"><img alt="[Important]" src="images/important.png"></td><th align="left"><a name="def_MoveRule_Syntax"></a>Syntax</th></tr><tr><td valign="top" align="left"><pre class="programlisting">
MoveRuleAST ::= <span class="token">move</span> <span class="token">(</span> <a href="def_ArithmeticTerm.html" title="5.3.1.&nbsp;Arithmetic Term">ArithmeticTermAST</a> <span class="token">,</span> <a href="def_ArithmeticTerm.html" title="5.3.1.&nbsp;Arithmetic Term">ArithmeticTermAST</a> <span class="token">)</span> <span class="token">;</span>
</pre><p>
A <span class="strong"><strong>move rule</strong></span> has two parameters: the first <span class="strong"><strong>source entity</strong></span>
and the second <span class="strong"><strong>target container</strong></span>. Both are ASM <a href="def_ArithmeticTerm.html" title="5.3.1.&nbsp;Arithmetic Term">terms</a>
that evaluates to a <a href="def_ModelElementConstant.html" title="5.4.8.&nbsp;Model Element Constant">model element constant</a> referencing an
<a href="def_Entity.html" title="2.2.1.&nbsp;Entity">entity</a>.
</p></td></tr></table></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note: Semantics"><tr><td valign="top" align="center" rowspan="2" width="25"><img alt="[Note]" src="images/note.png"></td><th align="left"><a name="def_MoveRule_Semantics"></a>Semantics</th></tr><tr><td valign="top" align="left"><p>
The <span class="strong"><strong>move rule</strong></span> moves the element specified by the first
parameter (<span class="strong"><strong>source entity</strong></span>) to the container specified by the second
parameter (<span class="strong"><strong>target container</strong></span>).
</p><p>
The <span class="strong"><strong>move rule</strong></span> performs changes only in the containment
hierarchy, i.e. no model element or relationship is deleted from the model space.
</p></td></tr></table></div><div class="caution" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Caution: Constraints"><tr><td valign="top" align="center" rowspan="2" width="25"><img alt="[Caution]" src="images/caution.png"></td><th align="left"><a name="def_MoveRule_Constraints"></a>Constraints</th></tr><tr><td valign="top" align="left"><p>
Note that the <span class="strong"><strong>move rule</strong></span> may be conflicting with creating
relations of aggregation type.
</p></td></tr></table></div><div class="highlights"><a name="def_MoveRule_DefinedIn"></a><p><b>Defined In:&nbsp;</b>
<a href="def_ModelManipulationRule.html" title="4.4.1.&nbsp;Model Manipulation Rule">model manipulation rule</a>
</p></div><div class="highlights"><a name="def_MoveRule_SeeAlso"></a><p><b>See Also:&nbsp;</b>
<a href="def_CopyRule.html" title="4.4.4.&nbsp;Copy Rule">copy rule</a>
</p></div></div><div class="navfooter"><hr><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="def_CopyRule.html">Prev</a>&nbsp;</td><td align="center" width="20%"><a accesskey="u" href="sec_ASMModelManipulationRules.html">Up</a></td><td align="right" width="40%">&nbsp;<a accesskey="n" href="def_ElementUpdateRule.html">Next</a></td></tr><tr><td valign="top" align="left" width="40%">4.4.4.&nbsp;Copy Rule&nbsp;</td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td valign="top" align="right" width="40%">&nbsp;4.4.6.&nbsp;Element Update Rule</td></tr></table></div></body></html>