Create Diagram Profiles using the Profile Helpers

When you develop an MDG Technology, it is possible to create extended diagram types and include them in your MDG Technology as custom Diagram Profiles. For example, you might create a DFD Diagram Profile that defines a DFD diagram as an extension of the built-in Analysis diagram, as below:

dfd

The Add Diagram Extension Profile Helper can assist you in defining your Diagram Profile, adding the necessary elements and giving them the appropriate attributes to define the functionality of the resulting Custom Diagram types.

Create extended diagram types

Step

Action

See also

1

If you have not already, use the Model Wizard's MDG Technology Builder option to create a set of packages for defining profiles.

In the Project Browser, locate the package with the <<diagram profile>> stereotype and open its child diagram.

 

Using the Profile Helpers

2

Drag the Add Diagram Extension item from the Profile Helpers toolbox page onto the diagram.  The Add Diagram Extension Dialog is displayed.

 

 

3

In the Name field, enter the name for the custom diagram type; for example, BlockDefinition.

 

 

4

In the Extension Type field select the built in diagram type which the custom diagram type will extend.

 

 

5

In the Description field type a brief description of what the diagram is used for.

When the Technology is deployed and a diagram of this custom type is being created, this description will display in the bottom right-hand corner of the New Diagram dialog.

 

 

6

Within the Properties pane enter values for the following fields,

Alias: Type (where Type will appear before the word 'Diagram' on the diagram title bar; for example, Block Diagram)
Frame ID: abc (where abc is the diagram type that will appear in the diagram frame label)
Frame Format String: FrameFormatString (where FrameFormatString is a string containing substitution macros for defining the frame title, with or without additional delimiters such as (   ); macros that can be used are:
#DGMALIAS#
#DGMID#
#DGMNAME#
#DGMNAMEFULL#
#DGMOWNERNAME#
#DGMOWNERNAMEFULL#
#DGMOWNERTYPE#
#DGMSTEREO#
#DGMTYPE#

 

Toolbox Profile: ToolboxName (where ToolboxName is the name of the Toolbox Profile for the Toolbox that opens automatically each time a diagram of this type is opened)
Swimlanes: Lanes=2;Orientation=Horizontal;Lane1=Title1;Lane2=Title2; (where Lanes can be any value, but the number of Lane<n> values must equal the value of Lanes; Orientation can be omitted, in which case the swimlanes default to vertical)

 

 

7

The remaining fields in the Properties pane can be used to customize the diagram's default options.  Any attributes which you do not want applied can have their values be left blank.

When selecting a field, a description of the property's effect will be displayed at the bottom of the Properties pane.

 

 

8

Click on the OK button.  The appropriate Stereotype and Metaclass elements are added to the diagram.

 

 

9

Repeat the step above for each diagram extension you want to include in the diagram profile.

 

 

10

Save the diagram as a Profile.

 

Export a Profile

11

Incorporate the Profile into an MDG Technology.

Create MDG Technology File

 

Notes

After a diagram extension had been added you can modify its properties again by right clicking the appropriate stereotype element on the diagram and selecting Edit with Profile Helper

Learn more