Locked

(1) If another user has started editing an object, all other users see that the object is locked by that user.

Please be aware there is no push mechanism – a refresh has to be triggered by the user to get the information. The user can do this by:

• Refreshing the list;
• Triggering roundtrip.

(2) If a user tries to edit the entity, an error message is displayed when clicking the Edit button. Other buttons that would update the object also trigger error messages.

Clicking the name in the error dialog opens the quick view of the user.

Expired Lock

(1) If case another user has started editing an object and the lock expires, all other users see that the object has been modified by someone else.

Please be aware there is no push mechanism – a refresh has to be triggered by the user to get the information, The user can do this by:

• Refreshing the list;
• Triggering roundtrip.

(2) If a user nevertheless tries to edit the entity, a warning message is displayed when clicking on the Edit button. Other buttons that would update the object also trigger warning messages.

Clicking the name in the error dialog opens the quick view of the user.

User 1 Tries to Save: Lock Expired

(1) When the lock time expired due to inactivity of the user and the object in work is not up to date anymore when the user tries to save it, an error message (2) is displayed informing the user that his or her changes have been lost. If no other user has started working on the entity in the meantime, the user can continue to work and the lock time is extended again.

Dialogs and Popovers

(1) An error message is shown if the lock expired due to user inactivity and the object is not up to date anymore when the user tries to save it.

(2) A warning message is shown when another user tries to access the edit mode of an object if the lock has expired but the draft of another user still exists.

(3) An error message is shown when users try to conduct any action in an entity that is locked.

(4) The quick view for the employee is shown when information on the person who locks an object is available and clickable.

(5) The popover is shown when the user clicks on the locked link.

(5.1) The popover shown when the user name is not clickable, as no user information is available.

(6) The popover is shown when the user clicks on Unsaved Changes.

(6.1) The popover is shown when the user name is not clickable, as no user information is available.

Tables

If you need to show that an item is locked in a responsive table,  place a transparent button in the first column or next to the key information.  Clicking the user name opens a popover with additional information.

If you need to show that an item is locked in a non-responsive table, provide an extra column for that information. Name the column header Editing Status. The column should be placed after the key information in the table.

Object List Item and Object Header

In case an object is locked, set the property markLocked of the object list item to ‘true’ and use the status property of the  object header to show by whom the object is locked. Existing status properties should not be overwritten, rather use an additional status line to guarantee that no information gets lost.

Object Page Header

If an object is locked, set the MarkLocked property of the object page header to “true”.

Clicking the icon displays the locking information as responsive popover (on desktops).

Form Sections

In some cases, only sections of an object might be locked. In order to indicate that a section is locked, use a button in transparent style with the corresponding icon (icon name: private) and the text Locked by [name] next to the Edit button in the section toolbar. Clicking the button displays additional information about the locked status.