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

Support Library

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


  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:“”, “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.


  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?


Leave a Reply

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

You are commenting using your 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.