Jump to Menu

How to Use Sub-Diagrams?

A clear and understandable model never includes everything in a single diagram. Instead, ideas are divided into multiple layers which commonly known as the abstraction layers. Take use case as an example. A simple ellipse shape cannot represents every details related to a use case. Such as you cannot see how users interact with the target system and the underlying business logic through ellipse. Therefore, you have to use a separate diagram to elaborate those details.

Compatible edition(s): Enterprise, Professional, Standard, Modeler

  • August 04, 2014
  • Views: 57,168
  • PDF
  • Video

00 intro

However, creating separate diagrams lead to the problem of project organization, i.e. how you can keep the model element and its associated diagrams together. In Visual Paradigm, you can achieve this by using sub-diagrams. In this tutorial, you will learn how to elaborate the details of a model element by using sub-diagrams, how to navigate between parent models and sub-diagrams and also some typical usages of sub-diagrams.

Creating sub-diagram

A sub-diagram can be created easily via the resource-centric interface. To create a sub-diagram:

  1. Click on the model element to bring up the resource-centric interface.
    01 select model
  2. Click on the Sub Diagrams resource icon at the bottom right corner of the model element.
    02 sub diagram resource
  3. Select New Diagram... from the popup menu.
    03 sub diagram popup
  4. Select the type of diagram that you would like to create and click Next. Specify its name and description (optional) and click OK.
    04 create new diagram
  5. Click OK to confirm. Now, a brand new diagram is created as the sub-diagram of your selected model element.

Add an existing diagram as a sub-diagram

Besides creating a new diagram as a sub-diagram, you can also use an existing diagram as a sub-diagram.

  1. Click on the Sub Diagrams resource icon again. But this time select Existing Diagrams...
    05 add existing diagram
  2. Choose the target diagram(s) in the Add Sub Diagrams window.
    06 select diagram
  3. You can browse the diagram based on the diagram category or based on the model hierarchy.
  4. Once you have picked the diagram, then press OK to confirm. After that, the selected diagram(s) will become sub-diagram(s) of your selected model element.

Navigation between a model element and its sub-diagrams

You can easily navigate between a model element and its sub-diagrams. To do this:

  1. Click on the Sub Diagrams resource icon.
  2. Select the target diagram from the popup menu. A preview of the target diagram will be shown next to the popup menu.
    07 open sub diagram from popup
  3. Click on the target diagram to jump into it.

If the model element has a large number of sub-diagrams:

  1. Select More... from popup menu.
    08 open more
  2. Select to bring up the Open Sub Diagram pane.
    09 open more dialog
  3. Select the diagram from the list. You can use the filter to find out the diagram you need.
    10 search sub diagram
  4. Double click on the diagram name to open it.

From the sub-diagram, you can navigate back to the parent model element by clicking on the link in the breadcrumb on top of the diagram.

Knowing which model element has sub-diagram(s)

You can easily remember which element possesses sub-diagram(s) when your project size is simple and small. However, when it becomes larger, it will become a difficult task to walk through each model element to see whether it contains sub-diagrams or not. To overcome this problem, you can turn on Model Indicator by selecting View > Model Indicator from the application toolbar.

By turning on the Model Indicator, the sub-diagram resource icons will be shown as long as the model element contains sub-diagram(s) even you are not selecting it. This helps you to identify the model element which has sub-diagram(s).


13 show indicator result

Sub-diagram and model structure

When creating a sub-diagram or associating an existing diagram as a sub-diagram, the diagram itself and its containing Master View elements will become the children of the selected model element. Thus, the model structure would be changed when you create sub-diagrams.

Typical usage of a sub-diagram

The major usage of a sub-diagram is to elaborate the details of a particular element. Below are some typical usages where the sub-diagrams are helpful.

Elaborate a use case using UML Activity Diagram and Sequence Diagram

A use case is used to model the goal which user wants to achieve when using the system. However, use case itself does not involve any detail about how to achieve this goal. Instead, it contains various scenarios and each scenario becomes a possible execution path in the system.

In order to model the detail interactions between users and the system or even between different models of the system in each execution path, we can use UML Sequence Diagram. Furthermore, we can also use Activity Diagram to model the overall flow logic of the use case.


15 elaborate use case

Elaborate the internal stage change of a class

While classes are the basic construct for building a system, class model focus on the static structure of the system. We can make use of the State Machine Diagram to model the internal state change of a class against the external events in a runtime. This helps us to understand the dynamic behavior of a class.


16 elaborate class

Elaborate BPMN activity with sub-process diagram

The sub-process in a standard BPMN notation provides abstraction for internal details by creating sub-process diagram(s) for elaboration.


17 elaborate sub process

Watch this Tutorial on YouTube

Here is the video version of this tutorial.



Turn every software project into a successful one.

We use cookies to offer you a better experience. By visiting our website, you agree to the use of cookies as described in our Cookie Policy.

OK