Plantuml

Outline

• Plantuml What is it?
• Plantuml When do you need it?
• Plantuml How to use it online?
• Plantuml How to use it offline?

Plantuml

Outline

• Plantuml Integrations with other tools
  • Plantuml How to integrate with Doxygen?
  • Plantuml How to integrate with Eclipse?
  • Plantuml How to integrate with Visual Studio Code?
  • Plantuml How to integrate with Visual Studio?
  • and More ...

Plantuml

Outline

• Plantuml UML Diagrams
  • Sequence diagram
  • Usecase diagram
  • Class diagram
  • Object diagram
  • Activity diagram (here is the legacy syntax)
  • Component diagram
  • Deployment diagram
  • State diagram
  • Timing diagram

Plantuml

Outline

• Plantuml C4 Model Diagrams
  • Context Diagram
  • Container Diagram
  • Component Diagram
  • Class Diagram

Plantuml

Outline

• Plantuml None-UML Diagrams (1)
  • JSON data
  • YAML data
  • Network diagram (nwdiag)
  • Wireframe graphical interface or UI mockups (salt)
  • Archimate diagram
  • Specification and Description Language (SDL)

Plantuml

Outline

• Plantuml None-UML Diagrams (2)
  • Ditaa diagram
  • Gantt diagram
  • MindMap diagram
  • Work Breakdown Structure diagram (WBS)
  • Mathematic with AsciiMath or JLaTeXMath notation
  • Entity Relationship diagram (IE/ER)

Plantuml

Outline

• PlantUML Preprocessing

Plantuml

Outline

• Plantuml Icon Diagrams Support
  • PlantUML Stdlib
• Calling PlantUML from Java
  • PlantUML Java API

Plantuml What is it?

Plantuml What is it?

• PlantUML is an open-source tool allowing users to create diagrams from a plain text language, based on UML

• 22 April, 2009: First public release.

• Webpage PlantUML

• Wiki PlantUML

• Github PlantUML

Plantuml What is it?

• Besides various UML diagrams, PlantUML has support for various other software development related formats such as

  • Archimate,
  • Block diagram,
  • BPMN,
  • C4,
  • Computer network diagram,
  • ERD,
  • Gantt chart,
  • Mind map,
  • and WBD,
  • as well as visualisation of JSON and YAML files.

  Details in Next Slides...

Plantuml What is it?

Demo Link

PlantUML Web Server

Plantuml What is it?

Demo Link

PlantUML Web Server

Plantuml What is it?

PlantUML Status

Plantuml What is it?

PlantUML Status

Plantuml What is it?

PlantUML Status

Plantuml What is it?

PlantUML Status

This badges are generated via

https://shields.io/

Plantuml What is it?

• Diagram As Code

  • Diagrams are defined using a simple and intuitive language. (see PlantUML Language Reference Guide).

• Easy to use

  • New users can read the quick start page. There is also a F.A.Q. page.

• Easy to integrate

  • PlantUML can be used within many other tools.

• Several outputs

  • Images can be generated in PNG, in SVG or in LaTeX format.
  • It is also possible to generate ASCII art diagrams (only for sequence diagrams).

Plantuml What is it?

PlantUML is a component that allows to quickly write:

• Sequence diagram
• Usecase diagram
• Class diagram
• Object diagram
• Activity diagram (here is the legacy syntax)
• Component diagram
• Deployment diagram
• State diagram
• Timing diagram

Plantuml What is it?

The following non-UML diagrams are also supported:

• JSON data
• YAML data
• Network diagram (nwdiag)
• Wireframe graphical interface or UI mockups (salt)
• Archimate diagram
• Specification and Description Language (SDL)
• Ditaa diagram
• Gantt diagram
• MindMap diagram
• Work Breakdown Structure diagram (WBS)
• Mathematic with AsciiMath or JLaTeXMath notation
• Entity Relationship diagram (IE/ER)

Plantuml What is it?

Furthermore:

• Hyperlinks and tooltips
• Creole: rich text, emoticons, unicode, icons
• OpenIconic icons
• Sprite icons
• AsciiMath mathematical expressions

Plantuml When do you need it?

Plantuml When do you need it?

• Integrate application source code with its UML design
• Do not worry about visual design
• If you need something platform independent and portable
• If you need something that has lightweight diagramming features.
• If you do not want to pay for licences.
• If you do not need to install applications.
• If you need fast operations for diagraming models that you need to generate and share with others.

Plantuml When do you need it?

• There are many applications that use PlantUML.
• There are many examples of PlantUML diagrams.maybe you can find your solutions. Do not forget to check the examples.

Before Start Lets Download & Install PlantUML

Download & Installation Options for Offline Usage

