Objects within the Tree Recycle Bin can be automatically deleted and/or purged on a scheduled basis by using the 'Schedule Empty Recycle Bin' feature. Recycle Bin emptying scheduling is similar to scheduling other processes in STEP (e.g., data imports, data exports, and bulk updates). The ability to schedule Recycle Bin emptying at designated times (e.g., overnight) frees users from time-consuming, manual tasks to empty the Recycle Bin, and allows the Recycle Bin to be regularly emptied with minimal or no user intervention.
Note: Scheduling is not available for the System Setup Recycle Bin. For more information on the System Setup Recycle Bin, refer to the Recycle Bin for System Setup topic in System Setup documentation here.
Configuring a Schedule Empty Recycle Bin Operation
To set a schedule for emptying the Tree Recycle Bin, follow these steps.
-
Right-click on the Recycle Bin in Tree and select Schedule Empty Recycle Bin to display the Schedule Empty Recycle Bin wizard.
-
On the Delete Options step, set the following options:
-
Delete objects after __ days in the Recycle Bin: Enter the number of days that an object must be in the Recycle Bin before it is deleted. The default value is 7. Refer to the Approve Deletion considerations below.
-
Approve Deletion: Select this option to remove objects and their children from the Approved workspace, which sends a DELETEAPPROVAL event.
Consider the following considerations for this parameter:
-
The 'Approve Deletion' parameter is not affected by the value provided in the 'Delete objects after __ days...' parameter. As a result, when the Schedule Empty Recycle Bin operation runs, if 'Approve Deletion' is selected, all objects in the Recycle Bin are removed from the Approved workspace, even if they have not been in the Recycle Bin for the specified number of days.
-
When an object is removed from the Approved workspace via 'Approve Deletion,' a DELETEAPPROVAL event is generated for that object. However, if the object is subsequently purged from the Recycle Bin as part of the same Schedule Empty Recycle Bin operation, the event is also deleted, since the object that the event is related to no longer exists in the system.
Therefore, if you have an event-based OIEP set up to capture DELETEAPPROVAL events, it is recommended to schedule this OIEP to start at more frequent intervals than the Schedule Empty Recycle Bin process, since the DELETEAPPROVAL event may disappear before the OIEP is invoked. For example, schedule the OIEP to start every minute and configure the Schedule Empty Recycle Bin process to run once a week.
-
-
Force Purge: Select this option to attempt to forcefully delete objects from the Recycle Bin that cannot be deleted via the standard Empty Recycle Bin operation. For example, with this option, objects in the Approved workspace can potentially be force purged from the Recycle Bin without having first been removed from the Approved workspace through Approve Deletion.
Note: To use the Force Purge option, the user who configures the Schedule Empty Recycle Bin process must have the 'Force Delete and Purge' setup action included in their user privileges. For more information, refer to the Setup Actions and Error Descriptions topic in the System Setup documentation here.
-
Click the Next button.
-
-
On the Select Contexts step, move the contexts from which to delete objects to the Selected list.
Note: In the rare instance that additional workspaces other than Main and Approved exist on your STEP instance, this step is named 'Select Workspace and Context' and a list of additional workspaces is displayed at the top of the wizard screen. Click the checkbox next to each workspace that you want to select.
-
On the Scheduled Execution step, determine when and how often to empty the Recycle Bin.
-
On the Name Process step, name the batch process for easy identification, and click the Finish button to complete the setup.
-
Scheduled Empty Recycle Bin processes are stored on the BG Processes tab (using the batch process name defined) under the Scheduled Processes node within Queued Processes. They display a status of 'waiting' and can be edited by clicking the 'Edit' button in the Status row.
