Show TOC

Function documentationDiscard Changes

 

You have several options for a discard changes operation:

  • A discard changes operation may be triggered for individual elements or subtrees.

  • A discard changes operation may be triggered by the context menu in the browser view, list view or search result view.

  • A discard changes operation may be triggered for multiple selected elements.

A discard changes operation can have the following effects:

  • The changes in the branch are removed for the selected elements by a successful discard changes operation. All selected elements are reverted to the version of the parent branch.

  • Elements that you have created newly in the branch are deleted immediately by a successful discard changes operation.

  • Deleted elements in the branch which also exist in the parent branch are restored in the branch by a successful discard changes operation.

  • The change status of the selected elements is affected by a successful discard changes operation That means that all selected elements have the change status Unchanged after a successful discard changes operation.

  • The Solution Documentation content in the parent branch does not change.

  • An attempt to perform a discard changes operation fails if the operation is not allowed. For a failed discard changes, an error message is issued and all elements and their change status remain unchanged.

  • In the production branch no discard changes operation is available at all since there are either no changes allowed or all changes are performed finally without releasing them.

Discard Changes for an Element

You can discard changes per element individually by triggering the discard changes operation in the context menu under Element Changes for selected elements which have been changed in the branch and thus have a change status different from Unchanged. The discard changes operation for an element is available for all changed elements in the context menu.

A discard changes operation for an element has the following effects:

  • The changed elements are reverted to the parent branch version and then the change status is Unchanged.

  • Newly created elements in the branch are deleted finally.

Discard Changes for a Subtree

You can also discard changes for entire subtrees by triggering the discard changes operation in the context menu under Subtree Changes for selected subtree root elements. Any changes in the branch in the selected subtrees are removed. The discard changes operation is also available for subtrees which are completely unchanged. In this case nothing happens.

A discard changes operation for a subtree has the following effects:

  • All changes of the selected subtree are removed from the branch.

  • After successfully discarding the changes of a subtree, the change status of all remaining elements in the subtree is Unchanged.

Discard Structure Changes

You can also discard structure changes and thus the structure is reverted back to the parent branch version.

A discard changes operation for a structure has the following effects:

  • An element move affects only the change status of the element moved, the change status of the new parent element is not affected.

  • The discard changes of a moved element moves the element back to the parent branch version

  • Changing the target element of a reference element affects only the change status of the reference element, the change status of the new target element is not affected

  • The discard changes of a reference element with a changed target changes the target back to the parent branch version

  • After successfully discarding the changes of an element the change status is always Unchanged.

Not allowed Discard Changes Operations

A discard changes operation may not be allowed for a specific selection of elements or subtrees. A discard changes operation is forbidden if this would lead to dangling references in the Solution Documentation.

There are two possible situations in which a discard changes operation are not allowed:

  • A discard changes operation is not allowed for a newly created element in the branch if the new element is used as a reference target and the affected reference element is not contained in the selection for the discard changes operation.

  • A discard changes operation is not allowed for a newly created element in the branch if the new element has children elements that are not contained in the selection for the discard changes operation.

If you try to perform a discard changes operation, the system display an error message and nothing is changed.