Addons

Functional Overview

Updated: March 18, 2024

As a Record Manager

As a record manager, you are responsible for the proper organization and management of the documents on the platform. You have to make sure that the retention rules are properly written, implemented and used.

Once the module is installed, different menus, sub-menus and actions are available throughout Nuxeo.

Retention Menu

A new retention menu retention-icon-main is available on the left side menu, including the following sub-menus:

Retention Actions

New actions are displayed on documents and result list:

  • retention-icon-main apply a retention rule to the document.

  • retention-icon-legal-hold apply/remove a legal hold to the document.

  • retention-icon-main override the retention of a document already under retention.

Retention Rule Document Type

A retention rule document type is available, it can only be created under the retention rules menu.

retention-screen-rules-menu
retention-screen-rules-menu

Permissions

Regarding access rights, this addon includes:

  • A RecordManager group.
  • A new Manage Record permission that allows users to create/edit retention rules, apply a retention rule to a document or a list of documents and override the retention of a document already under retention.
  • A new Manage legal hold permission that allows granted users to apply/remove a legal hold to a document or a list of documents.

Create a Retention Rule

To create a new retention rule:

  1. Go to the Retention menu.
  2. Click on Retention rules.
  3. Click on the Create button Create Button.
    The following creation popup is displayed.
    retention-screen-rule-creation
    retention-screen-rule-creation
General Information
Rule name Name of the rule displayed in the retention rules menu and when selecting a retention rule to apply to a document.
Description Description of the retention rule.
Status Select if the rule can be applied to the documents ("active") or not ("inactive").
Rule Application
Document types Filter for which document types the retention rule is applicable. If left empty, the retention rule will be available for all document types.
Period Starting Point
Immediate The retention period will start once you apply the retention rule to the document.
More details on the Focus on the retention types section.
Based on an event The retention period will start once the defined event occurs (after the retention rule has been applied to the document).
More details on the Focus on the retention types section.
Event type Select the type of event that will trigger the retention period. The list of available event types is defined using a dedicated vocabulary.
Event field value Fill in the value related to the event (contract number, employee identifier, loan reference, etc.)
Example: If I apply a retention rule to a document on January 1st, 2020 with the event "contract terminated", a retention period of 2 years, and the contract is closed on August 10th, 2020, then the retention will expire on August 10th, 2022.
Based on a metadata The retention period will start based on a defined metadata, once you apply the retention rule to the document.
More details on the Focus on the retention types section.
Metadata The path of the metadata to use. All date metadata from all schemas are available (default and local ones).
Retention Duration
Duration You can select the duration of the retention in years, months or days. The fields are aggregated to define the total retention duration.
Post Retention Actions
Actions You can select one or several actions to be automatically executed once the retention expires.
Examples: delete the document, notify specific users, export, etc.

Focus on the Retention Types

Immediate

The retention period will start once you apply the retention rule to the document.

Example: If I apply a retention rule to a document on January 1st, 2020 with a period of 2 years, then the retention will expire on January 1st, 2022.

retention-schema-immediate
retention-schema-immediate

Based on a Metadata

The retention period will start based on a defined metadata, once you apply the retention rule to the document.

This retention type is useful when the retention period depends on a past and external event. It can also be used for migration purpose (moving from a legacy records management system to Nuxeo).

Example: If I apply a retention rule to a document on March 15th, 2020 with the metadata "publication date", a retention period of 2 years, and the "publication date" is September 15th, 2019, then the retention will expire on September 15th, 2021.

retention-schema-metadata
retention-schema-metadata

Metadata-based retention rule are designed for past dates, not future dates.

Based on an Event

The retention period will start once the defined event occurs (after the retention rule has been applied to the document).

This retention type is useful for all cases where a document needs to be preserved from any deletion or change but the retention starting point is unknown at the beginning.

Examples: Contract terminated, Employee left the company, loan repayment, etc.

retention-schema-event
retention-schema-event

Edit a Retention Rule

You can edit an existing retention rule to change its status or settings.

The changes made on a retention rule are not retroactive. It will only affect the documents linked to the retention rule after the changes are done.
They won't be applied to the documents previously linked to the retention rule.

Once on the View tab of the retention rule:

  1. Click on the Edit button.
    A popup window is displayed.
  2. Update the rule.
  3. Click on Save button.

Delete a Retention Rule

You can delete an existing retention rule.

The deletion of a retention rule will not affect the documents previously attached to the rule. Those documents will keep their retention settings, including retention period and post-retention actions.

On the View tab of the retention rule:

  1. Click on the Delete button.
    A popup window is displayed.
  2. Click Confirm to delete the retention rule.

Put a Document Under Retention

To put a document under retention, you have to link the document to a retention rule.
By doing so:

  • The document will be automatically tagged as a record
  • The retention rule's settings will be applied to the document

This is an irreversible action, even as an administrator, meaning you can't unlink a retention rule to the document and you can't shorten the retention period.

After having linked a retention rule, the only available action is to extend the retention.

There are different ways to put a document under retention. You can attach a retention rule to a single document or to several documents in a row.

From a Document View

On the View tab of your document:

  1. Click on the More button and select Attach retention rule.
    A popup window is displayed.

    retention-screen-retention-popup
    retention-screen-retention-popup

  2. Select the retention rule needed from the drop-down list and click on Attach retention rule.
    A top bar is displayed at the top of your document to notify users that the document is, or will be, under retention.

    retention-screen-retention-document
    retention-screen-retention-document

From a Result List

After having performed a search from the retention search menu, a list of documents is displayed. Then, if you click on the Without attached rule quick filter, you can click on Attach retention rule icon retention-icon-main at the top-right of the screen.

