Article last updated on the 8th of November 2019.
3.2. Adding triggers
Declaring an entity as a record is one way to effectively lock an entity and disabling editing the entity, documents and items located on the entity. This can technically also be done by removing add/edit/delete permissions from the entity, but this makes it difficult to restore access at a later time if necessary. The advantage of declaring or undeclaring an entity as record is that access can easily be restored simply by undeclaring the entity as record.
Declaring and undeclaring entities as records can be done using the Action Management feature using the "Lock" and "Unlock" actions.
Declaring/undeclaring as record is part of the Action Management feature, which requires an Action Management license. Please contact WorkPoint Sales at email@example.com for more information about how to acquire an Action Management license.
Configuring the "lock" and "Unlock" actions which enables declaring and undeclaring entities as records can be done through action management:
- Click the "Home" button of the solution.
- Click the cog icon to access the WorkPoint Administration.
- In the WorkPoint Administration, click the header of the business module which entities you wish to be able to declare and undeclare as records.
- Click the "Action Management" menu item.
3.1. Adding a Lock Entity action
Please note that the following sections describe the process of setting up a lock entity action which works with record management as well as a trigger to activate the action. The same procedure can be used to set up an unlock entity action and an associated trigger.
- In the "Actions" section, click "Add Lock Entity Action".
The "Add Unlock Entity" action can be used to unlock entities which have been locked using the lock entity action with Record management.
- Give the Lock Entity action a name.
- the action can be set either active or inactive. In this example, the action is left active.
- Select "Record" for Entity lock type.
3.2. Adding triggers
Actions need to be combined with a trigger, which starts the action. Actions can be set up to trigger when an entity is created, when an entity's stage is changed, or manually by pressing a button. In this case, we will use a button to trigger the "Lock Entity" action we created in section 3.1.
- In the "Action Triggers" section, click "Add Manual Trigger".
- Give the action trigger a title.
- Select which permission level is required for using this trigger. Options are "require read permissions on entity" and "Require edit permissions on entity".
- Click the empty field for "Actions".
- Select the Lock Entity action which was created in pt. 3.1.
- Click the "Add" button to the right of the "Actions" field.
The interface now looks like in the following image:
- Click the "Add" button in the bottom of the window.
4. End user guide
4.1. Declaring entity as record
Consider the following documents library on the "Design of Bike0114" entity on the Projects module of this solution:
- The documents library contains a test document, which is fully editable, provided the user has the permission required.
- Clicking the button created in pt. 3.3. will declare the entity as a record, and lock editing of documents and items located on the entity.
The following window appears when the button is clicked:
Please allow WorkPoint a few seconds to complete the lock entity job.
Once the entity is declared as record, the documents in the documents library lets the user know that they are locked for editing:
- Hovering over a locked document shows the file icon with a padlock to indicate that the document is locked for editing.
- The "System Account checked out this item" text is another indication that the document is locked.
Furthermore, the documents overview shows a "Checked out" icon for each document and item that is checked out:
Additionally, an e-mail notification is sent to let the user know that the entity has been locked.
4.2. Undeclaring entity as record
Consider the following documents library:
The document in the documents library is currently locked for editing, which has been done by declaring it as record.
Undeclaring an entity as record, effectively re-opening up items for editing, works in almost the same way as in pt. 4.1. In this case, we have set up a button for a manual trigger, which triggers an Unlock Entity action:
- Clicking the "Unlock Entity" button rolls back the lock on items on the entity, effectively re-opening the entity for editing. The following window is displayed:
Please allow the WorkPoint System a few seconds to complete the job. Upon completion, the documents are now open for editing. The padlock is gone from the file icon, and the document is no longer displayed as "Checked out":