ArchiMate + PlantUML = Sequence Diagram Joy

I’ve always had a love of sequence diagrams, for those that don’t know what a sequence diagram is, this may not be the blog for you!  Sequence diagrams have always struck me as one of the more useful, and practical design documents to use to describe how a system works.

ArchiMate, of course, works on a slightly larger level, but I think great things can happen when you combine the two, and have used many diagrams to help describe some of the more intricate detail within an architecture.

There are many tools which can be used to create sequence diagrams, but, as I am a nerd, and enjoy over-complicating things, PlantUML floats my boat in many ways, mainly because it still feels like a fun techie tool (and works well with Markdown too!).

PlantUML is a tool which allows you to quickly create UML diagrams based on a (fairly) simple text syntax.  It supports many types of diagram, including Sequence Diagrams and basic ArchiMate.  As PlantUML supports both of these diagrams, I have written a support library which can be included in any PlantUML diagram to define each of the ArchiMate concepts and include them within a sequence diagram.

Example Diagram Source

@startuml Archi Usage
!include archiseq.puml
title Archi Print Usage
' Define Elements
$businessActor("Architect","architect")
$applicationComponent("Archi","archi")
$applicationFunction("Update\nModel","update")
$applicationFunction("Print\nView","print")
$systemSoftware("Windows\nPrint\nService","windowsPrint")
$equipment("Printer", "printer")
' Define Sequence
architect->archi ++
archi->update ++ : Make changes
$document("Not exactly correct!\nBut you get the idea.","right","update")
return Updated Model
archi ->print ++ : Click print
print -\windowsPrint ++
print –> archi : Sent to printer
windowsPrint -> printer ++
return Complete
archi –> architect
@enduml
view raw archi-example.puml hosted with ❤ by GitHub

Support Library

