Prev Next

Combined Fragment

A Combined Fragment used in a UML Sequence diagrams as rendered using Sparx Systems Enterprise Architect.

A Combined Fragment reflects one or more aspects of interaction (called interaction operands) controlled by an interaction operator, with corresponding boolean conditions known as interaction constraints. The Fragment displays as a transparent window, divided by horizontal lines for each operand.

This Sequence diagram illustrates the use of Combined Fragments in modeling a simplified purchasing process. A loop fragment represents iteration through an unknown number of items for purchase, after which the cashier requests payment. An alternative fragment represents the payment options, the fragment being divided to show the two operands cash and credit card. After the fragment completes its trace, the cashier gives a receipt to the customer, under the fulfilled condition that payment requirements were met.

Examples of Combined Fragments used in a UML Sequence diagrams as rendered using Sparx Systems Enterprise Architect.

The order of interaction fragment conditions can be changed directly on the diagram:

  1. Select an interaction fragment with more than one condition defined; up and down arrows appear on the right hand side of each condition.
  2. Click on the appropriate arrow to change the order.

Examples of setting Conditions in a Combined Fragment using Sparx Systems Enterprise Architect. Examples of setting Conditions in a Combined Fragment using Sparx Systems Enterprise Architect.

Selecting and Moving a Combined Fragment

In order to select a Combined Fragment, you must click near the inside edge or drag a selection rectangle around the Fragment; this is designed to prevent accidental selection when moving Messages inside the Fragment.

Once contained within a Fragment or a Fragment Operand, Messages continue to be contained by it as they are moved up and down the diagram. To move a Message out of a Fragment, or to a different position in the sequence within the Fragment, press and hold the Alt key as you drag the Message into position.  A Fragment on a Sequence diagram will resize when a Message within it is moved up or down, to continue to contain that Message.

When you select an Interaction Fragment on a diagram, it shows one of two element icons (off the top right corner) that control how freely you can move the fragment and any Messages within and below the fragment.

Moving Combined Fragments in Sparx Systems Enterprise Architect.

To move a Combined Fragment independently of its contents, make sure the 'move freely' element icon Interaction Fragment icon is visible; if it is not shown, click on the 'move contents' icon Move Control and drag the element border.

Interaction Fragments inside a Combined Fragment operand cannot be moved outside the operand unless the fragment is in 'move freely' mode. Moving an operand line moves any objects and Messages below that line down or up by the amount the operand line is moved.

Fragments containing other fragments resize when the contained fragment is resized (unless the fragment is in 'move freely' mode).

Toolbox icon

Fragment element

Learn more

OMG UML Specification

The OMG UML specification (UML Superstructure Specification, v2.1.1, p.467) states:

A combined fragment defines an expression of interaction fragments. A combined fragment is defined by an interaction operator and corresponding interaction operands. Through the use of CombinedFragments the user will be able to describe a number of traces in a compact and concise manner.