Emptying the Recycle Bin
As a system administrator, you are responsible for ongoing database maintenance and cleanup tasks, which include emptying the Recycle Bin and permanently deleting unused objects.
Important! Follow the database maintenance workflow described here: Database Maintenance Flow.
This page includes the following:
Prerequisites and Recommendations for Emptying the Recycle Bin
Make sure that you meet the prerequisites and consider the recommendations listed below:
-
You need the Database Maintenance (DB_MAINTENANCE) and Access to Recycle Bin (RECYCLE_BIN) privileges to empty the Recycle Bin. For more information, see Granting Automation Engine Privileges.
How to Empty the Recycle Bin
You can delete your operational data using the following methods:
-
Through AWI, using one of the following options:
-
From the Recycle Bin view in the Process Assembly, see Recycle Bin
-
From the Clients list using the Empty Recycle Bin database maintenance option, see Emptying the Recycle Bin through AWI below.
-
-
Through the REST API (Client 0) using the endpoint that facilitates emptying the Recycle bin, see AE REST API - Database Maintenance.
-
Using the AE DB Unload Utility, see AE DB Unload.
Emptying the Recycle Bin through AWI
In the Administration perspective, you trigger the process of emptying the Recycle Bin from the list of Clients, either in Client 0 or in a production Client. As soon as the process starts, an entry is written to the Client History list displaying its runID, its status and additional information such as name, type (which is always CLNTEMRB for this operation), and so forth.
To empty the Recycle bin, do the following:
-
Go to the Administration perspective and open the list of Clients.
-
Select the Client for which you want to empty the Recycle bin. If you are working in a production Client, this list contains only one entry. In Client 0 it contains multiple entries but you can only select one Client at the time.
-
Right-click and select Database Maintenance > Empty Recycle Bin. A dialog is displayed that prompts you to confirm your action.
A task of type CLNTEMRB is available in the Process Monitoring perspective and a report is generated that shows the number of records that have been removed from the Recycle Bin.
You can see the run listed on the Client History page. For more information, see Monitoring the Client History.
Once the process is completed, a dialog is displayed and lets you know if the Recycle Bin was emptied successfully or not. If some of the objects still contained unarchived operational data, they cannot be deleted and remain in the Recycle Bin.
In the Process Assembly perspective, you open the Recycle Bin view and click the Empty Recycle Bin button on the toolbar.
Emptying the Recycle Bin Using the AE REST API
You use the REST API to empty the Recycle Bin in on-premises, AAKE and Automic SaaS environments.
For more information, see REST API: Getting the Content of and Emptying the Recycle Bin.
See also: