Utilities add-in for Sparx Systems Enterprise Architect

Diagram Breadcrumb Trail: help section

Diagram Breadcrumb Trail: help section

eaUtils Breadcrumb Trail feature generates diagram hyperlinks to navigate back to linking diagrams. A linking diagram has at least one composite element that opens the current diagram. A composite element can be a business process, activity, use case, class, SysML block, etc.

Caution - important! this feature runs on the selected diagram from the Project Browser, hence a right click > eaUtils > Generate Breadcrumb trail in a displayed diagram will not act on this diagram if it is not selected in the project browser. Prior to run this feature, use a right click in the diagram > select Find in Project Browser so the diagram is selected in the browser.

Important - this feature can create hyperlinks objects on the diagram.

Generate hyperlinks with eaUtils diagram breadcrumb trail

The following example illustrates links between BPMN2 diagrams:

  • Diagrams 1, 2, and 3 contain the ActivityA subprocess. In EA, a double click onto any ActivityA opens the same diagram (see diagram Activity A with a red border).
  • Diagram 2 contains the ActivityB subprocess, linking to Diagram 3.

When using EA or a web browser with an HTML model export, it can be useful to have hyperlinks to navigate from Activity A or B diagram to a linking diagram. By default, this requires a manual update in each diagram, involving looking up the diagram to create suitable hyperlinks for.

eaUtils breadcrumb trail feature automatically generates an hyperlink that navigates back to a linking diagram. It can be run anytime on the diagram to update with the latest set of hyperlinks. This article describes this process.


Important: running eaUtils features are based on the selected diagram in the Project Browser, not the displayed/active diagram.

eautils sparx ea addin breadcrumb selected diagram project browser

Prior to run eaUtils Breadcrumb, it is crucial to make sure that the active diagram is selected from the Project Browser. To select the active diagram in EA Project Browser, right click in the diagram > Find in Project Browser, or use the keyboard shortcut Maj + Alt + G.

eautils sparx ea addin breadcrumb selected diagram project browser

Having the active diagram selected from the Project Browser, and having saved your diagram, right click on the diagram and select Extensions > eaUtils > Generate diagram breadcrumb trail as shown below: (if the list of features is different, you haven't selected a diagram)

Alternatively, and as a better practice, run this feature from the Project Browser via a right click on the diagram > Extensions > eaUtils > Generate diagram breadcrumb trail.

Confirm from the following dialog box if you would like to go ahead.

eautils sparx EA addin project browser generate diagram breadcrumb trail confirm window

Having run eaUtils Breadcrumb trail from the Activity A diagram, the following confirmation window is displayed:

Activity A BPMN diagram has been updated with new hyperlinks as shown below. Hyperlinks can be moved to a suitable location.

Running the Breadcrumb Trail feature leads to the following dialog box:


Last modified on Saturday, 27 February 2016 15:49