Setting options for merging and overwriting transformation output

You can set options to determine how artifacts that a transformation generates are merged or overwritten in the target project. For example, you can perform a visual merge in which you view and confirm changes to the target project, you can silently merge nonconflicting changes, or you can automatically overwrite the target source with all changes that the transformation generates.

Procedure

  1. Open an existing transformation configuration file, or create a new transformation configuration.
  2. On the Main page, select from the following merge options:
    Option Description
    Visual merge This option opens the Merge the Transformation Output window and starts a merge session so that you can review and resolve differences between generated target content and existing target content.
    Silent merge This option prevents a transformation output merge when changes occur either in the transformation source or in the transformation target.
    Do not merge: Overwrite files without a warning This option overwrites existing files with generated files automatically.
    Do not merge: Warn before overwriting any files This option opens the Replace Resources window, which prompts you for confirmation before overwriting existing files with generated files, and adds new artifacts automatically. If you do not want to overwrite an existing resource, you can clear its selection in the window.
    Automatically add new elements to the target model When you use the visual merge capability, this option adds new artifacts to the target project source without prompting you for confirmation. To enable this option, select Visual merge.
    Save changes before validating files To validate a transformation output artifact, you must save a modified artifact. When you use the visual merge capability, this option automatically saves resources that you select for validation. To enable this option, select Visual merge.
    Automatically validate saved changes When you use the visual merge capability, this option automatically validates a resource after you save it. To enable this option, select Visual merge.
  3. Click File > Save.

Results

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

Feedback