Skip to content

Directed Graph Generator creates animated diagrams from MS Excel Sheets

License

Notifications You must be signed in to change notification settings

MarkusSprunck/directed_graph_generator

Repository files navigation

Directed Graph Generator

This Spring Boot Application generates UML component diagrams from Excel Sheets. The purpose is to get proper architectural description of an application landscape with minimal effort.

Minimal Input Data

All applications and dependencies have to be stored in a table with a fixed column format. All cells have to be text format.

  • Example sheet for applications Image of Example sheet for applications

  • Example sheet for links Image of Example sheet for links

URL Parameters

Based on URL parameters you can define what you will see in the UML diagram. This is important in the case you have hundreds of applications.

  • filter - select the applications you like to see
  • file - load an alternative file, the default value is data.xlsx
  • package - filter by component name
  • showLinks - the default value is false
  • showComplex - the default value is true
  • strict - show just the applications in the filter, the default value is false
  • colorMode - decide what is the first stereotype. Allowed values are {"status", "location", "cluster"}
  • title - changes the title of the diagram, the default value is "UML Components".

Development

  • The application has been developed with IntellJ IDEA CE in Kotlin
  • UML generation is based on plantUML and this needs GraphVis to run. You find the installation packages here https://graphviz.gitlab.io/download/
  • Java 1.8 JRE will be needed to start the Spring Boot Application
  • A docker image will be created and started during the build, but you may also run without docker. In the case you use docker, just mount the path /usr/local/bin/data/ in the container to a local folder.

Expected Results

The generated html files need no additional libraries, so you may open them in the browser and save them as file.

  1. Home screen (http://localhost:8080) : alt text

  2. Applications in components view with first stereotype is the status (http://localhost:8080/diagramshowLinks=true&colorMode=status): alt text

  3. Applications in components view with first stereotype is the cluster (http://localhost:8080/diagramshowLinks=true&colorMode=cluster): alt text

  4. Applications in components view reduced information (http://localhost:8080/diagramshowLinks=true&colorMode=status&showComplex=true&filter=ID01-ID02): alt text

  5. Applications in components view with simple (http://localhost:8080/diagramshowLinks=true&showComplex=false): alt text

About

Directed Graph Generator creates animated diagrams from MS Excel Sheets

Resources

License

Stars

Watchers

Forks

Packages

No packages published