Specifying Alternate Next Revision Labels
When an object is revised, the system automatically selects the next revision in the series by default.
To specify an alternate next revision label for an object that is using file-based or state-based versioning, add the following nested tag inside the value tag of the revision label for which you want to provide an alternate next revision label:
<revTo>alternate_revision_label</revTo>
where alternate_revision_label is a revision label that occurs later in the series.
The alternate next revision label is then used in place of the next revision label in the series when a revise operation takes place. For example, assume you have the following scheme defined:
<?xml version="1.0" encoding="UTF-8"?>
<scheme>
<series name = "name1">
<seed name = "seed_name1">
<value>P1</value>
<value>P2</value>
<value>P3</value>
<value>P4</value>
<value>P5</value>
</seed>
</series>
</scheme>
To specify in the above scheme that the next revision label for an object that is currently at revision P2 is P4 (instead of P3), modify the scheme as follows:
<?xml version="1.0" encoding="UTF-8"?>
<scheme>
<series name = "name1">
<seed name = "seed_name1">
<value>P1</value>
<value>P2
<revTo>P4</revTo>
</value>
<value>P3</value>
<value>P4</value>
<value>P5</value>
</seed>
</series>
</scheme>
After the modified scheme has been loaded, the next revision label for all objects using the scheme that are at revision P2 is P4.
To allow users to specify the next revision label when revising one or more objects, you can change the Allow Override On Revise preference that is listed under the Revise category in the Preference Management utility. For additional information, see Setting a Preference.
When users are allowed to override the next revision label, you can modify the file-based or state-based revision scheme to identify a list of alternate revision labels from which the user can choose.
* 
If you do not specify alternate next revision labels when users are allowed to override the revision label, the user can select from the next ten revision labels that are in the series being used. Specifying alternate next revision labels is only available in file-based or state-based versioning schemes and limits the selection to the specified labels.
To identify a list of alternate revision labels, modify your series by adding multiple revTo nested tags. For example, to specify both P4 and P5 as alternate next revision labels for P2, use the following:
<?xml version="1.0" encoding="UTF-8"?>
<scheme>
<series name = "name1">
<seed name = "seed_name1">
<value>P1</value>
<value>P2
<revTo>P4</revTo>
<revTo>P5</revTo>
</value>
<value>P3</value>
<value>P4</value>
<value>P5</value>
</seed>
</series>
</scheme>
Up to ten alternate revision labels specified for a given revision label can be listed in the interface where a user selects the revision label for an object. For example, assume the following:
A part is using the versioning scheme from the last example and is currently at revision P2.
The Allow Override On Revise preference is set to Yes.
Then the set revision icon is active on the Revise window and when a user clicks the icon, the Select Revision window that opens has a Select drop-down list containing P4 and P5.
If, in this example, you had not added the revTo tags to the series, the drop-down list would have contained all of the revision labels in the series after P2 (P3, P4, and P5).
* 
If you specify multiple revTo tags for a revision label and the Allow Override On Revise preference is set to No, then the system orders the labels that are in the revTo tags in the order they appear in the series and selects the first revision label in the list; the order in which they are entered in the revTo tags is not used.
Was this helpful?