retention-screen-apply-bulk
retention-screen-apply-bulk

Select the retention rule that you want from the popup window and confirm.

The retention rule will be applied on all the documents displayed on the page.

Extend the Retention of a Document

When a document is under retention, you can lengthen the retention of the document.

This is an irreversible action: there is no way to shorten a retention period, even as an administrator.

On the View tab of your document:

  1. Click on the More button and select Extend retention.
    A popup window is displayed.

    retention-screen-retention-extend
    retention-screen-retention-extend

  2. Select the new expiration date (end of retention period) and confirm.
    A top bar is displayed at the top of your document to notify users of the new expiration date.

    retention-screen-retention-document
    retention-screen-retention-document

Create a Retention Event

To create a new retention event:

  1. Go to the Retention menu.
  2. Click on Retention events.
  3. Fill the fields on the Fire event section:

    retention-screen-eventmenu
    retention-screen-eventmenu

  1. Click on Fire event.

At this stage, the event is created on Nuxeo Platform, and the retention rules fitting with this event will trigger the retention period for the involved documents.

The retention search is a dedicated search with criteria related to the retention management.

This search contains filters on:

  • The attached retention rule.
  • The expiration date (past and future).
  • The retention status (active retention, expired, not under retention).
  • The legal hold status.
  • The full-text content.

retention-screen-search
retention-screen-search

History on a Document

On the History tab of your document, you can see all the events related to the retention including:

  • Application of a retention rule to the document.
  • Beginning of the retention period.
  • Overriding of the retention period.
  • Application of a legal hold on the document.
  • Removing of a legal hold on the document.

General History

On the Administration > Audit page, you can see all the events related to the retention, including the retention events that have been created on the platform.

There are different ways to put a document under a legal hold. You can apply a legal hold to a single document or to several documents in a row.

From a Document View

Once on the View tab of your document:

  1. Click on More and select Apply legal hold.
    A popup window is displayed.

    retention-screen-legalhold-popup
    retention-screen-legalhold-popup

  2. Fill in the description and click on Apply legal hold.
    A bar is displayed at the top of your document to notify users that the document is under a legal hold.

    retention-screen-legalhold-document
    retention-screen-legalhold-document

From a Result List

After having performed a search from the retention search menu, a list of documents is displayed. Then, if you click on the Not Under legal hold quick filter, you can click on Apply legal hold icon retention-icon-legal-hold at the top-right of the screen.

retention-applyhold-bulk
retention-applyhold-bulk

Fill in the description field from the popup window and confirm.

The legal hold will be applied on all the documents displayed on the page.

There are different ways to remove a legal hold. You can remove a legal hold for a single document or for several documents in a row.

From a Document View

Once on the View tab of your document:

  1. Click on More and select Remove legal hold.
    A popup window is displayed.

    retention-screen-legalhold-remove-popup
    retention-screen-legalhold-remove-popup

  2. Click on Remove legal hold.
    The top bar displayed on top of your document doesn't display the legal hold anymore.

    retention-screen-retention-document
    retention-screen-retention-document

From a Result List

After having performed a search from the retention search menu, a list of documents is displayed. Then, if you click on the Under legal hold quick filter, you can click on Remove legal hold icon retention-icon-legal-hold at the top-right of the screen.

retention-screen-removehold-bulk
retention-screen-removehold-bulk

Confirm from the popup window.

The legal hold will be removed for all the documents displayed on the page.

Visualising Retention/Legal Hold Status

To help to easily visualize if any documents are under retention or legal hold when browsing, we added a - hidden by default - column named "flags column".
This column gives some extra details about the documents, such as if the document is a favorite, is under cold storage or if it's under retention or legal hold.

Flags Screenshot

Flags setting

Delete a Document Under Retention

Standard Mode

By default, apply a retention rule to a document is an irreversible action, meaning you can't delete a document under retention.

That being said, you can override this default behavior by using a specific role.

If the role NuxeoRecordCleaners has been created in the instance and assigned to a user with the Remove permission on a given document, the user will be able to delete the document under retention.

Compliance Mode

There is no way to delete a document under retention in the compliance mode.

As a User

Standard and Compliance mode
This page describes the user experience depending on the Retention Management addon mode among Standard or Compliance.

As a user, you will see some differences on the View tab of your documents:

  • There is an info header displaying Retention information or legal hold.
  • Some actions can be unavailable due to the nature of a document under retention or legal hold, or due to the functional limitations involved by the Nuxeo Retention Management addon.

The following tables describe the availability of document actions:

  • The action is available (depending on the user permissions) as for a standard Nuxeo instance,
  • The action is disabled for records, meaning the action is disabled only when the document is under retention or legal hold,
  • The action is disabled on instance, meaning it's disabled for all documents on the Nuxeo instance, due to some limitations coming from the Nuxeo Management addon.

With Standard Mode

Feature
Available Disabled for records Disabled on instance
Preview
Download
Export
Add to collection
Add to favorites
Add to clipboard
Notify me
Share
View permissions
Change permissions
View history
View publishing
Add tags
Start process
Lock
Edit metadata
Publish document
Replace main file
Delete main file
Delete document
✓*
Comments
Versioning
Add attachment

*: Delete a document is disabled for record unless the specific role has been activated and assigned to a user.

With Compliance Mode

Feature
Available Disabled for records Disabled on instance
Preview
Download
Export
Add to collection
Add to favorites
Add to clipboard
Notify me
Share
View permissions
Change permissions
View history
View publishing
Add tags
Start process
Lock
Edit metadata
Publish document
Replace main file
Delete main file
Delete document
Comments
Versioning
Add attachment