• Download from Direct Site and Use As *.jar File
• Install via Choco and use with Command Line

Option-1 : Download Jar File and PDF Guide

• Visit Download page

• Download Latest Version Always with GraphViz Support

  • PlantUML compiled Jar (Version 1.2022.4)
    • From GitHub releases, you can download plantuml.1.2022.4.jar
    • Version without embedded GraphViz: plantuml-nodot.1.2022.4.jar

• PlantUML Language Reference Guide

  •     English      Deutsch      Español      Français      日本語      한국어      Русский      中文

Option-2 : Install via Choco and use with Command Line

• Choco install
  • For windows users, majkinetor introduced a way to install plantuml and its dependencies easily. Run cmd.exe as Administrator, and run two commands as follows (the first command is not needed and will fail if you already have chocolatey installed).

• If you've installed java, but still prompts "java not installed", please add java bin path to PATH environment variable.

Always Test Installation and Its Version

Plantuml How to use it online?

Plantuml How to use it online?

• From PlantUML Web Page Select "Online Server"
• Default Online Server Link
  • https://www.plantuml.com/plantuml/uml/SyfFKj2rKt3CoKnELR1Io4ZDoSa70000
    

Plantuml How to use it online?

Plantuml How to use it online?

• You can download get shareable PNG, SVG links from server

• You can access directly UML diagram via browser
• You can parse links from server to get editable diagram
• You can try several built-in themes
• You can seperate diagram window from code window to make easier to edit diagram

Plantuml How to use it online?

• Everything stored on link, example

• Request URL

Plantuml How to use it online?

• Server Base URL

• Encoded PlantUML Script

Plantuml How to use it online?

• If you plantuml text-encoding features https://plantuml.com/text-encoding
• They use
  • https://en.wikipedia.org/wiki/Deflate (LZ77 + Huffman)
  • https://en.wikipedia.org/wiki/Brotli (LZ77)

Plantuml How to use it online?

Plantuml.jar Console-Command

You can use -encodeurl or -decodeurl in the command line flags to encode or decode the text.

• https://www.plantuml.com/plantuml/uml/SyfFKj2rKt3CoKnELR1Io4ZDoSa70000

Plantuml How to use it online?

You will find here some implementation of this encoder:

• Code in PHP
• Code in Javascript
• Code in Python
• Code in Swift

Plantuml How to use it online?

Javascript Encoder & Decoder Library

• You can use following libraries to encode/decode URLs with you app.
  • https://github.com/markushedvall/plantuml-encoder
  • https://www.npmjs.com/package/plantuml-encoder-decoder

Plantuml How to use it online?

Javascript Encoder Example

Plantuml How to use it online?

Javascript Decoder Example

Plantuml How to use it online?

Simple HEX format

• If you find Deflate and Brotli too complex, you can try the HEX format. In that case, you just have to encode each character in hexadecimal format.

• For example :

• will be turned into:

• To indicate the use of HEX format, you must add ~h at the start of the data sent to PlantUML server.

  • http://www.plantuml.com/plantuml/uml/~h4073...

• Since there is no compression here, the URL will become very long as the diagram grows.

Plantuml How to use it online?

PNG service

To get a PNG file of a diagram, use the following URL scheme: /plantuml/png/ENCODED

Plantuml How to use it online?

SVG service

To get a SVG XML file of a diagram, use the following URL scheme: /plantuml/svg/ENCODED

Note that not all diagrams can be produced in SVG. For example, ditaa diagrams are only available in PNG format.

Plantuml How to use it online?

ASCII Art Service

To get an ASCII Art representation of a diagram, encoded in UTF-8, use the following URL scheme: /plantuml/txt/ENCODED

Note that only sequence diagrams can be produced in ASCII Art.

Plantuml How to use it online?

Image Map service

To get the client image map related to a previously generated PNG image, use the following URL scheme: /plantuml/map/ENCODED

Plantuml How to use it online?

Image Map service

The output is a list of <area> tags, each line matching a link present in the diagram description.

For example, the following diagram:

produces the following output:

Plantuml How to use it online?

Note that you need to include these <area... tags inside a <map... html tag to make the complete image map.

Plantuml How to use it online?

Proxy Service

With the proxy service, the source description of the diagram can be fetched by the PlantUML Server from a remote document.

The proxy service uses the following URL scheme: /plantuml/proxy?src=RESOURCE&idx=INDEX&fmt=FORMAT

• RESOURCE is the complete URL of the document which contains the diagram description (with the @startxxx and @endxxx tags), it could be a .html or a .txt file.
• INDEX is optional, it specifies the occurrence (starting at 0) of the diagram description that will be parsed when there are more than one diagram descriptions in the remote document. It defaults to zero.
• FORMAT is optional, it specifies the format to return. Supported values are: png, svg, eps, epstext and txt. Default is png,

