Click or drag to resize
StaMaTransition Knot Shape

Explains the visual appearance, usage, context menus and properties of the transition knot shape.

The transition knot shape is the pivot shape of any transition. It connects to a state shape to define the source state of the transition and must be connected to at least one transition segment shape to define the target state to form a complete transition.

The transition knot carries the event signal, the transition guard condition and the transition action.

Simple two endeded transitions as well as complex fork and join transitions have a single transition knot shape.

Transition Knot Shape Simple And Fork And Join
Figure 1: Usage of transition knot shape in simple two ended transition, fork transition and join transition

The transition knot shape displays a number near the connection of the shape with the source state, which is used to define the priority of the transition compared to other transitions emanating from the same source state.

Transition Knot Shape Priorities
Figure 2: Priority visualization of transition knot shape
What Do You Want to Do?
Transition Knot Shape Properties

The transition knot shape has two property dialogs accessible through different parts of the transition knot shape. Each property dialog relates to different aspects of the transition knot shape.

The properties dialog of the rectangle of the transition knot shape can be opened either by double clicking on the rectangle or by opening the context menu of the rectangle and executing the menu item Properties....

Transition Properties
Figure 3: Transition knot shape rectangle properties

The properties are as follows:

Property

Purpose

Event Signal

Provides the event signal of the transition. The default code generator shape will use this property to fill the triggerEvent parameter of the StateMachineTemplateTransition method.

Guard Condition

Provides a function name (or delegate or lambda expression) for the guard condition of the transition. The default code generator shape will use this property to fill the guard parameter of the StateMachineTemplateTransition method. See Code Generator Shape how to customize the code generator shape if needed.

Transition Action

Provides a method name (or delegate or lambda expression) for the transition action. The default code generator shape will use this property to fill the transitionAction parameter of the StateMachineTemplateTransition method. See Code Generator Shape how to customize the code generator shape if needed.

Priority

Defines the priority of the transition through an integer value. The code generator sorts the transitions of a state according to this value which has the effect that transitions with lower numbers take precedence over transitons with higher numbers.

Identification

Provides a human readable name for the for the transition that can be used to identify the transition during tracing. The code generator shape will use this property to fill the name parameter of the StateMachineTemplateTransition method. See Code Generator Shape how to customize the code generator shape if needed.

The properties dialog of the connector line of the transition knot shape can be opened either by double clicking on the connector line or by opening the context menu of the connector line and executing the menu item Properties....

Transition Knot Shape Connector Line Properties
Figure 4: Transition knot shape connector line properties

The properties are as follows:

Property

Purpose

Segment Type

Defines if the connector line shall act as the source state definition for the transition, or if it shall act only as an anchor and the source states are defined through transition segment shapes (see Create a Join Transition).

Transition Knot Shape Rectangle Context Menu

The transition knot shape rectangle has the following additional context menu items:

Context Menu Item

Purpose

Show Actions

Turns on or off visibility of all actions in the diagram (to reduce drawing space).

See Also