Configuring Requirements-to-UML transformations

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

  1. Depending on the view in which you are working, complete one of the following steps:
    • From the Modeling menu, click Transformation > Create new configuration.
    • In the Pattern Explorer view, right-click a transformation and click New Configuration.
    • In other views, click File > New > Transformation Configuration. If Transformation Configuration is not a menu item, click File > New > Other > Transformations > Transformation Configuration.
  2. 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:
    1. In the Name field, type a name for the configuration.
    2. 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 (/).
    3. From the Transformation list, select Requirements Composer Integration > Requirements Composer Artifact Transform.
      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.
  3. 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.
    • If the source model is the primary engineering artifact, click Conceptual. Changes to the source model are propagated to the target model.
    • The Mixed protocol is not currently available.
    • The Reconciled protocol is not currently available.
  4. Click Next.
  5. Select the project of Rational Requirements Composer artifacts or archive file that you want to import and transform to UML, and click Open.
  6. 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.
    1. 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.
    2. 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.
  7. Click Next.
  8. 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 Navigate > Show in > Rational Requirements Composer 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.
  9. Click Finish. The transformation configuration editor opens, and the contents of the configuration are displayed.
  10. To configure the other settings for the transformation, click the tabs in the editor.
  11. Click File > Save.

Results

The options are applied the next time that you run the transformation.

Feedback