Pessimistic Lock

 

In research administration, it is typical for coworkers to collaborate on putting together a single proposal.  Common to some e-docs (for example, Proposal Development documents) is a feature known as ‘document locking’ that allows for more than one person to be able to edit the same document. 

The Pessimistic Lock Lookup screen allows you to search for and delete locks on e-docs that are locked for editing by particular users.  Pessimistic Locks (also referred to as Document Lock or Current Lock) is a function that allows Administrators to delete pessimistic locks on documents to enable editing of those documents by a user other than the current lock owner (typically the document’s Initiator).  This functionality allows you to search for currently-locked documents and remove the locks one at a time.  The user who is the lock owner needs to be notified in advance of a lock deletion because when it is no longer locked, another user may edit and save the document first, which not only gives them the lock instead, but it also could prevent loss of work by the original lock owner. 

Delete Permissions:  In order to have the ability to perform document lock delete actions, a user must be a member of the WorkflowAdmin workgroup.

Timeout Considerations:  The system may “time out” after a period of inactivity which could result in lost work and require logging in again.  Consult your System Administrator for specific duration and consequences.  The KC default is 60 minutes.  Upon a session expiration, document locks will be released.  Each time you click the save button (or navigate to a new page), the timer is reset.

Best Practices-Notification & Saving:  When more than one user has accessed and is editing the same document at the same time, there are document locking rules that can be quite complex to a new KC user regarding this that, when not followed, could result in loss of data entry work.  It is recommended practice that after you have been notified that a document you own a lock on will have that lock removed, you copy data and text you have entered into fields that you have not yet saved and paste it into a text file (for example, Notepad), so it will not become lost work.

Figure 1450 Pessimistic Lock Lookup Screen – Search Criteria Section Example

Figure 1451 Pessimistic Lock Lookup Screen – Search Results Table Example

 

Table 899 Pessimistic Lock Lookup Screen – Result Table Column Descriptions

Column

Description

Lock Owner

The user Id of the person who initiated the document.

Lock Descriptor

The document number followed by a dash and then the document type (for example, 2185-PROPOSAL).

Generated Time

The time the lock was generated, which is the time the document was initiated.

Document Number

The unique numeric value that represents this particular e-doc in the system.

Actions

Click the delete link to remove a document lock.

  To remove a document lock:

1.  Enter criteria as desired and click search.

2.  Click delete in the Actions column for the document you want to unlock.

note.png

You are returned to the System Admin menu.  If you search again, you will see that the document you deleted no longer appears in the result table.

Figure 1452 Locked Document Access Attempt When You Do Not Have Permission

 

Figure 1453 When You Need To Edit A Locked Document, You Can Be Added Via the Permissions Page

 

Figure 1454 Notification of Locked Document When You Do Have Permission to Edit By Reloading