Skip to content

yveszoundi/archi-humaneimage

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

README

What is this?

This is a set of Archi scripts for generating simple humane images from Archimate diagrams:

  • Design with the Archimate modelling language notation
  • Share diagrams containing just lines and rectangles (no special figures)

./images/to_humane_image_scaled.png

*This is not meant to export Archimate free-drawing views (Canvas or Sketch diagrams).*

Requirements

  • Archi 4.9.x or later
  • The latest version of jArchi compatible with Archi 4.9.x or later
  • The GraalVM JavaScript engine selected in Archi preferences (Scripting > JavaScript Engine)
    • This is not required for recent versions of Archi, as GraalVM is now the default JavaScript engine
    • Please note that supporting Java code is loaded by Archi scripts

How to use it?

Please clone this repository under your jArchi scripts folder (Preferences >Scriting > Scripts folder:): if you still don’t understand the procedure, please visit the jArchi wiki or forum.

You can then right-click on any diagram in Archi and explore available scripts (Scripts > humaneimage).

How does it work?

PNG export

There’s just a little bit of custom drawing happening with few hooks into Java, instead of “pure JavaScript”.

./images/humane_image_process.png

PowerPoint export

This generates PowerPoint shapes and the deck can be changed easily by non-technical users (accordingly to the audience and message to convey).

./images/to_ppt.jpg

Scripts description

The main library is under lib/humaneimage.lib.js and the scripts under the humageimage folder are just interfaces to it.

ScriptDescription
ExportAllViewsToHumaneImages.ajsExport all model diagrams to humane images
ExportCurrentViewToHumaneImage_Cfg_Default.ajsExport the current diagram to a humane image
ExportCurrentViewToHumaneImage_Cfg_Override.ajsSame as the above with options dialog
ExportCurrentViewToPowerPoint.ajsExport a view to PowerPoint (pptx format)
ExportToHumaneImageModel.ajsExport a view model for custom processing

Contributing

The best way to contribute is via a pull request.

Notes

I did not write the whole functionality from scratch:

Releases

No releases published

Packages

No packages published