Reuse of sequence diagram parts

Question

I have multiple single sequence diagrams. most of them have the same initialization and termination sequence.

It is possible to copy this from one file to the other but it would be much better if this part could be declared at a single point. So in case of a change it would not be necessary to change all the diagrams.

Is there a way to do this ?

score 3 · Accepted Answer · answered Jan 24 '18 at 19:42

I tried to comment to JRI's answer but I don't have a high enough reputation.

I found that !include works until you need to include the same file multiple times. I got a solution on a plantuml forum and I can't remember the forum but I do remember the solution. On the second and each additional time you include a file you want to use !include_many.

score 2 · Answer 2 · answered Nov 02 '18 at 12:02

2

@user349062 comment is the correct answer. This was not easy to find, and its not in the documentation: Reference Guide

Using !include_many instead of !include in subsequent pages works, which doesn't make much sense, but there you go.

answered Nov 02 '18 at 12:02

HAT

331
3
8

score 1 · Answer 3 · answered Apr 14 '17 at 23:04

1

Yes, you should use a reference fragment to reference the separate initialization / termination sequences:

@startuml
participant Alice
participant Bob
ref over Alice, Bob : initialization
Alice -> Bob : hello
ref over Alice, Bob : termination
@enduml

answered Apr 14 '17 at 23:04

Staffan Persson

151
1
5

How to use ref over in activity-diagram ? – BuffK Sep 02 '23 at 10:29

score 1 · Answer 4 · answered Jun 23 '17 at 17:19

If you want to show the detail of the re-used parts, rather than abstract them away as a reference block, PlantUML allows you to include files using the !include or !includeurl directives.

The syntax also allows you to import particular blocks of code from an imported file. See http://plantuml.com/preprocessing for details.

Reuse of sequence diagram parts

4 Answers4