You can reduce or extend the change scope of a project only when the change action is active and has been claimed to the current project.
For more information about change actions, see Create and manage changes to 3D content.
The scope of an object can be extended or reduced if:
-
Any existing change actions related to the object are in the Design_Complete state.
-
The signature provided by the authoring tool matches the primary signature on the change action.
A change action has a primary signature and can have multiple subscribing signatures.
The primary signature is used for making any changes to an object, and the subscribing
signatures are used only for viewing objects.
-
To view the objects associated to a change action, click Change Management > Change Actions, and click
next to the change action.
-
If you encounter a transaction deadlock error while extending, reducing, or transferring from a change action, it might be because another user is working on the same set of objects using an operation like Extend, Reduce, Transfer, or Cancel which locks objects. Retry the operation again later.
Extend the change scope
Execute the ValidateChangeScopeExtension API to obtain a list of all the valid objects that can be extended and then call the ExtendChangeScope API.
The ExtendChangeScope API allows the object to be claimed to the project and creates a relationship with the current change action. If the object has already been claimed, a relationship is created between the object and the change action.
Reduce the change scope
Execute the ValidateChangeScopeReduction API to obtain a list of all the valid objects that can be reduced and then call the ReduceChangeScope API.
The ReduceChangeScope API:
-
Unclaims the object from the project only if the object is not related to any change action in the Design_Complete state.
-
Restores the object to its previous state if the object is related to any change action in the Design_Complete state.
-
If an object is related to multiple change actions in the Design_Complete state, the object is restored to the latest change action.