Wizard Elements

The wizard's interface is made of a single page containing several sections that allow to configure the different aspects of a transformation's application. The following illustrates the UI elements in detail.

Figure 4.2. Wizard

Wizard

  1. Select the Rule or TransformationUnit that shall be executed. This selector is only enabled if the wizard is opened in the context of a TransforamtionSystem or a henshin-file. Otherwise the Rule or TransforamtionUnit for which the wizard was opened will be fixed.

  2. Select the resource you wish to transform. Only the first content element of the resource will be used as the graph.The element is inserted as root. This means that the graph will consist of the element itself and all transitively contained objects.

  3. Set values for the parameters of the chosen unit. Since all values are entered as strings, it is necessary to also select a type. The given string-value is parsed as the defined type, which is then passed to the transformation.

    Figure 4.3. Selecting a parameter's type

    Selecting a parameter's type


    There are two types which do not allow a value to be entered:

    • The type Ignore prevent a parameter from being initialized. This option must be used for parameters that pre-match a node in the LHS.

    • The type Null initializes a parameter with null. If the parameter is used as an attribute value in the LHS, the attribute value of a match must be null. In case the parameter defines a prematch-node, setting the Null-type will prevent the unit from being applicable.

  4. This allows to see a preview of the transformation. The transformation will be applied to a copy of the selected model. The differences are detected and visualized using EMF Compare.

  5. Applies the transformation to the selected model and writes the result back to the resource. This action is encapsulated as an undoable operation using the Eclipse Command Framework. Note that this does not place an undoable command on the EMF CommandStack inside the editor. To undo a transformation you have to focus the Package Explorer. This will switch the context of the edit-menu to the platform's operation history.

  6. Cancel closes the dialog without applying the transformation.

  7. This flag indicates whether the settings shall be saved even if the transformation was not applied. The current settings are automatically saved when the dialog is closed via the Transform button. If you are in the process of developing a transformation, usually you will only preview your transformation's effects without applying them to the selected model. To avoid having to select a model and entering parameter values each time, those settings may are saved if the Save Cfg on Cancel is checked, even if the dialog is canceled.

  8. Provides access to this document .