Configuring UML-to-C++ transformations

• In the Pattern Explorer view, right-click a transformation; then 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.

1. In the Name field, specify 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 forward slash (/).
3. From the Transformation list, select a transformation.
   Note: 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.

• If the source model is the primary engineering artifact, select Conceptual. Any changes to the source model are propagated to the target model.
• If the target model is the primary engineering artifact, click Mixed. The transformation converts the source artifacts to visual representations that are directly connected to the target artifact. Select this option to work in the target domain instead of with the source model, or to retain the artifacts for analysis. The transformation output becomes the primary engineering artifact.
• If the architecture that the source artifacts represent evolves independently from the target, select Reconciled. Selecting this option enables the reverse transformation, which you can use to compare the source and target, and to reconcile changes. You might also select this option if different teams implement, develop, or maintain the architecture.
  Note: When you select this option, additional properties become available in the "Reverse transformation" section of the Main page. For some transformations, additional options or pages become available in the transformation configuration editor. For information about configuring the reverse transformation, see the related link below.

1. In the Selected source pane, select the source element for the transformation to transform.
2. In the Selected target pane, select the destination of the transformation output. To create a new destination for the output, click Create Target Container.

• To receive a prompt before the transformation overwrites a file, click Ask.
• To overwrite files automatically, click Always.
• To never overwrite files, click Never.
• To delete obsolete transformation output, select the Delete obsolete files check box.
  Note: If you select this check box, you must also select the Create trace relationships option on the Main page of the transformation configuration editor.

• To generate constructors, select the Constructor check box.
• To generate copy constructors, select the Copy constructor check box.
• To generate assignment operators, select the Assignment check box.
• To generate destructors, select the Destructor check box.
• To generate virtual destructors in the target classes, select the Virtual destructor check box.
• To generate getter and setter methods for the attributes of the generated classes, structs, or unions, select the Getters and setters check box.
• To generate inline getter and setter methods, select the Inline check box.
• To generate getter and setter methods that pass parameters and return values by using references, select the By reference check box.

• To specify that the transformation generates header files and source files in different folders in the target project, select the Create separate folders for header and source files check box, and specify folder names in the Folder for header files and Folder for source files fields. If you specify folders that do not exist in the target project, the transformation creates these folders the next time that you run the transformation.
  Note: If you select the Create separate folders for header and source files check box, the transformation suppresses path information in the generated include directives.
• To generate lowercase file names, select the Generate lowercase file names for header and source files check box.
• To specify the default return type of methods without a return type set in the model, select a return type in the Default return type section.

If you select the Create separate folders for header and source files check box, in the source file folder that you specify, the transformation generates the files in the same hierarchy as the source UML model. The transformation does not preserve the source model hierarchy for header files. For example, assume that a UML model contains a package called Package1, which contains a class called Class1. If you specify HeaderFolder and SourceFolder as the folder names for the generated header and source files, the transformation generates a file called Class1.h in the HeaderFolder folder structure of the target project, and a file called Class1.cpp in the SourceFolder/Package1 folder structure of the target project.

On the UML to C++ Properties page, under Internal inclusion, select an option from the table below. If the imported class is part of the transformation source and it does not have the «cpp_internal_inclusion» stereotype applied to it, the transformation generates include directives by using the value that you specify.

Under External inclusion, select an option from the following table. If the imported class is not part of the transformation source and it does not have the «cpp_external_inclusion» stereotype applied to it, the transformation generates include directives by using the value that you specify.

For example, you might override the default JET transformation to customize the comments in the code. The identifier of the JET transformation typically follows an inverted domain-naming schema, as in this example: my.company.my.jet.project. For more information about this function, see the related concept topic for this transformation.

1. On the Mapping page, select the Enable the mapping functionality for this configuration check box.
2. In the Mapping model file name field, specify the name of a new or existing mapping model.

The log file provides information about the source elements, the target elements, and the rules that the transformation applies to transform the source elements. If the transformation transforms many elements, you might experience decreased performance while the transformation generates the log file; therefore, you should only generate a log file for debugging purposes.

Running a transformation in silent mode suppresses all dialog boxes that the transformation generates. The transformation applies default rules and behavior, which might generate unexpected or incorrect transformation output. You should only run a transformation in silent mode to validate that the transformation runs, instead of validating the transformation output. For example, you might run a transformation in silent mode as part of an automated task or automated test suite.

Setting the transformation to run in silent mode overrides the file-overwrite options that you specify, and overwrites files if necessary.

If the C++-to-UML transformation is available, you can select the Run the reverse transformation silently check box. Specifying that the C++-to-UML, or reverse transformation runs in silent mode suppresses the merge editor. If a conflict occurs during the merge, the transformation stops and you must rerun the transformation with the silent options cleared.

You can use trace relationships and the visual development tools to understand the relationships between source model elements and transformation output. This function is useful in large projects that might contain multiple models and transformation configurations. The transformation does not alter the source model.

To view the list of elements for which traceable relationships can be created, see the related transformation concept topic link at the end of this topic.

To display the warnings that occurred when the transformation ran, select the Show warnings in the Report dialog box check box.