@startuml Common
' PlantUML ArchiMate Sequence Diagram template v4
' Changelog:
' v3 Updated for new PreProcessor
' v4 Function to Procedure
' Author: Steven Mileham (steven.mileham@gmail.com)
skinparam dpi 150
skinparam shadowing false
skinparam BoxPadding 10
skinparam defaultFontName "Roboto"
skinparam participantBorderColor black
skinparam noteBorderColor black
skinparam sequence {
ArrowColor black
LifeLineBorderColor DimGray
LifeLineBackgroundColor LightGray
BoxBorderColor Gray
BoxBackgroundColor #f2f2f2
}
skinparam participant<<Business>> {
BorderColor #GoldenRod
BackgroundColor #Business
}
skinparam participant<<Application>> {
BorderColor #LightSteelBlue
BackgroundColor #Application
}
skinparam participant<<Technology>> {
BorderColor #LimeGreen
BackgroundColor #Technology
}
skinparam participant<<Physical>> {
BorderColor #LimeGreen
BackgroundColor #Technology
}
skinparam participant<<Motivation>>{
BorderColor #Purple
BackgroundColor #Motivation
DiagonalCorner 10
}
' Archimate Components
' Generic
!procedure $element($layer,$type,$label,$name="")
!if ($name=="")
participant "<$archimate/$type>\r $label" as $label << $layer >>
!else
participant "<$archimate/$type>\r $label" as $name << $layer >>
!endif
!endprocedure
' Motivation
!procedure $driver($label,$name="")
$element("Motivation", "driver", $label, $name)
!endprocedure
!procedure $assessment($label,$name="")
$element("Motivation", "assessment", $label, $name)
!endprocedure
!procedure $goal($label,$name="")
$element("Motivation", "goal", $label, $name)
!endprocedure
!procedure $outcome($label,$name="")
$element("Motivation", "motivation-outcome", $label, $name)
!endprocedure
!procedure $principle($label,$name="")
$element("Motivation", "principle", $label, $name)
!procedure $requirement($label,$name="")
$element("Motivation", "requirement", $label, $name)
!procedure $constraint($label,$name="")
$element("Motivation", "constraint", $label, $name)
!procedure $value($label,$name="")
$element("Motivation", "value", $label, $name)
!procedure $meaning($label,$name="")
$element("Motivation", "meaning", $label, $name)
!procedure $stakeholder($label,$name="")
$element("Motivation", "role", $label, $name)
' Business
!procedure $businessActor($label,$name="")
$element("Business", "actor", $label, $name)
!endprocedure
!procedure $businessCollaboration($label,$name="")
$element("Business", "collaboration", $label, $name)
!endprocedure
!procedure $businessEvent($label,$name="")
$element("Business", "event", $label, $name)
!endprocedure
!procedure $businessInteraction($label,$name="")
$element("Business","interaction", $label, $name)
!endprocedure
!procedure $businessInterface($label,$name="")
$element("Business","interface", $label, $name)
!endprocedure
!procedure $businessObject($label,$name="")
$element("Business","object", $label, $name)
!endprocedure
!procedure $businessProcess($label,$name="")
$element("Business","process", $label, $name)
!endprocedure
!procedure $businessRole($label,$name="")
$element("Business","role", $label, $name)
!endprocedure
!procedure $businessService($label,$name="")
$element("Business","service", $label, $name)
!endprocedure
!procedure $contract($label,$name="")
$element("Business","contract", $label, $name)
!endprocedure
!procedure $product($label,$name="")
$element("Business","product", $label, $name)
!endprocedure
!procedure $representation($label,$name="")
$element("Business","representation", $label, $name)
!endprocedure
' Application
!procedure $applicationCollaboration($label,$name="")
$element("Application","collaboration", $label, $name)
!endprocedure
!procedure $applicationComponent($label,$name="")
$element("Application","component", $label, $name)
!endprocedure
!procedure $applicationEvent($label,$name="")
$element("Application","event", $label, $name)
!endprocedure
!procedure $applicationFunction($label,$name="")
$element("Application","function", $label, $name)
!endprocedure
!procedure $applicationInteraction($label,$name="")
$element("Application","interaction", $label, $name)
!endprocedure
!procedure $applicationInterface($label,$name="")
$element("Application","interface", $label, $name)
!endprocedure
!procedure $applicationProcess($label,$name="")
$element("Application","process", $label, $name)
!endprocedure
!procedure $applicationService($label,$name="")
$element("Application","service", $label, $name)
!endprocedure
!procedure $dataObject($label,$name="")
$element("Application","object", $label, $name)
!endprocedure
' Technology
!procedure $artifact($label,$name="")
$element("Technology","technology-artifact", $label, $name)
!endprocedure
!procedure $communicationNetwork($label,$name="")
$element("Technology","network", $label, $name)
!endprocedure
!procedure $device($label,$name="")
$element("Technology","device", $label, $name)
!endprocedure
!procedure $node($label,$name="")
$element("Technology","node", $label, $name)
!endprocedure
!procedure $path($label,$name="")
$element("Technology","technology-communication-path", $label, $name)
!endprocedure
!procedure $systemSoftware($label,$name="")
$element("Technology","system-software", $label, $name)
!endprocedure
!procedure $technologyCollaboration($label,$name="")
$element("Technology","collaboration", $label, $name)
!endprocedure
!procedure $technologyEvent($label,$name="")
$element("Technology","event", $label, $name)
!endprocedure
!procedure $technologyFunction($label,$name="")
$element("Technology","function", $label, $name)
!endprocedure
!procedure $technologyInteraction($label,$name="")
$element("Technology","interaction", $label, $name)
!endprocedure
!procedure $technologyInterface($label,$name="")
$element("Technology","interface", $label, $name)
!endprocedure
!procedure $technologyProcess($label,$name="")
$element("Technology","process", $label, $name)
!endprocedure
!procedure $technologyService($label,$name="")
$element("Technology","service", $label, $name)
!endprocedure
' Physical
!procedure $distributionNetwork($label,$name="")
$element("Physical","physical-distribution-network", $label, $name)
!endprocedure
!procedure $equipment($label,$name="")
$element("Physical","physical-equipment", $label, $name)
!endprocedure
!procedure $facility($label,$name="")
$element("Physical","physical-facility", $label, $name)
!endprocedure
!procedure $material($label,$name="")
$element("Physical","physical-material", $label, $name)
!endprocedure
' Notes
!procedure $assume($text, $placement = "left", $component = "")
hnote $placement $component #FFAAAA: <&warning> $text
!endprocedure
!procedure $document($text, $placement = "left", $component = "")
note $placement $component #FFFFA5: <&document> $text
!endprocedure
!procedure $question($text, $placement = "left", $component = "")
rnote $placement $component #FFBF00: <&questionmark> $text
!endprocedure
!procedure $schedule($text, $placement = "left", $component = "")
rnote $placement $component #98FB98: <&timer> $text
!endprocedure
!procedure $change($text, $placement = "left", $component = "")
rnote $placement $component #FFBF00: <&circlecheck> $text
!endprocedure
!procedure $reuse($text, $placement = "left", $component = "")
rnote $placement $component #98FB98: <&circlecheck> $text
!endprocedure
!procedure $error($text, $placement = "left", $component = "")
rnote $placement $component #FFCCCB: <&bug> $text
!endprocedure
hide stereotype
footer Generated on %date()
@enduml
view raw archi-seq.puml hosted with ❤ by GitHub

Next steps… figure out how I can write a jArchi script to write my PlantUML for me!

3 comments

  1. Hi,

    I also often use PlantUML and find it useful to work directly from Archi and don’t rely on a browser. For this purpose, I have a really small script containing only: Browser.open(“https://www.planttext.com/”, “PlantUML”)

    This opens a new tab in Archi with PlantText. Once you’ve created your sequence diagram, you can simply drag’n drop it to another tab containing a canvas and the image will be created in it.

    Like

  2. Hi! This looks really amazing and I want to use it!
    Two questions:
    1) How are the archimate symbols rendered? From an image file or from code?
    2) Does this require me to download PlantUML and run it locally? I am currently writing PlantUML straight into a macro in Confluence on web. Is it possible to include the support library in the same “file” as where the actual diagram is defined?

    Like

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.