Accessing Elements

In this chapter, we're going to learn how to access elements. Before you read this chapter, you need to have clear understanding of the difference between software model and diagram as well as model elements and view elements. If you don't know about this, please read Basic Concepts first.
In the following sections, we will use an example software model as shown in the below figure. Actual model file can be obtained from here: https://github.com/staruml/staruml-dev-docs/blob/master/samples/Book.mdj. There are two classes Book and Author and a association wrote connecting between the two classes. In addition, there is a diagram named Main which containing three view elements, each corresponds to Book, Author, wrote respectively. All these elements and a diagram are contained by a model named Model which is also contained by the top-level project element named Book Sample.
Could not load image
Book Sample
Getting a top-level project
First we will access to the top-level project element. The top-level project element can be obtained by using app.project.
1
var project = app.project.getProject()
2
console.log(project.name) // "Book Sample"
Copied!
Note
all Javascript code examples can be executed in console (select Debug > Show DevTools and then click Console tab).
The obtained element is just a Javascript object, so you can access to any fields such as project.name or project.ownedElements[0]. Printing the element itself in console like console.log(project) is helpful to get all information about the element.
Inspecting elements
Then, how can we know which classes of elements are available and which attributes or operations are available for each class of elements? You can find documentations of the metamodel at Metamodel documentation or additionally at API Reference.
You can access to any elements via the top-level project. Containment structure is shown in Explorer of the above capture image.
1
var model = project.ownedElements[0]
2
console.log(model.name) // "Model"
3
​
4
var mainDiagram = model.ownedElements[0] 
5
console.log(mainDiagram.name) // "Main"
6
​
7
var book = model.ownedElements[1]
8
var author = model.ownedElements[2]
9
console.log(book.name) // "Book"
10
console.log(author.name) // "Author"
11
​
12
var association = book.ownedElements[0]
13
console.log(association.name) // "wrote"
14
console.log(association.end1.name) // "publications"
15
console.log(association.end1.multiplicity) // "1..*"
16
console.log(association.end2.name) // "authors"
17
console.log(association.end2.multiplicity) // "1..*"
18
​
19
var bookISBN = book.attributes[0]
20
console.log(bookISBN.name) // "ISBN"
21
console.log(bookISBN.type) // "String"
22
console.log(bookISBN.visibility) // "public"
23
console.log(bookISBN.isID) // true
Copied!
So far we inspected model elements only, now you will see the view elements contained by the diagram Main.
1
var bookView = mainDiagram.ownedViews[0]
2
console.log(bookView.left) // 32
3
console.log(bookView.top) // 20
4
console.log(bookView.width) // 114
5
console.log(bookView.height) // 103
6
console.log(bookView.fillColor) // "#ffffff"
7
console.log(bookView.model.name) // "Book"
8
console.log(bookView.model === book) // true
9
​
10
var authorView = mainDiagram.ownedViews[1]
11
...
Copied!
Each element has a corresponding Javascript class definition. The class definitions are in a global variable type.
1
console.log(project instanceof type.Project) // true
2
console.log(model instanceof type.UMLModel) // true
3
console.log(mainDiagram instanceof type.UMLClassDiagram) // true
4
console.log(book instanceof type.UMLClass) // true
5
console.log(bookISBN instanceof type.UMLAttribute) // true
6
console.log(association instanceof type.UMLAssociation) // true
7
console.log(bookView instanceof type.UMLClassView) // true
Copied!
Retrieving elements by query
Accessing elements from the top-level project is very inconvenient and tedious. How can we get all elements of UMLClass type? To retrieve elements easily, StarUML provides a very simple query expression.
Following are several examples for query expression. To see the full specification of query expression, refer to https://github.com/staruml/metadata-json/wiki/SelectorExpression.
1
app.repository.select("@Project")
2
// returns elements of type.Project: [Project]
3
​
4
app.repository.select("@UMLClass")
5
// returns elements of type.UMLClass: [Book, Author]
6
​
7
app.repository.select("Model::Book")
8
// returns elements named "Book" contained by an element named "Model": [Book]
9
​
10
app.repository.select("Book.attributes")
11
// returns elements in 'attributes' field of an element named "Book": [ISBN, title, summary, publisher]
12
​
13
app.repository.select("@UMLAttribute[type=String]")
14
// returns elements of type.UMLAttribute only if whose 'type' field has "String" value: [ISBN, title, summary, publisher, name, biography]
Copied!

Developing Extensions - Previous

Keymaps

Next - Developing Extensions

Creating, Deleting and Modifying Elements

Last modified 3yr ago

Copy link

Contents

Getting a top-level project

Inspecting elements

Retrieving elements by query