Plantuml How to use it online?

Proxy Service

For example, try this link: http://www.plantuml.com/plantuml/proxy?src=https://raw.github.com/plantuml/plantuml-server/master/src/main/webapp/resource/test2diagrams.txt

Note that the address of the remote document is specified as a parameter, so it is not necessary to URL encode the URL.

Plantuml How to use it online?

• Checkout Integrations
  • https://plantuml.com/running
    • Wikis and Forums
    • Text editors and IDE
    • Programming language
    • Generated Documentation
    • Online Editors
    • Other services

Plantuml How to use it offline?

Plantuml How to use it offline?

PlantUML PicoWeb Server

• https://plantuml.com/picoweb

• Many plugins take advantage of the online web server to generate images.

• For some reasons (security, performance...) you may need to use your own local server instead. This is possible thanks to the PlantUML Server which is available here.

• However, installing and configuring a full webserver may be too complex for some users so we have decided to integrate a tiny webserver inside plantuml.jar.

• This means that you only need a Java Runtime Environment and plantuml.jar to run this very simple web server.

Plantuml How to use it offline?

PlantUML PicoWeb Server

• https://plantuml.com/picoweb
• Running the server
  • Running the server is pretty simple. You just have to launch:

• Attention: By default, the server listens on all interfaces on port 8080.

• To change the default behavior, you can specify a colon separated port (still listening on all interfaces) or, both, a port and a bind address:

Plantuml How to use it offline?

PlantUML PicoWeb Server

• https://plantuml.com/picoweb
• Running the server
  • The server is really basic. It only understands GET requests with following patterns:

• The server will return a PNG or SVG image.
• The server will return a 404 error if the request is not understood.
• The server will return a 500 error if the image cannot be generated.

Plantuml How to use it offline?

PlantUML PicoWeb Server

• Those GET requests are used by various PlantUML plugins. Once you have launched your server, you can simply test it. With any web browser, you just have to point to: http://127.0.0.1:8080.
• This way, you can very easily use any plugins which need some PlantUML HTTP server without the official online server.

Plantuml How to use it offline?

PlantUML Server

• You can use PlantUML using the online web service to generate images on-the-fly. A online demonstration is available at http://www.plantuml.com/plantuml, but you can also install it on your own JEE web application server.

• Full featured server is available here:

  • https://plantuml.com/server

Plantuml How to use it offline?

PlantUML Server

• To install PlantUML Server on your own JEE 5 web server,
  • download the plantuml.war file and copy it on the webapp folder of your server.
• Because of the transition from javax.* to jakarta.*, the PlantUML Server does not work on Tomcat 6/7/8/9 anymore. You have to use Tomcat 10.

Plantuml How to use it offline?

• Download and install Java Runtime Environment (JRE) or Java Development Kit (JDK) with JRE.

• Download jar file from https://plantuml.com/download

• Select Latest version plantuml.jar with graphviz support.

• Prepare a batch file to launch on your computer as follow in the same folder with plantuml.jar

• for PNG image output run run_plantuml_for_png_export.bat

• for SVG output run run_plantuml_for_svg_export.bat

• This scripts are look for folders and find *.puml files and generate PNG or SVG images.

Plantuml How to use it offline?

• Other options

The most basic way to run it is:

This will look for @startXYZ into file1, file2 and file3. For each diagram, a .png file will be created.

Plantuml How to use it offline?

For processing a whole directory, you can use:

This command will search for @startXYZ and @endXYZ into .txt, .tex, .java, .htm, .html, .c, .h, .cpp, .apt, .pu, .puml, .hpp, .hh or .md files of the c:/directory1 and c:/directory2 directories.

Plantuml How to use it offline?

Configuration File

• You can also provide a configuration file which will be included before each diagram:

Plantuml How to use it offline?

Configuration File

• Suppose you have the two following files:

test1.txt:

config.txt:

• If you launch the following command:

• File config.txt is automatically included at the very beginning of the diagram.

Plantuml How to use it offline?

Metadata

• PlantUML saves the diagram's source code in the generated PNG Metadata in the form of encoded text.

• So it is possible to retrieve this source by using the query parameter metadata, giving it some image URL.

• For example, if you want to retrieve the diagram source of the image http://i.stack.imgur.com/HJvKF.png use the following server request:

  • http://www.plantuml.com/plantuml/?metadata=http://i.stack.imgur.com/HJvKF.png.

• Sounds like magic! No, merely clever engineering :-)

Plantuml How to use it offline?

Metadata

