Terminate and Unterminate#
EntityTypeName.Terminate
EntityTypeName.Unterminate
Most system objects support termination and untermination, however, an object can only be unterminated if it still exists in the system (example: if it has not been purged yet).
Info
Each entity type has an associated defined retention time. Once this retention time has elapsed for terminated objects of that entity type, they will be purged from the online database.
Terminate Non-Versioned Objects#
EntityTypeName.Terminate
To terminate an object, open an Active or Created object, select More Actions in the top ribbon and choose Terminate. Optionally, you can enter a comment and select the Terminate button to complete the operation.
Info
To terminate an object, it must not be referenced as a target by other active objects.
Warning
If an object has references in generic or smart tables, those smart tables will be removed and they will not be recovered if the object is unterminated.
Terminate Versions#
To terminate an existing version, navigate to the entity details page, select More Actions in the top ribbon and choose Terminate Versions, then select the versions to be terminated. The versions available for termination will only be the ones that belong to the selected revision. A Reason may be required for termination if defined for the object.
Info
When terminating the complete object, the system will remove all entries in any generic and smart table rows where the particular object is referenced and this information will not be recovered on Unterminate.
Info
If there is only a single version in a specific versioned object, no version selection dialog will be displayed.
For more information, see Versions.
Terminate Revisions#
To terminate an existing revision, navigate to the entity details page, select More Actions in the top ribbon and choose Terminate Revisions, then select the revisions to be terminated.
Info
All versions that are associated to the revision that is terminated will themselves be terminated. If a default revision is terminated, another revision will be set as default if there is a revision that matches the preconditions.
For more information, see Revisions.
Unterminate Non-Versioned Objects#
EntityTypeName.Unterminate
To unterminate an object, open a terminated object and select Unterminate from the top ribbon. You can optionally enter a comment and a justification (the list of possible values is taken from the lookup table UnterminateJustification) and select Unterminate to complete the operation.
Info
When unterminating an object, relations are not recovered (example: when a Material is unterminated, the relations with Resource and Containers are not recovered).
Unterminate Versions#
A particular version cannot be terminated. However, if the complete object has been terminated (Terminate All Versions), it is possible to unterminate the complete object. When unterminating a versioned object it will refer to the effective version (if existing) or to the highest non-terminated version at the time of termination. To unterminate a versioned object it is necessary to provide a Change Set, so that it follows the same change-control process.
Unterminate Revisions#
Revisions cannot be unterminated, but the versions contained within the revision can be unterminated. The process is identical to the one used in Unterminate Versions, described above.
