Scripting Framework Introduction

-
One of the reasons I became a fan of Enterprise Architect was that it was extensible via its scripting functionality. I went through a period where I did a lot of scripting in Javascript for EA, however eventually I became disillusioned as I started hitting the limits of the functionality. The two primary issues were
  1. The Javascript engine used within EA was quite old (pre version 15) and hence the latest language features in Javascript were not available within EA.
  2. The more interesting extension points within EA were only available through the Addin protocols/interface, and these were not available in the scripting environment.
I have at various times, and in different contexts, have developed scripting frameworks for EA, a published example is available from Github (here).  However, because of the two issues given above I had pretty much given up on Javascript as an extension option for EA and instead had been spending time using C# to muck around with an AWS addin that I had started (see here).

With version 15, the updated Javascript engine and the new Model Addin features.  The two above issues are no longer relevant.  I have started playing around with the new updated Javascript capabilities in EA,  initially just seeing what was possible, but it is slowly taking the form of a framework.

It doesn't have a name at the moment (actually I have been using Peso as a handle) and I'm not sure where it is going, as I'm just continuing to explore things.  However, the next few blog posts on this blog will be related to this work, and are likely to be somewhat technical in nature.  Anything that's halfway useful, I will release through Github.

Related Posts


[Originally version posted here.]

Comments

Post a Comment

Popular posts from this blog

Creating Items in Sparx EA via Java

-
Introduction This short post provides guidance on how to create "things" in a Sparx EA model via the Java API. Theory Creating "things" in EA via Java is driven by the Add New method and the Collection class. The first example in the code is adding a "view" to an existing root node. The code below will retrieve the root GUID if the "i" variable is set to 0; rootPackageID = rep . GetModels (). GetAt ( i ). GetPackageGUID (); After obtaining the root GUID it is possible to create a view under the root node. Note the process of retrieving the packages under the root and placing them in a collection. The Add New process is driven from the Collection. Importantly, for a view, the code needs to set a flag which indicates a particular icon. This process is only required for views. org . sparx . Package root = rep . GetPackageByGuid ( rootPackageID ); // get the root Collection < org . sparx . Package > subPackages = r
Read more

Module Management - Part 1 - getModule() Pattern

-
As discussed in  Module Management - Analysis , EA does not provide support for the ubiquitous Module Pattern .  This becomes an issue with an increase in complexity of model addins.  In order to a) Minimise the management of dependencies, and b) Cater for the use of 3rd party modules, The  framework  provides an analogous pattern, which I'm calling the getModule() pattern, because I lack imagination. The premise is straight forward.  Rather than having an anonymous self executing function returning a module object, we instead have module class elements which have a method called "getModule()"  and this returns a module object when the method is called. The getModule() method would be declared (via the EA interface) on a class element, and then we would place all of the module's code in the body of the getModule() method/operation.  The method would return a module object to the caller. The sample contents of a typical getModule() operation might look like this.
Read more

Traversing a EA Model via Java

-
Traversing an Enterprise Architect model from Sparx Systems is relatively simple. This blog introduces the concept of model traversal via the Java API. For information on Java Set-Up see this blog entry . The first step is to obtain the repository object as it provides the anchor from which all other operations are derived. In the example below, a repository is held on the file system. The variable "repoLocation" holds the file system location of the "eap" file.   rep = new Repository();  // get a repository   rep.OpenFile(repoLocation);  //open the repository file At the top of a model is a root node and it is typically where you want to start when traversing a model. From the root node you can then obtain a collection of packages. At this point, it is easy to traverse the collection pulling in the packages via a loop and in this example printing out their names. To see the complete example, go to GitHub .   org.sparx.Package myMode
Read more