After all preprocessing (includes etc), PlantUML saves the diagram's source code in the generated PNG Metadata in the form of encoded text.

• If you does not want plantuml to save the diagram's source code in the generated PNG Metadata, you can during generation use the option -nometadata to disable this functionality (To NOT export metadata in PNG/SVG generated files).
• It is possible to retrieve this source with the -metadata option. This means that the PNG is almost "editable": you can post it on a corporate wiki where you cannot install plugins, and someone in the future can update the diagram by getting the metadata, editing and re-uploading again. Also, the diagram is stand-alone.

Plantuml How to use it offline?

Metadata

• Conversely, the -checkmetadata option checks whether the target PNG has the same source and if there are no changes, doesn't regenerate the PNG, thus saving all processing time. This allows you to run PlantUML on a whole folder (or tree with the -recursive option) incrementally.

Sounds like magic! No, merely clever engineering :-)

Example:

Unfortunately this option works only with local files. It doesn't work with -pipe so you cannot fetch a URL with eg curl and feed the PNG to PlantUML.

However, the Plantuml server has a similar feature, where it can get a PNG from a URL and extract its metadata.

Plantuml How to use it offline?

Command line

You can run PlantUML using the command line. (See running for ways to run PlantUML from various other tools and workflows).The most basic way to run it is:

This will look for @startXYZ into file1, file2 and file3. For each diagram, a .png file will be created.For processing a whole directory, you can use:

This command will search for @startXYZ and @endXYZ into .txt, .tex, .java, .htm, .html, .c, .h, .cpp, .apt, .pu, .puml, .hpp, .hh or .md files of the c:/directory1 and c:/directory2 directories.

Plantuml How to use it offline?

Wildcards

You can also use wildcards :

• For a single character, use ?
• For zero or more characters, use *
• For zero or more characters, (including / or \), use a double **

So to process any .cpp files in all directories starting by dummy :

And to process any .cpp files in all directories starting by dummy, and theirs subdirectories :

Plantuml How to use it offline?

Excluded files

You can exlude some files from the process using the -x option:

Plantuml How to use it offline?

Output Directory

You can specify an output directory for all images using the -o switch:

If you recurse into several directory, there is a slight difference if you provide an absolute or a relative path for this output directory:

• An absolute path will ensure that all images are output to a single, specific, directory.

• If you provide a relative path then the images is placed in that directory relative to the location of the input file, not the current directory (note: this applies even if the path begins with a .). When Plantuml processes files from multiple directores then the corresponding directory structure is created under the computed output directory.

Plantuml How to use it offline?

Types of Output File

Images for your diagrams can be exported in a variety of different formats. By default the format will be a PNG file but another type can be selected using the following extensions:

Example:

Plantuml How to use it offline?

Types of Output File

Plantuml How to use it offline?

Types of Output File

Plantuml How to use it offline?

Types of Output File

Plantuml How to use it offline?

Types of Output File

Plantuml How to use it offline?

Types of Output File

Plantuml How to use it offline?

Exit Code

• When there are some errors in diagrams the command returns an error (-1) exit code. But even if some diagrams contain some errors, all diagrams are generated, which can be time consuming for large project.

• You can use the -failfast flag to change this behavior to stop diagram generations as soon as one error occurs. In that case, some diagrams will be generated, and some will not.

• There is also a -failfast2 flag that does a first checking pass. If some error is present, no diagram will be generated at all. In case of error, -failfast2 runs even faster than -failfast, which may be useful for huge project.

Plantuml How to use it offline?

Standard report [stdrpt]

Using the -stdrpt (standard report) option, you can change the format of the error output of your PlantUML scripts.

With this option, a different error output of your diagram is possible:

• none: two lines
• -stdrpt: single line
• -stdrpt:1: verbose
• -stdrpt:2: single line

