Showing and Hiding Callouts in the Diagram

You can show existing connections (callouts) to show the connections between diagram elements and elements which aren't shown in the diagram.

Display Options for Callouts

Configuration

Display options for callouts are configured in three steps.

  • The first configuration needs to be made for the diagram's stereotype. The callout is available for the top-most level. If there is a new entry, all of the elements' stereotypes that can be linked to the source or target page with a dependency are offered.

    You can change the properties for the callout header display, frame, font and color for the callout header and name. The callout header depends on the callout at the source or target of a dependency. Client in Dependency is used for the source and Dependent Elements for the target as default.

    This default can be changed for a dependency's stereotype. The stereotype's Source and Target Key Word property needs to be set for this. The names set here are then shown below the stereotype as their own tabs. If you select one of these tabs, you can select the name in both English and German. The value set is inherited from the stereotype's specializations but can also be changed there.

  • The next display option level sets the direction of the dependencies being examined. The Client of Dependency and Dependent Elements default values mentioned above can be selected.

    There are three lists of stereotypes available for selection in total. These are the dependency, owner and target element of the stereotype. Depending on the selection made for the callout itself and the values on the left-hand side, the list is constrained according to the configuration.

    You can set properties for display of stereotype and element type.

    If you wish to remove an element type (e.g. create default) from the display, then you normally select the respective stereotype as Model Element Stereotype for Client of Dependency and Dependent Elements and create a display option Do Not Show in Callout and activate it. This element type will then not be shown.

  • You can set source and/or target elements and their properties on the third level. Display of the name with its name component, display of element type and stereotype and display of icons with respective icon properties are counted among these properties.

Evaluation in the Diagram

You can only create a callout in the diagram if configured display options for callouts exist for the stereotype in the diagram. It is irrelevant at this point exactly how these display options are made up.

The content that is shown is calculated once a callout is added to an element. There are two special cases to take into account:

  • The "No display option defined for callout" message appears if the display options' configuration was removed after the callout was created.
  • The "No presentable dependencies available" message appears if there is a configuration for display settings but these display options have not caused any dependencies to be shown. This may be because the respective element is not participating in any dependency. It may also be because the configuration refers to certain stereotypes and no display can therefore be created for the current element.

All available dependencies are specified for the element affected when evaluating how callout content is displayed. These dependencies are then assessed to see whether they fulfill the second and third level of configuration of display options. The desired information is only shown if this is the case. All specializations for dependencies are also assessed as well as dependencies.

Showing and Hiding Callouts

Prerequisites

A diagram exists, is opened and is reserved for editing. Diagram elements which have or can have a connection with elements not shown in the diagram exist. Display options for callouts need to be configured for the diagram's stereotype.

Context

Callouts are graphical representations of the connection between diagram elements and elements not shown in the diagram. This can be e.g. a use case's refinement relationships to requirements.

You can select one or more diagram elements to show their relationships (callouts). You need to remove the callouts from the diagram to hide them.

Attention

If you select individual connections rather than all callouts, you can only select the Delete from Model (Shift+Del) command; this deletes all model elements executed in the associated dialog.

How to proceed

  1. Select an element in the diagram which has or can have connections to elements not shown in the diagram.

  2. Select Design>Display>Callouts.

    Existing dependencies or a text saying that no dependencies which can be shown exist appear.