Skip to main content
Skip table of contents

Working with the Activity Editor

When you open the implementation of an operation that has been implemented as activity, the activity diagram opens in the activity editor.

The activity editor consists of different areas:

(1) Activity Editor

(2) Activity Toolbar

(3) Elements Toolbar

(4) Designer Panels

activity_diagram_editor.png

Customizing the Activity Editor

You have several options to adjust the activity diagram editor. When you open the editor for the first time, the default view is displayed:

  • The Diagram Pane is displayed in the top-right.
    (See Modeling Activities for more information.)

  • Four Designer Panels are shown in the sidebar on the left.

    • The Service Panel

    • The Controls Panel

    • The Attributes Panel

    • The Validation Panel

activity_diagram_empty.png

Refer to Customizing Editors and Panels for detailed information about panel management in general.

The diagram pane shows the torso of an activity diagram: only initial node and final node are present. This leads to the validation panel showing errors because a control flow is missing.
Refer to the other pages in this chapter for more information on how to draw a valid activity diagram:

Modeling in the Activity Editor

While modeling, some general functionalities help you to browse through your model, and to adjust your working location within the model. Refer to Customizing Editors and Panels for more details.

Toolbars

The activity diagram editor features a diagram toolbar in the center top of the diagram pane, and an elements toolbar on the right.

Activity Toolbar

The activity diagram toolbar assist you during modeling an activity diagram:

activity_toolbar.png

The available tools are:

Icon

Tool Name

Description

bpmn_toolbar_go_to_icon.png

Select in service panel

Select the related operation in the service panel.

mapping_toolbar_reload.png

Reload diagram

Click on this icon to reload the activity diagram.

bpmn_toolbar_toggle_grid_icon.png

Toggle Grid

Use this option to enable or disable the grid on the diagram pane. The grid supports you during modeling: If the grid is enabled, elements snap to the grid points.

bpmn_toolbar_horizontal_icon.png

Insert/Remove horizontal space

Use this option if you need more or less space on the diagram pane. Click on the pane to display the start line, the second click marks the end line and defines the size of the area to be added. To add space, click from left to right to define the area. If you want to delete a horizontal space, click from right to left to define the area.

bpmn_toolbar_vertical_icon.png

Insert/Remove vertical space

Use this option if you need more or less space on the diagram pane. Click on the pane to display the start line, the second click marks the end line and defines the size of the area to be added. To add space, click from top to bottom to define the area. If you want to delete a vertical space, click from bottom to top to define the area.

bpmn_toolbar_undo_icon.png

Undo

Undo the previous action you performed in...

  • ... one of the Designer editors (except mapping editor).

  • ... the Implementation folder of the service panel.

If you click Undo in one of the Designer editors, this may also have an effect on the Implementation folder in the Service panel if you performed your previous action there.

bpmn_toolbar_redo_icon.png

Redo

Redo your previous action (after undo).

Elements Toolbar

The elements toolbar contains all elements that you can create on your activity diagram.

Icon

Description

final_node_icon.png

Add a final node. An activity diagram can have multiple final nodes.

local_variable_icon.png

Add an object node. This can be used to store data locally.

activity_decision_icon.png

Add a decision. Decisions are used to split the control flow based on conditions/guards.

throw_exception_icon.png

Throw the exception defined by the parameters. If this error is not caught, it will be sent back to the client.
For more information, refer to User Defined Errors in the xUML Services Reference Guide.

bpmn_text_icon.png

Add a literal. It can be connected to output parameters, return parameters or pins (action call or throw exception) that do not have incoming relations.

activity_comment_icon.png

Add a comment. This has no effect on the execution, it is just for documenting purposes.

mapping_icon.png

Add a mapping operation.

actionscript_icon.png

Add an action script operation.

javascript_icon.png

Add a JavaScript operation.

activity_icon.png

Add an activity operation.

If you have added an operation via the elements toolbar, it...

  • ... resides in the same class as the activity diagram.

  • ... inherits the static attribute of the activity diagram by default, i.e. if the activity diagram is static, the new operation is also static.

Activity Diagram Context Menus

You are supported during modeling on the activity diagram pane by various context menus:

Tools Context Menu

Icon

Description

If you right click on an element, the tools context menu opens. Use it to edit the current element.

bpmn_cm_delete.png

Delete the element.

bpmn_cm_to_front.png

Bring the element to the front.

bpmn_cm_to_back.png

Send the element to the background.

align_to_grid_icon.png

Align the element to the grid.m

cm_navigate_to_icon.png

Open the implementation of the element in a new tab.

cm_go_to_icon.png

Jump to the element in the Service panel.

Extended Tools Context Menu

Icon

Description

If you have selected more than one element on the pane, the tools context menu is enhanced with additional options. The available options depend on your selection on the diagram pane:

If you want to align a relation between two elements, mark the pin(s) to apply the corresponding alignment functionality.

cm_align_left.png

Align left

cm_align_right.png

Align right

cm_align_center.png

Align center

cm_align_top.png

Align top

cm_align_bottom.png

Align bottom

cm_align_middle.png

Align middle

cm_distribute_horizontally.png

Distribute horizontally

cm_distribute_vertically.png

Distribute vertically

bpmn_cm_align_relation.png

Align relation

Control Flow Context Menu

Icon

Description

open_relation_context_menu.png

Right-click a control flow to open the context menu.

bpmn_cm_delete.png

Delete the relation.

bpmn_cm_to_front.png

Bring the relation to the front.

bpmn_cm_to_back.png

Send the relation to the background.

bpmn_cm_align_relation.png

Align the relation.

Diagram Context Menu

Icon

Description

With a right-click on the diagram pane itself, you open the diagram context menu.

cm_go_to_icon.png

Jump to the related operation in the Service panel.

Keyboard Shortcuts

Find below a list of all keyboard shortcuts that are available in the activity diagram editor.

Shortcut

Description

Arrow down

Moves the editor pane downwards.

Arrow up

Moves the editor pane upwards.

Ctrl + 1, 2, 3 ... 9

Switches to the Designer tab corresponding to the chosen number. This feature is available for the first nine open tabs.

Ctrl + D

Closes the active Designer tab.

Ctrl + Mouse Wheel

Zooms in (scrolling up) or out (scrolling down) of the current model.

Ctrl + Shift + D

Closes all tabs and switches to the service tab.

Del

Removes the selected element(s) from the diagram pane.

Esc

Aborts the following procedures:

  • adding a new element

  • resizing an element

  • closing a dialog

  • drawing a control or object flow

  • changing the path of a control or object flow

Mouse Wheel

Moves the diagram pane up or down.

Shift + Page down

Switches to the next Designer tab from left to right.

Shift + Page up

Switches to the next Designer tab from right to left.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.