Deleted Items

Cloud CMS provides a "copy on write" mechanism for any creates, updates or deletes to the content in a branch. This
means that whenever you delete something, you're actually masking it as deleted. The content itself is never
destroyed or removed permanently.

As such, it is always possible walk backwards in time and discover content that was deleted - all the way back to
the moment when your branch or repository was created.

To make things easier, Cloud CMS provides a "deletions" index that it automatically maintains per-branch so that you
don't have to manually walk the changeset history. This effectively works like the Mac Trash Bin or the Windows
Recycle Bin. It's a place where deleted items are stored, where you can inspect them and where you can restore from
should you wish to.

Browsing

Deleted Items are available on the left-hand menu within the Cloud CMS user interface.

[object Object]

This will bring you to a page that lists the deleted items. You can adjust how many to view and also select whether
you wish to see nodes or nodes + associations.

[object Object]

Depending on what roles you have, you may be able to do the following:

  • Purge a deleted item
  • View a deleted item in the API
  • Restore a deleted item to your branch

Purge a Deleted Item

This action will remove the deleted item from the deleted items index. Removing it from the index removes it from
the list of deleted items. That said, it doesn't actually purge the data from the underlying changeset history.

As such, Cloud CMS always allows you to go back in time to get at data as it once was. This is because of its
"copy on write" nature. You're always able to get back previous content should you need to.

View in API

This action will pop open a new browser window with a link to the deleted item in the API. This is mostly available
to assist content managers or developers who may be interested in the underlying JSON or binary attachments - all of
which can be inspected, retrieved or manipulated through the API.

Restore a Deleted Item

This action will find the deleted node in the changeset history and undelete it. Undeleting the node causes a new
node to be written onto a new changeset which is a continuation or undelete of the previously deleted node. In other
words, the undeleted node will be a flowing continuation of the lifecycle of the previous node. It will have the
same node ID and be a continuation of what once was.

Restored nodes are restored essentially as they were although the form will allow you to adjust the title and/or
description. Nodes are restored standalone which is to say that they are not connected to the content graph.

Any associations that the node may have had to the graph will need to be reinstated manually. The undelete process
cannot guarantee that restored associations would be consistent or validate given interim changes to your content
model, behaviors or relationships to other nodes in the graph.

Undeleting an association requires that the source and target node of the association exist. If they do not, an
error will be raised to indicate that they must be restored first.