Create Toolbox Profiles

Within an MDG Technology you can create multiple Toolbox Profiles. Each Toolbox Profile contains definitions that determine what pages appear in the Toolbox when it is opened, either by selection from the More tools... option in the Diagram Toolbox, or by opening or creating a diagram of the type that is linked to the Toolbox Profile.

Create a Toolbox Profile

Step

Action

See also

1

In a Profile package, create a Class diagram with an appropriate name by which you can refer to it later, such as MyClassDiagram.

 

Create a Profile Package

 

2

Double-click on the diagram background to display the diagram Properties dialog and, in the Notes field, give the diagram an alias and a description in the following format:
 

Alias=MyClass;Notes=Structural elements for Class diagrams;
 
 

 

3

On the diagram, create a Metaclass element with the name ToolboxPage.

 

 

 

Add Stereotypes and Metaclasses

4

Create a Stereotype element for each of the Toolbox pages to create within your Toolbox, such as MyClassElements and MyClassRelationships.

Double-click on each element to display the Properties dialog and, in the Alias field, type the text to display in the title bar of the corresponding Toolbox page, such as My Classes or My Class Relationships.

In the Notes field of each element, type the tool-tip for the corresponding Toolbox page; for example, Elements for Class Diagrams or Relationships for Class Diagrams.

Create an Extension connector between each Stereotype element and the ToolboxPage Metaclass element.

 

5

In each of the Stereotype elements, press F9 and create an attribute for each Toolbox item in the page defined by that element.

The name of each attribute is the name of the element or connector to be dropped, including the element's namespace; for example, UML::Package, UML::Class and UML::Interface. You might not want to display names including text such as UML::Package or UML::Class in your Toolbox, so give the attributes an Initial Value of, for example, Package or Class.

The Toolbox items display in the same sequence as their attributes in the element, so use the attribute ordering buttons (green up/down arrows) in the Attribute Properties dialog to define the order of icons in your Toolbox page.

In the name of an attribute for an element or connector from your own technology, use your Profile name as the namespace, and then follow the item name with the element or connector type that you are extending, in brackets (to identify to Enterprise Architect what type of object to create); for example, a SysML Block element would appear as:
 

    SysML::Block(UML::Class)

 

Many elements and connectors can be extended for use in Toolboxes.

 

 

 

 

 
 

General Properties of Attributes

 

 

 

 

Elements Used in Toolboxes

Connectors Used in Toolboxes

6

To define a Toolbox item to drop a Pattern onto a diagram, name the attribute:
 

    My Technology::MyPattern(UMLPattern)
 

MyTechnology is the ID of the technology and MyPattern is the name of the Pattern to drop; for example:
 

    BusFramework::Builder(UMLPattern)
 

If you want to avoid displaying the Add Pattern dialog, replace (UMLPattern) with (UMLPatternSilent).

To define a model-based Pattern in a custom Toolbox (such as the GoF Patterns), create an attribute with a name of the format:

 
    PatternCategory::PatternName(UMLPattern)

 
For example:

 
    GoF Behavioral Patterns::Mediator(UMLPattern)

 

 

7

Define any attributes you need to modify the display of the Toolbox pages, such as whether the Toolbox pages are minimized or displayed without item names (labels).

 

Toolbox Page Attributes

8

To save the Toolbox profile, right-click on the diagram and select the Save as Profile context menu option.

 

Export a Profile

Notes

When assigning an Alias for a Toolbox page, 'elements' is a reserved word. If the word 'elements' is used, it will not appear in the title bar of the corresponding Toolbox page
Each Profile element incorporated into an MDG Toolbox page enables a context menu option to synchronize the Tagged Values and Constraints of all objects created from it
The sequence of Toolbox pages in the Toolbox is determined by the sequence of their Stereotype elements in the Profile diagram or Profile package; if you create and save the Profile from a:
Diagram, the Toolbox page sequence is determined by the Z-order of the Stereotype elements on the diagram - the higher the Z-order number of the Stereotype element, the further down the Toolbox its Toolbox page is placed; if you change the Z-order of a Stereotype element in the diagram, it changes the position of the element's page on the Toolbox
Package in the Project Browser, the Toolbox page sequence is determined by the list order of the Stereotype elements in the package - the Toolbox page for the first listed element is at the top of the Toolbox; if you re-order the elements in the Project Browser, you produce the same re-ordering of pages in the Toolbox
 

Learn more

Diagram Context Menu (Modify Z-Order option)

Learning Center topics

(Alt+F1) | Enterprise Architect | Modeling Languages | Build a Technology | Create a Custom Toolbox