Rolling Forward an Object Version

You can roll forward an historical version of an object, making it the current version.

Before rolling forward a document that is referenced by other objects, ensure those references are not damaged by the process. Explore the relationships by using the Where Used relationship commands.

This command is available only for group members who are authorized to execute it. It is valid on structured documents, elements, files, and file versions, and can be invoked from the Show History dialog or the Workbench.

Tip: An Administrator Script, batchRollForward.py, is available to execute a batch roll forward operation on multiple objects. See Administrator Scripts.

If you are viewing a Show History dialog, select the record row for the version you want to roll forward and click Roll Forward.
The Roll [object name] Forward dialog appears:

Note: The As Of field is disabled when rolling forward an object from the Show History dialog.
1. Modify the Version Name if desired.
2. Modify or add to the Version Note text if desired.
If you are working in the Workbench, you can view a list of object versions (issue the List History command), then right-click an object in the view and click Roll Forward or in the Workbench Ribbon Versioning band, select an object and click .
The Roll [object name] Forward dialog appears:
1. Modify the Version Name if desired.
2. Modify or add to the Version Note text if desired.
3. Select the Source of the object to roll forward:
  Note: This option does not appear if you select a version using the List History command, and the As Of field is disabled.
  - If you select Date, provide a date in the As Of field.
  - If you select Version, select a version from the As Of field.
Click OK.

The historical version is copied as a new version of the object.

If you roll forward a structured document or element, only elements that were changed in the selected version are rolled forward. Changes to referenced elements that reside in other structured documents (such as conref targets) are not rolled forward.