This content applies to version 7.5.4 or later. To specify the information
that the transformation uses to generate the output that you expect,
you use the New Transformation
Configuration wizard and
the transformation configuration
editor,
which guide you through the configuration.
About this task
A transformation configuration
has .tc as a file name extension, and contains the information that
the transformation uses to generate the output that you expect. A
transformation configuration also contains information that is specific
to a particular type of transformation. To edit an existing transformation
configuration, in 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 that you are working
in, complete one of the following steps:
- In the Pattern Explorer view, right-click
a transformation; then 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,
specify 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 forward slash (/).
- 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 appear in this list.
- Click Next.
- Specify the source and target elements
for the transformation. For a list of valid source and target elements,
see the related concept topic for this transformation. On the Source and Target page,
complete the following steps:
- In the Selected source pane,
select the source element for the transformation to transform.
- In the Selected target pane,
select the destination of the transformation output. To create a new
destination for the output, click Create Target Container.
- Click Finish. The transformation configuration
editor opens,
and the contents of the configuration are displayed.
- Optional: Specify documentation
about the transformation configuration. This field is useful for communicating
information about a configuration that multiple users share. On the Main page,
in the Documentation field,
specify additional information about the transformation configuration.
- Optional: Specify how the transformation transforms
business processes into service participant components and whether
the transformation uses a Business Process Modeling Notation (BPMN)
process as the implementation for the service operation of the generated
service participant component. On the Output Options page, complete
the following steps:
- For each BPMN process in the table, specify the name
of the service participant component to generate. You can specify
the same service participant component for multiple BPMN processes.
- Optional: To specify that the service operation
in a participant component is opaque, select the Set Opaque
Behavior check box that corresponds to the BPMN process.
The transformation sets the corresponding BPMN process as the implementation
for the service operation in the generated service participant component.
- Optional: To specify merge options for the
generated output, on the Properties page, complete any of the following
steps:
- To specify how the transformation merges output with existing
artifacts, for the Merge Option property, select a value from the
list in the Value column.
| Option |
Description |
| Automatic |
Adds new elements without prompting you for
confirmation |
| Override |
Overwrites all conflicting files automatically |
| Silent |
Suppresses prompts and dialog boxes when models
merge |
| Visual |
Displays user prompts and warning dialog boxes
when models merge |
- To specify whether a warning is displayed if a merge conflict
occurs, for the Merge Warning property, select true or false.
- Click .
Results
The options are applied the next time that
you run the transformation.