You must lock the part of the model you are going to edit to prevent other users from editing it at the same time. Locking is allowed if that part of the model is not locked by another user, because an item can only be locked by one user at a time.
The following table outlines what you can edit after you lock a single element, single diagram, diagram with elements, and so on:
When you lock... | You can... |
---|---|
Element | Edit element specification properties (in the Specification window) |
Diagram | Edit:
|
Diagram with elements | Edit:
|
Symbol styles | Edit properties of symbol styles (in the Project Options dialog) |
Project usages |
|
Locking without forced project update
You can lock elements without forcing an update of a project to the latest version if the selected elements are not locked or do not have changes in a newer version on the server.
This feature can be enabled/disabled in the Environment Options dialog.
To enable/disable locking without updating
- Select Options > Environment > Collaboration node.
- Find Enable Locking Without Forced Project Update. Do one of the following:
- Set to true, to enable locking without updating;
- Set to false, to disable locking without updating.
There is a 60-second threshold; if locking takes longer than 60 seconds, a project update will be required.
An example
You are trying to lock package B, which contains many elements, recursively. The modeling tool cannot check all contained elements' status in later versions of the project in 60 seconds. After 60 seconds, a project update will be required to lock the package.
Representation of locked elements
In the Containment tree, element names are represented in two colors:
- Unlocked elements are represented in black, meaning they are editable.
- Locked elements are represented in gray, meaning they are not editable.
Locking elements and diagrams
If you want to lock all lockable elements, disable lock-free editing to work in a lock-required mode.
Elements and diagrams can be locked by using the commands from their shortcut menu.
Elements can also be locked by clicking the Lock element for the Edit button on their Specification window.
The following table provides suggestions on which locking commands to use for different purposes.
If you need to edit... | Do the following |
---|---|
Specification properties of a single element |
OR
|
Specification properties of both an element and the elements it contains (owns) For example, a project has a Package Analysis, containing two inner Packages Lock the Package Analysis recursively to edit all the elements in this Package. |
|
At least one of the following:
|
OR
|
At least one of the following:
|
OR
|
At least one of the following:
|
|
Locking symbol styles
You can lock symbol styles via the Lock View tab or the Project Options dialog.
To lock symbol styles via the Lock View tab
In the Lock View tab on the Model Browser, expand Project Options.
- Right-click Symbol Styles and from the shortcut menu select Lock Symbol Styles for Edit.
To lock symbol styles via the Project Options dialog
- Do either:
- Select Options > Project.
In the Lock View tab on the Model Browser, right-click Project Options and from the shortcut menu, select Symbol Styles.
- In the Project Options dialog, click Lock Symbol Styles for Edit.
As a result, symbol styles become editable. Additionally, the Make Default button (1) in all Symbol Properties dialogs and the Set Selected Symbol Style as Default button (2) on all the diagram toolbars become available, as shown below.
Locking project usages
To lock a used project
- From the Options menu, select Project Usages. The Project Usages dialog opens.
Select a used project on the left side of the dialog.
- Click the button to lock the used project.
Shortcut menu
You can use a shortcut menu for this step. Right-click the project and then select Lock.
You can then import the used project as a package to the main project, stop using it, or change its version.
Related pages