A Deleting Agile Objects

Java Client and Web Client support "soft" and "hard" deletes for many Agile object classes. When you soft-delete an object in the database, it is not permanently deleted. A soft-deleted object is marked "Deleted" in the database, and its object number or name is reserved. You cannot create another object with the same type and number or name as a soft-deleted object.

When you run a search, soft-deleted objects do not appear in the search results table. To locate soft-deleted objects, you must run the predefined deleted object searches in the Recycle Bin Searches folder.

You have access to the Recycle Bin Searches folder if Recycle Bin Searches is included in the Searches field of your user profile. If you have the appropriate privileges, then you can edit your user profile and add Recycle Bin Searches to the list of searches in the Searches field. If you do not have the appropriate privileges to modify the Searches field in your user profile, then ask the Agile administrator to modify your user profile.

A hard-deleted object is permanently removed from the database.

Caution: You cannot undelete a hard-deleted object.

To soft-delete, hard-delete or undelete an Agile object:

• You must have the appropriate Delete or Undelete privileges for that object.

• All relationships and subscriptions must be removed.

• The object must meet any additional conditions that determine whether it can be deleted or undeleted.

In general, if deleting or undeleting an object would cause the compromise of data integrity, the delete or undelete action is disabled.

A.1 Soft-Deleting an Object

When an object is soft-deleted, it is no longer available for use. However, until it is hard-deleted, its number or name is reserved in the Agile PLM database and cannot be reused.

To soft-delete an object in Java Client:

1. Select and open the object you want to delete.

2. Click the Delete button, and respond Yes to the confirmation prompt.

The object is soft-deleted.

To soft-delete an object in Web Client:

1. Select and open the object you want to delete.

2. Choose Actions > Delete, and respond OK to the confirmation prompt.

The object is soft-deleted.

A.2 Undeleting an Object

If you have the appropriate privileges, then you can undelete soft-deleted objects.

To undelete an object in Java Client:

1. Run the appropriate Deleted objects search from the Recycle Bin Searches folder.

2. Open the deleted object you want to restore.

3. Click the Undelete button.

To undelete an object in Web Client:

1. Run the appropriate Deleted objects search from the Recycle Bin Searches folder.

2. Open the deleted object you want to restore.

3. Choose Actions > Undelete.

You can click the Navigator button in the search results table to display the search result object links in the left pane NAVIGATOR drawer.

A.3 Hard-Deleting an Object

Soft-deleted objects still exist in the database. To remove an object permanently, you must hard-delete it. While an object is still only soft-deleted, you can undelete it. Run the appropriate Deleted object search from the Recycle Bin Searches folder.

To hard-delete a soft-deleted object (if you have the appropriate privileges) in Java Client:

1. Run the appropriate Deleted objects search from the Recycle Bin Searches folder.

2. Open the object.

3. Click the Delete Object button, and respond Yes to the confirmation prompt.

To hard-delete a soft-delete object (if you have the appropriate privileges) in Web Client:

1. Run the appropriate Deleted objects search from the Recycle Bin Searches folder.

2. Select the one or more object rows in the search results table.

3. Click the Delete button.

4. In response to the warning prompt, choose Continue and then click Finish.

5. Or, you can hard-delete one object at a time:

   • Open the object.

   • Choose Actions > Delete, and respond OK to the confirmation prompt.

You can click the Navigator button in the search results table to display the search results object links in the left pane NAVIGATOR drawer.