This content applies to version
7.5.1 or later. To
specify the information that a transformation uses to generate the
output that you expect, use the New Transformation Configuration wizard
and transformation configuration editor, which guide you through the
configuration.
About this task
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.
A transformation configuration
file has the .tc extension. The configuration contains the information
that the transformation uses to generate the expected output. Transformation
configurations also contain information details that are specific
to particular types of transformations. To edit an existing transformation
configuration, use a view that shows the workspace resources. Double-click
a transformation configuration file, which opens the transformation
configuration editor.
To simplify working
with the transformation configuration file, save the configuration
file in the project that contains the elements to transform.
Procedure
- Depending on the view in which you are working,
complete one of the following steps:
- From the Modeling menu, click .
- In the Pattern Explorer view, right-click a transformation
and click New Configuration.
- In other views, click . If Transformation Configuration is
not a menu item, click .
- Specify the details of the configuration.
In the New Transformation Configuration wizard, on the Specify
a Configuration Name and Transformation page, complete
the following steps:
- In the Name field, type a name
for the configuration.
- In the Configuration file destination field,
specify the destination for the transformation configuration file.
The destination is a relative path in your current workspace. You
can specify a fully qualified project name or folder name. If you
specify a folder in a project, you must prefix the folder name with
a slash (/).
- From the Transformation list,
select .
Tip: To display the transformations
that are installed, but not enabled, click Show all transformations.
A transformation must be bound to a capability to be displayed in
this list.
- In the Protocol section,
specify the modeling protocol, which is also called the design contract
management protocol (DCMP). The value that you select determines whether
to synchronize the transformation source and target.
- Click Next.
- Select the project of Rational Requirements Composer artifacts
or archive file that you want to import and transform to UML, and
click Open.
- Specify the source and target elements
for the transformation. On the Source and Target page,
complete these steps. For a list of valid source and target
elements, see the related concept topic for this transformation.
- In the Selected source pane,
load a valid Rational Requirements Composer project,
which can be an Rational Requirements Composer archive
(compressed) or project root folder. When it is loaded, click the
check boxes to select the source elements for the transformation to
transform. Note that although at any time a new Rational Requirements Composer project
can be loaded using Load from archive or Load
from file system, the newly loaded project (archived or
not) replaces the content of the previously loaded project.
- In the Selected target pane,
select the destination of the transformation output. To create a new
destination for the output, you can click Create Target
Container.
- Click Next.
- On the Transformation properties page,
you can configure additional transformation properties. For example,
in the Target model name field, you can specify
a file name for the target model and use .emx as the file name extension.
In the Base URL field, you can specify the
location of the Rational Requirements Composer server.
The transformation uses this URL to convert links that reference original
elements on the Rational Requirements Composer server.
You can use converted links to navigate from the generated UML model
to the original elements located on the Rational Requirements Composer server.
Right-click on UML elements transformed from first-class objects,
such as Actors, Use Cases, or Business Processes and from the pop-up
menu click to navigate the link. To navigate using the installed
product, use the Rational Requirements Composer protocol
in the base URL. To navigate to the web-enabled server, use the HTTP
protocol. You can select the Use manifest check
box if you want to use the base URL that the manifest file specifies.
Note: The integration capability for the Base URL is available
only if the products are installed on the same computer.
- Click Finish. The transformation configuration editor opens, and the
contents of the configuration are displayed.
- To configure the other settings
for the transformation, click the tabs in the editor.
- Click .