Drawing and Connecting Shapes

Drag from Shapes Panel

You can access the BPMN shapes by clicking on the BPMN (Basic) shapes palette and dragging them onto the diagram.

bpmn 2.0 (basic)

Dropping a shape will automatically create space if there is not enough space available. Dropping a flow node on an sequence flow (highlighted) will insert the element and reconnect the sequence flows.

Selecting Shapes

In the process diagram, flow nodes must be connected with sequence flows, each properly attached to a connection point at both ends to be valid. Improperly connected links are invalid and colored red in the tool. You must adjust the endpoint to properly connect the link.

Normally you use classic mouse and keyboard interactions to select and move the shapes:

  • A single click on a shape selects only this shape.

  • Clicking outside of a shape and dragging to create a selection box selects all the shapes completely inside the selection box on the mouse click release.

  • Ctrl-clicking on a shape adds it to the current selection if it was not already selected or removes it from the selection if it was already selected.

  • When a selection is active, clicking and dragging one of the selected shapes will move all of the selected shapes in that direction.

  • When a selection is active, using the keyboard arrows will move the selected shapes in that direction. Holding the ctrl key at the same time moves by one pixel. Right-clicking on a shape brings up its context menu.

Alternatively, operations on the Home ribbon can be used to select shapes:

select all Select All

Select all the shapes on the current diagram.

select none Select None

Clears the selection.

The Home ribbon also offers operations to manipulate selected shapes.

align Align

Align nodes based on a defined size to the first node in the selection.

same size Same Size

Resize all selected nodes to the size of the first node in the selection.

group Group

Create a virtual group that makes selecting one node in the group select all other nodes of the group.

ungroup Ungroup

Ungroup a previously created group.

bring forward Bring Forward

Bring your shape(s) forward if they are overlapping with other shapes or bring them completely to the front.

send backward Send Backward

Send your shape(s) backward if they are overlapping with other shapes or send them completely to the back.

Labeling Shapes

Entering text on a selected node creates its label, which by default is the element name. In BPMN, elements are specified by ID not name, so except for data elements, it is not required that element names are unique.

Connecting Shapes

Smart arrows

When selecting a single node, four triangle icons called smart arrows will appear, one on each side of the node. Clicking on a smart arrow will automatically create a link of the proper type to a close node on that side. For example, if the close node is a flow node it will create an information requirement, but if it is a data element it will create a data association. If no shape is close in that direction and you hover over a smart arrow, a quick pick dialog appears showing various types of target nodes:

smart arrows

Selecting one will create a new node of that type and a link to it. If you hover too long before selecting, it will create a new task node in that direction and a link to it.

Clicking and dragging the smart arrow lets you create a link to a node at the drop location.