Retention policy
Older and unused items must be removed from the system to prevent unnecessary database growth.
Retention policies can automatically assist in minimizing the database size. By default, the system does not provide any retention policies, and therefore all artefacts are retained indefinitely in the database unless they are manually removed.
Defining the retention period and the number of versions to retain for certain items helps in cleaning up unused items, managing database growth, and optimizing performance.
See Configure the retention policy.
Also see
Retention policies
in
Kofax TotalAgility Best Practices Guide.
- Version based retention
-
By default, all versions are retained. You can optionally retain a number of major versions of forms, processes (including skins), business rules, classification groups and extraction groups. For example, retain last 15 versions of a process.
For Custom retention, default is last 10 versions and minimum is 1 version.
-
A process version cannot be deleted if there is any job based on it (live or finished).
-
When a classification group or extraction group is removed, the project needs to be removed from Transformation Designer.
-
The extraction group can be removed even if there are documents that reference it. Therefore, there is no need to check existing documents.
-
- Time based retention
-
By default, items are retained indefinitely. You can configure the custom retention period.
The retention period is the number of days, months or years for which an item can be retained. Once the retention period is over, the item is automatically removed from the database.
You can define the retention period for the following:
-
Internal users: Where the end date is greater than the retention period.
-
External users: Where the end date is greater than the retention period.
-
Audit log entries: Where the date logged is greater than the retention period.
-
Documents: Where the LastAccessedAt date is greater than the retention period. After document deletion, if there are no documents left within folder hierarchy, the retention policy also deletes the root folder. The retention policy does not delete Online Learning folders or their subfolders.
-
Folders: Where the LastAccessedAt date of the root folders is greater than the retention period (the value from document retention is used) and if the folder hierarchy does not contain any documents, and the folder hierarchy does not contain locked folders. The retention policy does not delete Online Learning folders or their subfolders.
The retention policy does not delete the subfolders separately; they are deleted as part of root folder that matches the retention policy. -
KCM packs: Where the created date is greater than the retention period.
You can configure the retention period for a specific process to get jobs purged by the Retention Policy system task. The retention period defined at the process level takes precedence over the system settings.
-
- Retention process execution
- The Retention Policy system task handles deleting items from the database.
By default, the Retention Policy system task deletes all the jobs and documents that are ready for deletion. The Maximum jobs and Maximum documents settings indicate how many are deleted at a time while repeating the process until all jobs and documents that are ready for deletion have been deleted.
For example, if there are 1500 jobs and 2000 documents ready for deletion, when the Retention Policy task executes the first time, 1000 jobs and documents are deleted. When you repeat the deletion process, another 500 jobs and 1000 documents are deleted. When the Retention Policy task executes the next time, it will delete all the jobs and documents that are ready for deletion (in chunks of 1000).
You can define the maximum number of documents and jobs that can be deleted per retention task execution.
Retention policy system task
The Retention Policy system task handles deleting items from the database. By default, this system task runs once a week (minimum: 1 hour). If you want to review the items marked for deletion, the system task can be scheduled to run less frequently. On the contrary, if you want to delete the items without viewing them, the system task can be scheduled to run more frequently.
For example, if the retention policy system task runs weekly (on a Sunday) and a job is to be retained for 1 week:
- Job is completed on Monday (1st)
- The earliest the job can be deleted is Monday (8th)
- Retention Policy task runs on Sunday (7th). As the job is not ready to be deleted, it will remain in the system.
- Retention Policy task next runs on the following Sunday (14th). The job will now be deleted.
Depending on the frequency of the retention policy task in relation to the retention policy of the item, something to be retained for 1 week may actually take nearly 2 weeks to be deleted.
If you set the Retention Policy for a month, the system task deletes the items regardless of number of days in a month. For example:
-
System task executes on March 29, YYYY 17:00. If this is not a leap year, all jobs (based on Process ABC) completed and terminated before February 28, YYYY 17:00 are deleted.
-
System task executes on March 29, YYYY 17:00. If this is a leap year, all jobs (based on Process ABC) completed and terminated before February 29, YYYY 17:00 are deleted.