Jump to Menu

How to Merge Actors in Use Case Diagram?

Sometimes we accidentally make duplicate master model elements. For example, we meant to have one actor named manager. But inadvertently we ended up with two that are identically named. Perhaps you might have created one from a use case diagram and another in a different use case diagram.

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

  • December 15, 2011
  • Views: 43,295
  • PDF

To fix it, we could merge the duplications into a single existing master actor. This tutorial will show you how.

Note: The example below is demonstrated using Visual Paradigm.

Background Information

Let's just say that we are going to begin with a project file that contains 2 use case diagrams, System Admin and Order Processing. Between them, there are 2 actors both named Manager. And we will merge one into another to remove duplicates.


an example of duplicate actors Download sample project

More specifically we want to keep the actor (in the Order Processing diagram) as a master model element and make the other one (in the System Admin diagram) a copy of that.


we want to make this a master actor
we want to make this an auxiliary actor

Steps to merge actors

  1. We'll begin with the actor from which we want to make an auxiliary actor. In the System Admin use case diagram, right-click on the actor named Manager and select Related Elements > Merge to Model Element...
    right click to open the Merge dialog box
  2. In the dialog box opened, we are going to select the actor (which will become the master model element) for the currently selected actor (which will become the auxiliary model element) to merge into.
    Merge to Model Element dialog box
    Tips: In case the target list is very long, you may want to apply filter to make it shorter.
    apply filter to make the target list shorter
  3. Select the master model element. Click Merge.
    select the master model element and click Merge
  4. When prompted, click Yes to confirm the merge. Then you are done.
    confirm to proceed with the merge

What will you see after the merge?

There are a few things that you might want to take notice of after the merge. They are:

  1. You'll see the letter 'a' if you place your mouse over or select an auxiliary model element.
    symbol found in an auxiliary model element
  2. You'll see the letter 'M' if you place your mouse over or select a master model element.
    symbol found in a master model element
  3. If you go to the Model Explorer, you'll see that the duplicate actor "Manager" having been removed after the merge.
    duplicate actor (Manager) removed in Model Explorer

What does it mean when you are an auxiliary model element?

If you change the name of an auxiliary model element (e.g. from "Manager" to "Sales Manager"), you are actually updating the master model element too or vice versa.

The master model element controls the placement. For example, if you drag a master model element (e.g. actor) into a package on a diagram, you will see it in the Model Explorer under the package. But if you drag an auxiliary into a package instead, the model element won't be placed under the package.


moving a master model element into a package
moving an auxiliary model element into a package

The master model element controls the 'life' of a model element. When you delete a master model element, you will be asked to confirm the deletion. If you delete an auxiliary, you won't be prompted.



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