Entity locking

OKO Web Client 2.24.1 CSP 4.19.0

This article will guide you through the fundamentals of the Entity Locking feature.

Entity Locking allows anyone with the creator role to prevent changes from being made to elements within a space. 

Locking an entity prevents the following actions from being performed:

• Deleting the entity

• Renaming the entity or components belonging to the entity

• Reparenting the entity

• Adding or removing child entities

• Adding or removing components

• Editing any properties on the entity or components belonging to the entity

• Changing the visibility for any components belonging to the entity

• Selecting entities with the mouse in the space view

• Modifying comments attached to the entity

The effect of locking an entity applies only to that entity, not to any descendants.

Instructions

The Entity Locking feature is accessed through the Entity Hierarchy View. Ensure you have the Hierarchy View visible by selecting the Hierarchy Button in the left-side toolbar.

Locking an entity

To lock an entity, select it in the Hierarchy View and use the menu available from the ":" button. Select the “Lock” function from the menu.

Locked entities show a padlock icon after the entity name to indicate the locked state.

Locking an entity affects only that entity and does not have any effect on any of its descendants.

Selecting locked entities

Locked entities can only be selected in the Hierarchy View. Selection using the mouse in the 3D view is not possible.

Properties of locked entities

When a locked entity is selected, the properties panel can be displayed as normal and will show all of the usual content, but all editing features will be disabled. 

In this screenshot, the input fields have been disabled, and the “Add Component” function is also unavailable.

Unlocking an entity

Locked entities can be unlocked in one of two ways:

• Click on the padlock icon

• Use the “Unlock” function from the Entity Context Menu 

Within the Properties Panel, a smaller Hierarchy View displays the padlock icon and function menu, both of which can be used to unlock an entity

Tips & notes

Entity Locking can be useful in preventing inadvertent changes to completed design elements. It also helps simplify editing complex space designs as clicking a locked entity will clear the current selection set, ensuring your focus remains on active design elements.