To be included in a MagicDraw project as a property extending a UML element, an attribute must be owned by a DSL customization element and stereotyped as «derivedPropertySpecification».
To create and specify a derived property
Select the customization element for which you want to create a derived property.
The derived property will be created for the stereotype or metaclass, defined as a customization target in the selected customization element specification.
Select Create Element > Property from the shortcut menu. The attribute is created.
Type the attribute name.
The attribute’s name corresponds to the name of the derived property.
Type derived property names in camel case (i.e.,realizingActivities).
A property name defined in camel case will be displayed in separate words with the first word capitalized. For example, realizingActivities will be changed to Realizing Activities (visible in the user interface).
Apply the stereotype «derivedPropertySpecification» to this attribute. The resulting view of the Model Browser must match the following picture:
Edit property values specifying the derived property in the attribute's Specification window.
All properties are specified in the general specification pane. Some are also specified in the Tags specification pane. For detailed information, see the properties description table.
If you do not see the newly created derived property in the element’s Specification window, please read the following:
- In the element’s Specification window, the specified derived property is visible by default only in the All properties mode. First, try switching to this mode. Also try changing the mode in which you want the derived property to be visible (click the Customize button).
- If you have specified the derived property for the element (with the Used UML Properties property of DSL customization specified) you must add the newly created derived property to the element’s visible properties list. For detailed information, please refer to Derived properties visibility.
The following table describes the properties specified for the derived property.
Property | Description | Specified in... |
---|---|---|
Name | The name of the property. | General specification pane. |
Type | The type of the derived property values. You may set a model element type or a data type (e.g., string, boolean, or integer from the UML Standard Profile) as a property value. To display classes and components as property values, select the classifier as a type for the derived property value. | General specification pane. |
Multiplicity | The multiplicity of the derived property values. If the multiplicity is “0..1”, the derived property value will be shown as single. | General specification pane. |
Is Read Only/ | If true, the derived property is read-only. You cannot edit the result elements for the derived property value. Currently only read-only derived properties are supported. |
|
Is Ordered | If true, the property values are always displayed in the same order. | General specification pane. |
Is Unique | If true, the property values are unique. The same element is displayed only once. | General specification pane. |
Expression/ | One or more expressions of the derived property. There are four possible expression types:
The criterion for selecting the result elements can also be any combination of the expression types above. |
|
Documentation | The text displayed as the derived property description in the element’s Specification window and Properties panel. | Documentation specification pane. |
customizationTarget | The specified derived property will be added to one or more element types (stereotypes and/ or metaclasses). The expression calculations begin from the element type of the customization target. | Customization element Specification window |