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.
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.
