Creating a Revision from an Existing Object

The New Revision From command allows you to create a new revision of a structure integrating changes from another structure, that can be one of its revisions, duplicates, or branches.

The New Revision From command allows you to also revise the children of the selected object.

With the New Revision From command, you can use the following objects to create the new revision:

  • Any revision of the selected object, in any branch of the revision family
  • Any revision of any duplicate of the selected object

In this page, the revised structure is referred to as the reference structure. The structure providing the changes is referred to as the source structure.

Important: For a successful execution of the New Revision from... command:
  • The selected revision and the latest revision must be in a revisable state. The Allow new revision from any revision option is ignored.
  • The reference structure must not contain different branches of the same reference, or different revisions of the same reference, or references belonging to the same component family.
  • The modified structure must not contain different branches of the same reference, or different revisions of the same reference, or references belonging to the same component family.
  • Objects in the reference structure and objects in the modified structure must have the same type.


Before you begin: Open the reference structure and the source structure in navigation or authoring tabs.
  1. Select the root node of the source structure and click the command.
  2. Select the root node of the reference structure you want to revise.
    The number of revised items and new items are listed in the Summary section. A B.I. Essentials section also appears, showing the status of each element of the source structure:
    Color Status


    To be revised


    To be inserted as new


    To be reused
  3. To modify the duplication status for the selected objects, in the tree or in the 3D area, select an object and select the required option.
  4. To modify the name of branches created with the To be inserted as new option, enter a prefix string in the Options section.
  5. To create the new revision, in the Options section, click OK.
    Depending on the type of the initial tab, the new revision appears in a new navigation or a new authoring tab. No further save action is required. The revised objects include the changes from the source structure.