Working with Model Elements in Concurrency Mode

Importing Model Elements

The import of model elements is only possible, if a global lock is set. This can be achieved by the Lock All For Editing option. Please refer to the section Locking all Lockable Elements of the chapter Locking and Unlocking Elements for detailed information on this option.

In case you try to import model elements without owning a global lock on the target model, the following error message requesting to obtain a global lock first is displayed:

Error Message
Figure: Message Dialog to indicate the required Lock.

Editing Process Definitions

If a process definition is not locked for editing, no elements pertaining to process definitions like activities, triggers, transitions or data paths, can be added, removed or edited in this process definition.

Editing Diagrams

Editing Process Diagrams

Process diagrams are not editable, if the parent process definition is not locked. You can open them in read-only mode, which means:

A diagram in locked state might contain model elements like participants, applications or data, that can be changed independently. In case these elements are locked for editing, they can be edited from within the diagram, like opening the property dialog, renaming and deleting, but their symbols have the same restrictions as all element symbols in a non-editable diagram.

In case you try to edit a model element pertaining to the process definition or another element, which is not in locked state, a message dialog opens to notify that the element has to be locked first:

Lock First Warning
Figure: Message Dialog requesting Lock on Element.

Editing Model Diagrams

In case a model diagram is not locked for editing, you can open it in read-only mode, as described for process diagrams.

The behavior of the contained symbols pertaining to model elements is the same as described for process diagrams.

Editing Mode in Property Dialogs

Property dialogs of model elements of a model in Concurrency Management Mode are displaying all control fields in read-only mode. To edit content, a button Lock for Editing is provided at the bottom of the dialog. Clicking this button will lock the corresponding model element or, if the model element to be edited is only part of a lockable element, its containing element.

Property Dialog Example
Figure: Property Dialog in read-only Mode.

In case the lock attempt fails, an according error dialog opens and all controls stay in readonly mode.

Error Dialog
Figure: Error Dialog

Property dialogs of elements pertaining to a process definition are not editable if the parent process definition is not locked.

Cut, Copy and Paste Operations

In case model elements are copied to a model in concurrency mode, the new elements will be displayed as newly added elements in the Outline view and provided to be committed in the commit dialog. In case a diagram or process definition, where a copied element should be pasted, is not locked, a warning dialog opens to indicate that the target element has to be locked first.

Paste Warning
Figure: Message Dialog requesting Lock.

Renaming Model Elements

Direct editing of symbol names, like using the F2 short key or a mouse click on the name, requires a lock for editing on the according element or a lock on the according process definition accordingly. Otherwise a message dialog opens to inform that a lock has to be achieved before.

 Dialog
Figure: Lock Failed Dialog

Creating New Elements

If new lockable model elements are created, their according lock file will not be created and submitted immediately, this is done on commit. New elements pertaining to a parent node, for example a process definition, can only be created, if the parent node is locked for editing.

For all lockable element, the newly created element is indicated as new with an overlay icon displaying a plus sign in the right upper corner of the element icon:


Figure: Icon indicating an added model element.

Deleting Elements

A confirmation dialog open when deleting a lockable element:

Deletion Confirmation Dialog
Figure: Deletion Confirmation Dialog

To delete any element a lock must be obtained before the user can delete the element. Deleting activities or other elements pertaining to a process definition, requires a lock of the according process definition. In case the parent process definition is not locked, the Delete option is not available.

Deleting Elements having Symbols in a Diagram

In case an element is deleted having symbols in a diagram, that is locked for editing, the symbols are also deleted. If the according diagram is not locked for editing, the symbols are not deleted, but replaced with undefined symbols.

Undefined Model Element
Figure: Deleted Element replaced by an undefined Element.

Indication to other Users

In case a user deletes a lockable model element and commits this change, this is indicated in the appropriate model element in the Outline view to other users by an overlay icon representing a cross.

Model Element deleted remotely.
Figure: Model Element deleted remotely.

Model Element State Indication

In the Outline view, the lock state of model elements are indicated in the lower right corner of the model elements icon. The following states are possible:

Shared Mode

In case a model element is shared with the repository, but not locked, the following overlay icon indicates this state:


Figure: Shared Mode

Locked State

In case a model element is locked for editing, a checkmark icon indicates that state:


Figure: Locked State

Locked by another User

In case a model element is locked by another user, the following icon is indicating this state:


Figure: Locked by another User

Additionally the name of the user who locked this element is added to the right side of the model element name, e.g.:


Figure: Name of the User who locked the Element.

External Model Information Resources

In case an already existing model element is imported from an external model resource, the original version will be replaced. A confirmation dialog opens, where you can choose to replace the existing element or to reuse the element in the model:


Figure: Replacement Dialog

The corresponding model elements have to be locked for editing before this action. Otherwise, an according error message requesting to lock the model elements before the import is displayed.

Please refer to the chapter External Model Resources for general information on working with external model resources.