Revisions
It is important to understand how revisions work before performing any revise events on files.
With revisions, you can label a significant milestone or set of changes to a document and its related files. The label itself is the revision and the collection of files affected in that revision are considered a revision level. A revision level can be retrieved later so that a document and the version of the related files associated with that particular revision are preserved.
Understand Revisions
Review the following sections to learn more about revisions and how they work within the Vault environment.
What is a version?
A version is an iteration of a document and its meta-data that has been saved to the vault.
What is a revision?
A Revision represents a significant milestone in the history of a File/Item and its related children. The collection of files affected in a revision is considered a revision level, which is stored as part of the assigned revision label. A revision level can be stored and retrieved, ensuring that a document, Item, and related files associated with that revision are preserved. The revision is usually marked with a single character, such as A or B.
A revision is created with the Revise command. Revisions can also be automatically generated through a Lifecycle State change.
When a revision is downloaded from a vault, only one version within that revision is used to represent the revision. If lifecycles are not used, then the version is always the latest within that revision.
How are revision-controlled documents related?
When using documents that are related to each other, such as an assembly and its referenced components, a relationship is created between the specific revisions of those documents. When an assembly is checked into a vault, the revision of each of its components is recorded so that when that revision is recalled, each related document is retrieved using the recorded revision.
Editing a referenced file without creating a new revision
If a document references other files and those files are edited without bumping the revision, the referencing document will consume the edits. For example:
- Revision A of an assembly references revision B of a part.
- Changes are made to revision B of the part after revision A of the assembly has been checked in.
- The changes to revision B of the part will show in revision A of the assembly when it is next checked out.
Editing a referenced file after creating a new revision
If a document references other files and a new revision is created for one of those files, the referencing document still maintains a relationship with the original revision. For example:
- Revision A of an assembly references revision B of a part.
- A new revision of the part is created and labeled C.
- Edits are made to revision C of the part.
- The changes to revision C of the part will not show in revision A of the assembly when it is next opened from vault.
What does it mean when a revision is marked as released?
When a version in a revision is marked as released, it is given priority over newer versions and will represent the revision. This prioritization is known as a released bias and is an option that can be turned off in several of the dialogs.
Let's take a simple example where assembly is at Rev A and part is at Rev B.
- Revision A of the assembly references revision A of a part.
- Version 2 of the part is Released.
- Part is revised to revision B.
- A new version 3 of the assembly is created but still uses revision A of the part.
- Revision B of the part is also getting updated but is not being used by the Assembly.
The "Latest Approver" property describes the user who approved/released the last revision of a document. If an Administrator changed some properties in Vault for the released file, the "Latest Approver" displays a user that released the version.
The "Latest Release Date" property describes the date and time when the last revision of a document was released.
What does released biased mean?
Released bias indicates that released data should take priority over non-released data. It shows the latest file's version in the used revision. This option can be turned off.
What is the difference between Released bias and Revision bias?
Here is an example where we have an assembly and part both at Rev A.
- Released bias means that the display will use Rev A version 2 of the part and not version 3.
- Revision bias enforces that a Rev A of the assembly will always use Rev A of the part.
Let's see the Uses tab. The Uses tab lists the files used in the current model.
Click the view button /
to toggle between released/non-released bias. Note that the view button is for viewing only; it doesn't change the state of the file/component.
- Released bias shows all the components as a Released state.
- Non-released bias shows the latest state of all the components.
The Latest represents the latest revision/version that the parent is linked to. The intent is to display the latest/version of every component associated with the parent. However, it does not necessarily mean that the parent is currently using that version.
The Released refers to the released version. The intent is to display the released version that is consumed.
- When the Latest is selected with the Non-Released Biased view
, the Uses tab displays the latest file's version. It shows the current stage of all the components/sub-components.
- When the Latest is selected with the Released Biased view
, the Uses tab displays the released file's version if available.
- When a specific Revision is selected with the Non-Released Biased view
, the Uses tab displays the latest file's version in the used revision.
- When a specific Revision is selected with the Released Biased view
, the Uses tab displays the file's released version in the used revision if available.
What does leading or tip mean when referring to a version or revision?
The leading version, or tip version, is always the latest version of a file, even if Released Bias is enabled.
The leading revision , or tip revision, is always the latest version of the latest revision of a file, even if Released Bias is enabled.
How do revisions and lifecycles work together?
When used in combination with lifecycles, revisions can be generated automatically after a predefined event occurs. For example, the administrator can configure it so that when a file is moved from a work in progress to review state, the system automatically creates a new revision of the file.
What is a quick change?
A quick change is an edit made to a file without creating a new revision. Quick changes are invoked by setting a document's state to Quick Change and then modifying the file.