[Ref. Issue#155 and QA-11805]

Plantuml How to use it offline?

Standard report [stdrpt]

Examples, with the bad file file1.pu, where as is written aass:

Plantuml How to use it offline?

Standard report [stdrpt]

Without any option

The error output is:

Plantuml How to use it offline?

Standard report [stdrpt]

-stdrpt option

The error output is:

Plantuml How to use it offline?

Standard report [stdrpt]

-stdrpt:1 option

The error output is:

Plantuml How to use it offline?

Standard report [stdrpt]

-stdrpt:2 option (like -stdrpt)

The error output is:

Plantuml How to use it offline?

Command-Line Options and Help

You can have a help message by launching :

Plantuml How to use it offline?

Command-Line Options and Help

This will output:

Plantuml How to use it offline?

Command-Line Options and Help

Plantuml How to use it offline?

Command-Line Options and Help

Plantuml How to use it offline?

Command-Line Options and Help

Plantuml How to use it offline?

Command-Line Options and Help

Plantuml How to use it offline?

Command-Line Options and Help

Plantuml How to use it offline?

Command-Line Options and Help

Plantuml How to use it offline?

Command-Line Options and Help

• If needed, you can setup the environment variable GRAPHVIZ_DOT

Plantuml Integrations with other tools

Plantuml Integrations with other tools

• PlantUML is integrated in a variety of external tools. See command-line for options to run it from the command line.
  • Running PlantUML from Other Tools
  • Plugins for PlantUML

Plantuml Integrations with other tools

Wikis and Forums

Make PlantUML diagrams easily accessible from markdown, GitHub flavored

Marketplace on GitHub

GitLab or GitHub integration with Markdown

Integrate it with MoinMoin

Integrate it with WordPress

Integrate it with Discourse Forum

Plantuml Integrations with other tools

Wikis and Forums

Integrate it with NodeBB Forum

Integrate it with MediaWiki

Integrate it with Redmine

Integrate it with Confluence

Integrate it with Confluence Cloud

Integrate it with Trac

Plantuml Integrations with other tools

Wikis and Forums

Integrate it with DokuWiki (see Weatherwax issue solved)

Integrate it with XWiki

Integrate it with PmWiki

Integrate it with TiddlyWiki

Integrate it with Ikiwiki

Integrate it with Jekyll

Plantuml Integrations with other tools

Wikis and Forums

Integrate it with Publet

Integrate it with Zim

Integrate it with Fitnesse

Integrate it with Slack

Plantuml Integrations with other tools

Text editors and IDE

Render PlantUML Diagrams for QOwnNotes editor

Connecting Astah and PlantUML

Integrate it with TinyMCE Editor

Integrate it with CKeditor

Use the Eclipse Plugin

Use a NetBeans Plugin

Plantuml Integrations with other tools

Text editors and IDE

Use it with NetBeans

Use it with Intellij idea

Run it directly from Word

Use Gizmo to render PlantUML diagrams within Word

Run it directly from Open Office

Plantuml Integrations with other tools

Text editors and IDE

Run it from Emacs

Run it from Sublime Text Editor

Run it from VIM (And use F5 key, Syntax, or PaperColor)

Use it with LaTeX

Use it with mbeddr

Use it with GEdit

Plantuml Integrations with other tools

Text editors and IDE

Use it with Brackets

Use it with Atom

PlantUML language package for Atom

UDL for Notepad++ to support the PlantUML language syntax

Visual Studio Code plugin

Another Visual Studio Code plugin

Plantuml Integrations with other tools

Text editors and IDE

PlantUML syntax highlighter

Generates UML class diagrams from MATLAB m-code

Plantuml Integrations with other tools

Programming language

Use it with Markdown

Use it from HTML code with JQuery

JOII-based classes diagram generator

Call it from PHP

Call it from Java

Call it from Python

Plantuml Integrations with other tools

Programming language

Another python remote client interface

Integration with IPython

Python tools for PlantUML

Call it from Groovy

Use builder pattern with Groovy PlantUML builder

Use command line

Plantuml Integrations with other tools

Programming language

Write an ANT task

Use the Maven2 plugin

Use it with Gradle

Use it on Salesforce.com with Apex

A Leiningen plugin for generating UML diagrams using PlantUML

Emacs Lisp DSL for PlantUML

Generate PHP classes from your PlantUML diagram

Plantuml Integrations with other tools

Generated Documentation

Create logical and physical database diagrams and generate DDL files.

Helm chart for PlantUML.

Markdown extension for PlantUML and Nikola.

Renders PlantUML files from Nikola.

JSDoc plugin to use PlantUML inside javascript documentation.

Plantuml Integrations with other tools

Generated Documentation

Simple tool to turn a swagger api spec into a uml class diagram.

Convert OpenAPI specifications to PlantUML diagrams.

Generate UML Diagrams for Given Swagger Definition.

Use it with LyX.

Reverse Engineering with PlantUML Dependency

Plantuml Integrations with other tools

Generated Documentation

Use it with Almost Plain Text (APT) files

Generate diagrams with Javadoc

Generate diagrams with Javadoc and PlantUML Taglet

Use it with Doxygen

Integrate it with docutils

Use it with AsciiDoc

Plantuml Integrations with other tools

Generated Documentation

Use it with Asciidoctor

Generate UML description from Java sources using a doclet

Use it with Pegdown

Use enhanced Doclet

Generate UML from C# sources

Plantuml Integrations with other tools

Generated Documentation

Generate UML from Scaladoc

Integrate it with Sphinx

Generate PlantUML diagrams from SqlALchemy models

Generate PlantUML diagram for Lua with LDoc

Generate PlantUML diagrams from grails project sources

Create PlantUML class diagrams from your PHP source.

Plantuml Integrations with other tools

Generated Documentation

Integrate PlantUML with ROBODoc.

Integrate PlantUML with Pandoc.

Integrate PlantUML with Sbt, the interactive build tool.

Gulp plugin for automated generation of diagrams.

Node.Js module for processing PlantUML

Another Node.js module and CLI

Plantuml Integrations with other tools

Generated Documentation

Plugin for TypeDoc for TypeScript programs

Maven plugin to inspect at compile time

Show the recursive dependencies of a Helm Chart-

Plantuml Integrations with other tools

Online Editors

Create and update UML diagrams inside of Google Docs,

Use the online servlet, (Explanation here)

Codeuml - design UML diagrams as fast as you can code

PlantText UML Editor

Plantuml Integrations with other tools

Online Editors

Seeduml

EtherPlant on Etherpad

Emacs/vim online Editor

TexWriting online Editor

Plantuml Integrations with other tools

Other

Node.js CLI tool that allows for live-reloading and exporting PlantUML.

Embed PlantUml diagrams in PowerPoint presentations.

A Chrome / Firefox extension for visualizing PlantUML descriptions.

Use the Docker repository

PlantUML with GitLab.org / GitLab Community Edition

PlantUML with Github Gist and Gitlab Support

Plantuml Integrations with other tools

Other

A GitBucket plugin renders PlantUML sources

Auto generating UML diagrams from SAP/ABAP code

Puse editor

PlantUML Chrome extension

Cloud version with Renderist on herokuapp.com

PlantUML QEditor written in Qt4

Plantuml Integrations with other tools

Other

Sketchlet : a software designer's sketchbook

Double-click on the .jar to run it

PlantUML Editor: A fast and simple UML editor using WPF Dotnet

Install your own server

Use it with textcube

Gravizo.com

Plantuml Integrations with other tools

Plantuml How to integrate with Doxygen?

• Plantuml search for @startuml and @enduml tags in your source code and generate the diagram.
• You need to specify the output directory for the generated images in the Doxygen configuration file with the environment variable DOC_IMG_PATH_UML.
• First plantuml runs the source code through the PlantUML compiler and generates the images.
• Then doxygen runs the source code through the Doxygen preprocessor and generates the documentation.

Plantuml Integrations with other tools

Plantuml How to integrate with Doxygen?

• Folder structure should be as follow
  • app
    • src
      • main.cpp
    • doxygen
      • Resouces
      • DoxyFile
      • doxy_run.bat
      • plantuml.jar
• Example Application
  • https://github.com/ucoruh/ce103-hw2-template/tree/f3e17bc466b4b4db50625ab6c8aee884fbe4345f/doxygen

Plantuml Integrations with other tools

Plantuml How to integrate with Doxygen?

• Example Doxyfile
  • https://github.com/ucoruh/ce103-hw2-template/blob/f3e17bc466b4b4db50625ab6c8aee884fbe4345f/doxygen/Doxyfile

Plantuml Integrations with other tools

Plantuml How to integrate with Doxygen?

• Example Batch Script

IF NOT EXIST plantuml.jar (
curl -o plantuml.jar "https://github.com/plantuml/plantuml/releases/download/v1.2021.14/plantuml-1.2021.14.jar"
)

java -jar "plantuml.jar" -v "%DOCS_DIR%/.(puml)"
java -jar "plantuml.jar" -v -o "%DOC_IMG_PATH_UML%" "%SOURCE_DIR%/.(c|cpp|doc|h|cs)"
doxygen Doxyfile
pause

Plantuml Integrations with other tools

Plantuml How to integrate with Doxygen?

Plantuml Integrations with other tools

Plantuml How to integrate with Doxygen?

Built-in Feature

• https://www.doxygen.nl/manual/commands.html#cmdstartuml

\startuml ['{'option[,option]'}'] ["caption"] [=]

• Starts a text fragment which should contain a valid description of a PlantUML diagram.
  • See https://plantuml.com/ for examples. The text fragment ends with \enduml.

Plantuml Integrations with other tools

Plantuml How to integrate with Doxygen?

Built-in Feature

Note

• You need to install Java and the PlantUML's jar file, if you want to use this command. When using PlantUML in  you have to download some more jar files,
• for details see the PlantUML documentation. This also is valid for the <engine>s latex and math.
• The location of the PlantUML file should be specified using PLANTUML_JAR_PATH. The other jar files should also reside in this directory.

Plantuml Integrations with other tools

Plantuml How to integrate with Doxygen?

Built-in Feature

• The use of the <engine> ditaa is not possible in  as PlantUML only supports the png format and doxygen requires, temporary, eps output.

• Not all diagrams can be created with the PlantUML @startuml command but need another PlantUML @start... command.

• This will look like @start<engine> where currently supported are the following <engine>s: uml, bpm, wire, dot, ditaa, salt, math, latex, gantt, mindmap, wbs, yaml, creole, json, flow, board and git. By default the <engine> is uml. The <engine> can be specified as an option.

• Also the file to write the resulting image to can be specified by means of an option, see the description of the first (optional) argument for details. Of course only one <engine> can be specified and also the filename can only be specified once.

Plantuml Integrations with other tools

Plantuml How to integrate with Doxygen?

Built-in Feature

• The first argument is optional and is for compatibility with running PlantUML as a preprocessing step before running doxygen, you can also add the name of the image file after \startuml and inside curly brackets as option, i.e.

• When the name of the image is specified, doxygen will generate an image with that name. Without the name doxygen will choose a name automatically.

Plantuml Integrations with other tools

Plantuml How to integrate with Doxygen?

Built-in Feature

• The second argument is optional and can be used to specify the caption that is displayed below the image. This argument has to be specified between quotes even if it does not contain any spaces. The quotes are stripped before the caption is displayed.

• The third argument is also optional and can be used to specify the width or height of the image. For a description of the possibilities see the paragraph Size indication with the \image command.

Plantuml Integrations with other tools

Plantuml How to integrate with Doxygen?

Built-in Feature

Note

• doxygen creates a temporary file that is automatically removed unless the DOT_CLEANUP tag is set to NO.

Plantuml Integrations with other tools

Plantuml How to integrate with Doxygen?

Built-in Feature

Here is an example of the use of the \startuml command.

Plantuml Integrations with other tools

Plantuml How to integrate with Doxygen?

Built-in Feature

Plantuml Integrations with other tools

Plantuml How to integrate with Doxygen?

Built-in Feature

Plantuml Integrations with other tools

Plantuml How to integrate with Doxygen?

Built-in Feature

Plantuml Integrations with other tools

Plantuml How to integrate with Eclipse?

Information about the PlantUML Eclipse Plugin

• The Eclipse Plugin is developed and maintained by Hallvard Trætteberg (many thanks for his work!).

• Like the core library PlantUML itself, it is open source and the plugin is distributed under EPL license.

• The source code is hosted on GitHub.

Plantuml Integrations with other tools

Plantuml How to integrate with Eclipse?

How to use it?

• First, you have to display the PlantUML View (click the Window menu):

Plantuml Integrations with other tools

Plantuml How to integrate with Eclipse?

How to use it?

This view displays automatically the class you are working on:

Plantuml Integrations with other tools

Plantuml How to integrate with Eclipse?

How to use it?

If you write some comment in PlantUML language, the corresponding diagram is automatically displayed. And if you have several comments with diagrams, it selects the one the cursor is in.

Plantuml Integrations with other tools

Plantuml How to integrate with Eclipse?

How to use it?

In the Preferences Windows, you can also set up GraphViz path if needed:

Plantuml Integrations with other tools

Plantuml How to integrate with Eclipse?

How to install it?

To install the plugin, you have to:

• Go to Help/Software Update/Find and install... or Help/Install new software...
• Create (if needed) or choose the following site as update site: http://hallvard.github.io/plantuml/

Plantuml Integrations with other tools

Plantuml How to integrate with Eclipse?

How to install it?

• Add Repository http://hallvard.github.io/plantuml/ to Eclipse

  

Plantuml Integrations with other tools

Plantuml How to integrate with Eclipse?

How to install it?

• Select PlantUML features:
  
• Restart Eclipse

Plantuml Integrations with other tools

Plantuml How to integrate with Eclipse?

How to improve it?

The plugin is not limited to Java source file, it also works with Ecore*/Xcore* files.

So that you can see the corresponding class diagram in a view side-by-side the Ecore*/Xcore* editor :

Plantuml Integrations with other tools

Plantuml How to integrate with Eclipse?

How to improve it?

• If you want to support other file types, you can implement a new extension to do so. You can have a look at the current xcore implementation.

Plantuml How to integrate with Visual Studio Code?

Plantuml How to integrate with Visual Studio Code?

TBD

Plantuml How to integrate with Visual Studio?

Plantuml How to integrate with Visual Studio?

TBD

Plantuml UML Diagrams

Plantuml UML Diagrams

Sequence diagram

TBD

• https://plantuml.com/sequence-diagram

Plantuml UML Diagrams

Usecase diagram

TBD

• https://plantuml.com/use-case-diagram

Plantuml UML Diagrams

Class diagram

TBD

• https://plantuml.com/class-diagram

Plantuml UML Diagrams

Object diagram

TBD

• https://plantuml.com/object-diagram

Plantuml UML Diagrams

Activity diagram (here is the legacy syntax)

TBD

• https://plantuml.com/activity-diagram-beta
• https://plantuml.com/activity-diagram-legacy

Plantuml UML Diagrams

Component diagram

TBD

• https://plantuml.com/component-diagram

Plantuml UML Diagrams

Deployment diagram

TBD

• https://plantuml.com/deployment-diagram

Plantuml UML Diagrams

State diagram

TBD

• https://plantuml.com/state-diagram

Plantuml UML Diagrams

Timing diagram

TBD

• https://plantuml.com/timing-diagram

Plantuml C4 Model Diagrams

Plantuml C4 Model Diagrams

• Context Diagram

• Container Diagram

• Component Diagram

• Class Diagram

• https://crashedmind.github.io/PlantUMLHitchhikersGuide/C4/c4.html

• https://crashedmind.github.io/PlantUMLHitchhikersGuide/C4/C4Stdlib.html

Plantuml C4 Model Diagrams

Context Diagram

TBD

Plantuml C4 Model Diagrams

Container Diagram

TBD

Plantuml C4 Model Diagrams

Component Diagram

TBD

Plantuml C4 Model Diagrams

Class Diagram

TBD

Plantuml None-UML Diagrams

Plantuml None-UML Diagrams

JSON data

TBD

• https://plantuml.com/json

Plantuml None-UML Diagrams

YAML data

TBD

• https://plantuml.com/yaml

Plantuml None-UML Diagrams

Network diagram (nwdiag)

TBD

• https://plantuml.com/nwdiag

Plantuml None-UML Diagrams

Wireframe graphical interface or UI mockups (salt)

TBD

• https://plantuml.com/salt

Plantuml None-UML Diagrams

Archimate diagram

TBD

• https://plantuml.com/archimate-diagram

Plantuml None-UML Diagrams

Specification and Description Language (SDL)

TBD

• https://plantuml.com/activity-diagram-beta#sdl

Plantuml None-UML Diagrams

Ditaa diagram

TBD

• https://plantuml.com/ditaa

Plantuml None-UML Diagrams

Gantt diagram

TBD

• https://plantuml.com/gantt-diagram

Plantuml None-UML Diagrams

MindMap diagram

TBD

• https://plantuml.com/mindmap-diagram

Plantuml None-UML Diagrams

Work Breakdown Structure diagram (WBS)

TBD

• https://plantuml.com/wbs-diagram

Plantuml None-UML Diagrams

Mathematic with AsciiMath or JLaTeXMath notation

TBD

• https://plantuml.com/ascii-math

Plantuml None-UML Diagrams

Entity Relationship diagram (IE/ER)

TBD

• https://plantuml.com/ie-diagram

PlantUML Preprocessing

PlantUML Preprocessing

TBD

• https://plantuml.com/preprocessing

Plantuml Icon Diagrams Support (PlantUML Stdlib)

Plantuml Icon Diagrams Support (PlantUML Stdlib)

TBD

• https://plantuml.com/stdlib
• https://crashedmind.github.io/PlantUMLHitchhikersGuide/NetworkUsersMachines/NetworkUsersMachines.html

Calling PlantUML from Java

You can easily integrate PlantUML with your own code by adding plantuml.jar in your classpath.

Calling PlantUML from Java

PNG generation from a String

If your diagram description is stored in a String, you can use the SourceStringReader class to generate some PNG file.

Calling PlantUML from Java

PNG generation from a File

If your diagram description is stored in a File, you can use the SourceFileReader class to generate some PNG file.

Calling PlantUML from Java

SVG generation from a String

If your diagram description is stored in a String, you can use the SourceStringReader class to generate some SVG file.

References

• Plantuml Official Web Site
• Plantuml Wikipedia
• Plantuml GitHub
• Plantuml Online Server

Plantuml Credits

• Original idea: Arnaud Roques
• Word Macro: Alain Bertucat & Matthieu Sabatier
• Word Add-in: Adriaan van den Brand
• J2V8 & viz.js integration: Andreas Studer
• Official Eclipse Plugin: Hallvard Trætteberg
• Original Eclipse Plugin: Claude Durif & Anne Pecoil

Plantuml Credits

• Servlet & XWiki: Maxime Sinclair
• Docker: David Ducatel
• AWS lib: Chris Passarello
• Stdlib Icons: tupadr3
• Site design: Raphael Cotisson
• Logo: Benjamin Croizet