Running Requirements-to-UML transformations

This content applies to version 7.5.1 or later. 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.

Before you begin

Verify that a transformation configuration file exists in the workspace or in a file that you can access by specifying a URL.

Note: To import archives from Rational® Requirements Composer version 2.0 or later, you must use a Rational modeling product that is version 7.5.5 Interim Fix 002 or later.

Procedure

To run a transformation, complete the steps for one of the following options:
Option Description
Use a transformation configuration Depending on the view that you are in, complete one of the following steps:
  • In the navigation view, right-click a transformation configuration file, or (.tc) file; then click Transform and click a transformation. When you apply a transformation configuration, an instance of the transformation is created and the transformation runs with the properties that the configuration defines.
  • In the Pattern Explorer view, right-click a transformation; then click Run Transformation. In the Select configuration window, specify the transformation configuration to run, and click OK.
  • If you want to apply a transformation configuration from the transformation configuration editor, go to the Main tab and click Run.
Override the transformation source that is defined in a transformation configuration 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. The transformation configuration is not affected and the source that you specify on the Source and Target page of the transformation configuration editor or in the New Transformation Configuration wizard does not change. The transformation configuration file must be in the same project as the elements that you select.
Tip: To run this transformation again, click Modeling > Transform > Run Last. The transformation uses the same source elements from the last transformation that you ran.
Run the transformation from the command line To run a transformation from a command line, use this 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"
Invoke the transformation API To run the transformation as part of an application, you can invoke the transformation API, as in this example:
IFile file = ResourcesPlugin.getWorkspace().getRoot().
getFile(new Path("/MyWorkspace/MyConfig.tc")); 
try 
{ITransformConfig config = TransformConfigUtil.
loadConfiguration(file);IStatus status = TransformController.
getInstance().execute(config, null, false, null); } catch 
(IOException e) { // The config file could not be read.}
You can also load a transformation configuration by specifying a URL, as in this example:
try {
		URL url= new URL(platform:/plugin/myPluginID/myConfig.tc);
			
ITransformConfig config = TransformConfigUtil.loadConfiguration(url);
	}
	catch (MalformedURLException malURLEx) {
		// Handle exception.
	}
	catch (IOException ioEx) {
		// Handle exception.
You can specify a URL that uses different protocols, as in these examples:
  • -platform:/plugin/myPluginID/myConfig.tc
  • -http://myServer.myCompany.com/myConfig.tc
  • -ftp://myUsername:myPassword@myServer.myCompany.com/myConfig.tc
  • -jar:file:c:/myFolder/myJar.jar!/myConfig.tc
  • -file:c:/myFolder/myConfig.tc
Run a transformation configuration from an Ant script
To run a transformation from an Ant script or build.xml file, within the <project></project> tags, create a target element, as in this example:
<target name="generate"> 	<echo>Running transformation 
'myProject/myConfig.tc'...</echo> 	<com.ibm.xtools.
transform.core.runTransformation transformConfig=
"myProject/myConfig.tc" reverse="false"/> </target>

In the build.xml file, in the project element, set the default attribute equal to the value that you specify for the name attribute in the target element.

The transformConfig attribute must specify a valid workspace path.

To run the reverse transformation, set the reverse attribute to true.
Important: The transformation configuration must implement the Reconciled Modeling design contract management protocol (DCMP).

To run the Ant script, right-click the build.xml file; then click Run As > ANT build.


Feedback