CreatingAndModifyingElements

Creating and Modifying Elements

In this chapter, we're goint to learn how to create elements and modify elements. The most important is that you should not create or modify elements directly like var class1 = new UMLClass() or class1.name = "New Name" because all changes should be supported by undo and redo.

Creating elements

Creating a model element

To create a model element, use Factory module.

var Factory = app.getModule("engine/Factory");

Call createModel function of Factory to create a model element with the following four parameters:

1. id : ID of Factory function. To see the full ID list, execute Factory.getModelIds().
2. parent : A parent element where the created element to be contained.
3. field (optional) : Field name of the parent element (default is ownedElements).
4. options (optional) : An object containing the below options.

• modelInitializer : A function to initialize the created model element.

// Get a reference to top-level project
var Repository = app.getModule("core/Repository");
var project = Repository.select("@Project")[0];

// Create a UMLModel element as a child of project
var model1 = Factory.createModel("UMLModel", project);

// Create a UMLClass element as a child of the model
var class1 = Factory.createModel("UMLClass", model1);

// Create a UMLAttribute element and add to the field 'attributes' of the class
var attr1 = Factory.createModel("UMLAttribute", class1, 'attributes');

// Create a UMLClass with options
var options = {
    modelInitializer: function (elem) {
        elem.name = "MyClass";
        elem.isAbstract = true;
    }
};
var class2 = Factory.createModel("UMLClass", model1, 'ownedElements', options);

You can see the created elements in Explorer and undo and redo are available for each creation.

Creating a diagram

Call createDiagram function of Factory to create a diagram with the following three parameters:

1. id : ID of Factory function. To see the full ID list, execute Factory.getDiagramIds().
2. parent : A parent element where the created diagram to be contained.
3. options (optional) : An object containing the below options.

• diagramInitializer : A function to initialize the created diagram.

// Get a reference to top-level project
var Repository = app.getModule("core/Repository");
var project = Repository.select("@Project")[0];

// Create a UMLModel element as a child of project
var model1 = Factory.createModel("UMLModel", project);

// Create a UMLClassDiagram as a child of the model
var diagram1 = Factory.createDiagram("UMLClassDiagram", model1);

// Create a UMLClassDiagram with options
var options = {
    diagramInitializer: function (dgm) {
        dgm.name = "MyDiagram";
        dgm.defaultDiagram = true;
    }
};
var diagram2 = Factory.createDiagram("UMLClassDiagram", model1, options);

Creating a model element and a view element at once

Call createModelAndView function of Factory to create a model element and a view element at once with the following four parameters:

1. id : ID of Factory function. To see the full ID list, execute Factory.getModelAndViewIds().
2. parent : A parent element where the created model element to be contained.
3. diagram : A diagram element where the created view element to be contained.
4. options (optional) : An object containing the below options.

• modelInitializer : A function to initialize the created model element.
• viewInitializer : A function to initialize the created view element.
• x1, y1, x2, y2 : Rectangle coordinate to initialize position and size of the created view element.
• tailView, headView : If you try to create a relationship (e.g. UMLAssociation), the created view element connects these two view elements tailView and headView.
• tailModel, and headModel : If you try to create a relationship, the created model element connects these two model elements tailModel and headModel.
• containerView : A view element where the created view element to be contained.

The function createModelAndView returns the created view element, so you need to get the create model element by accessing model field. (e.g. classView1.model). Following code will create two classes and a association connecting the two classes.

// Create a UMLClass and UMLClassView
var options1 = {
    x1: 100,
    y1: 100,
    x2: 200,
    y2: 200
};
var classView1 = Factory.createModelAndView("UMLClass", diagram1._parent, diagram1, options1);

// Create another UMLClass and UMLClassView
var options2 = {
    x1: 400,
    y1: 100,
    x2: 500,
    y2: 200
};
var classView2 = Factory.createModelAndView("UMLClass", diagram1._parent, diagram1, options2);

// Create an association connecting the two classes
var options3 = {
    tailView: classView1,
    headView: classView2,
    tailModel: classView1.model,
    headModel: classView2.model
};
var assoView = Factory.createModelAndView("UMLAssociation", diagram1._parent, diagram1, options3);

Creating a view element of an existing model element

Call createViewOf function of Factory to create a view element of an existing model element the following three parameters:

1. model : A model element referenced by the created view element.
2. diagram : A diagram element where the created view element to be contained.
3. options (optional) : An object containing the below options.

• viewInitializer : A function to initialize the created view element.
• x, y : Position of the created view element.
• containerView : A view element where the created view element to be contained.

var options = {
    x: 500,
    y: 500,
};
Factory.createViewOf(classView1.model, diagram1, options);

You will see the one more class view element at (500, 500).

Adding tags to an element

If you want to extend an element with additional tags, create tags by calling createModel function with Tag parameter of Factory. There are five kinds of Tag: String, Number, Boolean, Reference, and Hidden. Hidden tags are not shown in diagrams, but other tags are shown as properties. (Check Format > Show Property menu). Following code will create a string tag to the selected element.

var Core = app.getModule("core/Core");
var Factory = app.getModule("engine/Factory");
var Repository = app.getModule("core/Repository");
var SelectionManager = app.getModule("engine/SelectionManager");

// Get a selected element
var selected = SelectionManager.getSelected();

// Options for creating a tag
var options = {
    modelInitializer: function (tag) {
        tag.name = "Tag1";
        tag.kind = Core.TK_STRING; // or TK_BOOLEAN, TK_NUMBER, TK_REFERENCE, TK_HIDDEN
        tag.value = "String Value...";
        // tag.checked = true; // for TK_BOOLEAN
        // tag.number = 100; // for TK_NUMBER
        // tag.reference = ...; // for TK_REFERENCE
    }
};

// Create a tag to the selected element
var tag1 = Factory.createModel("Tag", selected, 'tags', options);

Examples

Sequence Diagram

Here is an example to create a Sequence Diagram including two Lifelines and a Message.

var Factory = app.getModule("engine/Factory");
var Repository = app.getModule("core/Repository");
var project = Repository.select("@Project")[0];

var model1 = Factory.createModel("UMLModel", project);

// Create a Sequence Diagram
var options = {
    diagramInitializer: function (dgm) {
        dgm.name = "MyDiagram";
    }
};
var diagram1 = Factory.createDiagram("UMLSequenceDiagram", model1, options);

// Create a Lifeline
var options1 = {
    x1: 50,
    y1: 20,
    x2: 50,
    y2: 20
};
var lifelineView1 = Factory.createModelAndView("UMLLifeline", diagram1._parent, diagram1, options1);

// Create another Lifeline
var options2 = {
    x1: 150,
    y1: 20,
    x2: 150,
    y2: 20
};
var lifelineView2 = Factory.createModelAndView("UMLLifeline", diagram1._parent, diagram1, options2);

// Create a Message connecting the above two Lifelines
var options3 = {
    x1: 50,
    y1: 100,
    x2: 150,
    y2: 100,
    tailView: lifelineView1,
    headView: lifelineView2,
    tailModel: lifelineView1.model,
    headModel: lifelineView2.model
};
var messageView1 = Factory.createModelAndView("UMLMessage", diagram1._parent, diagram1, options3);