Overview

There have been already some scripting libraries for Enterprise Architect lift up to the air, but a thoroughful engineered Javascript library is not available. This library provides a set of Javascript files to process and automate Enterprise Architect models. The library is implemented to process UML and SysML models, but should be usable as well for other model languages, like Archimate or BPMN.

License

The code is licensed under MIT. Feel free to use it, to change it, to fork it. If you need consultancy to utilize the library in your projects please contact me:

kontakt@kuehl-at.com.

Compatability

The code is tested with EA 15.2 and 16.1. It runs in a local, file-based deployment and with a database (PostgreSQL).

Functionality

In the moment following functionality is implemented:

• reading JSON configuration files
• writing JSON files
• writing text files
• accessing environment variables
• a minimal unit test framework let you write test cases with assertions
• logging with timestamp and to files.

Going to be implemented soon:

• syncing scripts from file system to EA and database
• Executing queries in the model database
• parsing recursively model trees
• parsing DOM trees as a result of database query
• showing Windows dialogues
• adding traces through connections between different flavours of requirements and between requirements and design elements
• removing Version Control flag from packages

Documentation

The code is documented with jsdoc. Therefore a special plugin has been developed to parse successfully EA flavor of Javascript.

Environment variables

In the moment two environment variables are used:

• EA_Script which defines the root folder of the KAScriptLib
• EA_Log which defines an absolute path to the logging config file, e.g. "your-path-to-the-cfg-file"\logging.json
• EA_Test which defines an absolute path to the config file used throughout the unit tests, e.g. "your-path-to-the-unit-test-cfg-file"\unitTest.json.