globe with meridians Language: Deutsch · English

open book Locking logic

Lock and unlock individual records via rules – with an owner attribute and the Lockable interface.

REFERENZ DEVELOPER UPDATED: JUL 2026 APPLIES TO NUCLOS 4.2026.X

On this page

What is the locking logic?

The locking logic locks individual records via rules and unlocks them either manually or by rule. When enabled, the business object automatically gets the system attribute owner.

A locked record with owner display.

Enabled in the BO wizard (step Rights & locking).

Locking in the BO wizard.

Configuration

Lock mode: OWNER API ONLY – lock by setting the owner via a rule.
Owner display: user ID, „last, first“, „first last“ or e-mail.
Unlock mode: API ONLY (rule only) or ALL USERS MANUALLY (rule or manual).

Use in rules

BOs with locking implement the Lockable interface. Calls do not increase the version number and are immediately visible:

MethodEffect
.lock()lock now; only the current user can edit
.lock(UID ownerId)lock now for the given user
.unlock()unlock now
.unlockAfterCommit()unlock only after a successful commit (e.g. long-running jobs)

Usage & Nuclet import

Once an owner is set, edit/delete/status change are allowed only for the owner; the toolbar shows the owner plus an unlock button.

Import

The Nuclet import enables locking once but never removes or changes an existing locking configuration – otherwise dependent rules would stop compiling.

Related pages

puzzle piece Business object


Enable locking.

Open →

open book Server-side rules


Lock via rule.

Open →

  • Keine Stichwörter