Keyword Locking - System Administration - On-Premises - English - Foundation 22.1 - OnBase - Essential - Premier - Standard - external - Standard - Premier - Essential

On-Premises System Administration

Platform
OnBase
Product
System Administration - On-Premises
Release
Foundation 22.1
License
Standard
Premier
Essential

To preserve data integrity, OnBase protects against situations where multiple users can change a document's Keyword Values at the same time. When a user accesses a document's Keyword Values from the Add/Modify Keywords dialog box or from the Re-Index dialog box, OnBase locks the values so that only the user who accessed them first can modify them. If any other users attempt to access the document's Keyword Values, the Keyword Values will be read-only, and the users will be unable to modify them. When the first user closes the dialog box, the lock is released, and other users can modify the document's Keyword Values.

This also applies to Keyword Values on OnBase E-Forms and Unity Forms. In addition, Keyword Values on an E-Form or Unity Form are also locked when a user opens the E-Form or Unity Form. This is because Keyword Values can be edited on the E-Form or Unity Form itself.

CAUTION:

There is one situation where two users can modify a document's Keyword values at the same time. Read the following information for a description of when this behavior is possible.

Two users can simultaneously edit a document's Keyword Values following this sequence of events:

  1. A user accesses Keyword Values twice from a single document by opening multiple Add/Modify Keywords dialog boxes, multiple Re-Index dialog boxes, or a combination of both.
    Keyword Values can be accessed twice from the same document in OnBase Web applications, such as the Web Client. The document can be opened in the main Web Client window and then opened again in different window using the Open in New Window option. The user can then open the Add/Modify Keywords dialog box or Re-Index dialog box from each window displaying the document.
  2. The user closes the first Add/Modify Keywords or Re-Index dialog box that was opened, keeping the other dialog box(es) open.
  3. Another user opens the same document and accesses its Keyword Values from the Add/Modify Keywords dialog box or the Re-Index dialog box.

In this situation, both users can modify the document's Keyword Values. By default, OnBase saves the values entered by both users, creating an additional instance of the Keyword Type for each Keyword Value provided. In the example above, if the first user saved a Keyword Value of BLUE and the second user saved a value of RED for the same Keyword Type, then another instance of that Keyword Type would be created on the document, and the document would be indexed with both BLUE and RED.

This behavior can be modified so that OnBase stores only values from the last dialog box from which the Keyword Values were saved. If this is the intended behavior, set ItemCacheTimeout in the Application Server's web.config file to 0.

Note:

Changing the ItemCacheTimeout value to 0 limits the Application Server's caching ability and can cause a decrease in performance.