Absorbing fragments in UML models

If a UML model contains fragments that you no longer require, you can move the associated elements into the parent model or resource by absorbing them.

Before you begin

You must have at least one UML model in your workspace, and the model must contain a fragment.


  1. In the Project Explorer view, right-click a fragment; then click Refactor > Absorb Fragment.
  2. Optional: In the Absorb Model Fragment window, to update references to the elements in the fragment, select the check box.
  3. Optional: To view the list of updates to make, click Preview.
  4. Optional: Select the check boxes for the updates to make.
  5. Click OK.


The selected fragment is moved back into the model and the fragment EFX file is deleted.
Note: When you validate resources, the preference settings determines the scope and actions that are taken to fix model fragments. To change preferences click Window > Preferences > Modeling > Resource Resolution. The following table shows the options and behavior settings for the resource resolution tool:
Resolution Method Result
None No action occurs.
Prompt (default) You are prompted to either mark or repair broken fragments.
Repair Broken Fragments Repair broken fragments will attempt to repair the fragments with the following limitation:
  • The tool will searches only in the logical model for the new location of the fragment.
  • Repairs that occur are transient; the tool does not modify the model to accommodate fixing read-only resources.
Mark Broken Fragments The tool creates validation markers in the Problems view. You can use the Quick Fix tool to correct the problems. The tool searches the entire workspace and modifies the model.
Check to Perform Result
Check Resources (default) The tool checks that the referenced resources exist.
Check Resources and elements The tool checks references to the resources and elements.