You
can run a transformation on the source model or elements that you specify
in the transformation configuration, or you can override the source specified
in the transformation configuration by selecting elements in the model and
then choosing a transformation configuration to apply.
Before
you can run a transformation, you must create a transformation configuration.
When you apply a transformation configuration, an instance of the transformation
is created and the transformation runs with the properties that the configuration
defines.
If you select
source elements in the model instead of using the transformation configuration,
the source elements that you select override the source model or elements
specified in the transformation configuration. The
transformation configuration is not affected and the source that you specify
on the Source and Target page of the transformation configuration
editor or the New Transformation Configuration wizard does not change.
To run a transformation, complete
one of the following steps:- To run the transformation on the source specified
in the configuration, depending on the view that you are working in, complete
one of the following steps:
- In the navigation
view, right-click a transformation configuration
(.tc) file; then click Transform and click a transformation.
- In the Pattern Explorer view,
right-click a transformation; then click Run Transformation.
In the Select configuration dialog box, specify the
transformation configuration to run, and click OK.
Tip: You can also
run a transformation from the transformation configuration editor. On the
Main page,
click
Run.
- To specify a different source on which to
run the transformation, in the Modeling perspective,
select and right-click elements in the source model or project; then click Transform,
click a transformation configuration, and click a transformation.
Tip: To run this transformation again,
click . The transformation uses the
same source elements from when you last ran the transformation.
- To run a
transformation from a command line, use the following syntax:
eclipse -data workspace-path -application com.ibm.xtools.transform.core.transformationRunner -transformConfigs "[-R]transformation-configuration-path1,[-R]transformation-configuration-path2,..."
In the -transformConfigs parameter,
you must specify the complete workspace path and configuration file name,
not the file-system path name, of one or more transformation configurations.
Running a transformation from a command
line suppresses all dialog boxes that the transformation generates.
As
an example, a transformation configuration called MyConfig.tc is in a project
called MyProject in a workspace called MyWorkspace. This transformation configuration
specifies the configuration information for a transformation called MyTransformation,
and for a corresponding reverse transformation called MyReverseTransformation.To invoke MyTransformation, you can run
the MyConfig.tc configuration by typing the following text at the command
line: eclipse -data /MyWorkspace -application com.ibm.xtools.transform.core.transformationRunner -transformConfigs "MyProject/MyConfig.tc"
To
run the reverse transformation, specify the -R option at the beginning of
the transformation configuration path, as in this example: eclipse -data /MyWorkspace -application com.ibm.xtools.transform.core.transformationRunner -transformConfigs "-RMyProject/MyConfig.tc"
To
run multiple transformations, in the -transformConfigs parameter,
specify a comma-separated list of transformation configurations, including
the workspace path name for each configuration. You can run forward or reverse
transformations, as in this example:eclipse -data /MyWorkspace -application com.ibm.xtools.transform.core.transformationRunner -transformConfigs "MyProject/MyConfig.tc, -RMyProject/MyConfig.tc"