Changing the Revision of Objects
As the site administrator, you can use the wt.vc.ChangeRevisionLabelUtility command line utility to change the revision of objects that fit the following criteria:
• The object was created using one of the following types or a subtype of one of the following types:
◦ WTPart
◦ WTDocument
◦ EPMDocument
◦ EPMSEPFamilyTable
• The object has no view versions.
The revision label can be changed to a revision before or after the current revision but cannot skip revisions nor can it be set to an existing revision. For example, assume the following:
• The versioning scheme in place includes the alphabetic characters A, B, C, D, E, and F.
• The object has revisions A, C, and E and is currently at version E.
Then, the object can have its revision changed to either D or F, but not to B. If there had already been a revision D, then the only option would be to change the revision to revision F.
The revision label you specify must be a label that is in the current versioning scheme in place for the object type. For information about versioning schemes, see Object Versioning.
To obtain help instructions for this utility, enter the utility name from a windchill shell:
java wt.vc.ChangeRevisionLabelUtility
The following example changes the revision label of an existing part named part3 from A to B:
1. Open a windchill shell on the method server.
2. Enter the following command:
java wt.vc.ChangeRevisionLabelUtility -name part3 -oldRev A -newRev B
3. Enter the user name and password for the site administrator when prompted.
If there is only one part named part3 in the system that is at revision A, then the revision label is changed to B. If there are multiple objects with this name and revision label, the utility lists all of the objects using their object identifiers. You can copy the object identifier for an object from the list and reenter the command using the -oid argument instead of -name.
 |
To limit the search to a specific organization context, you can include the -org parameter.
|
This utility can be used when an initial data set has been loaded and you want to change the initial revision label for the objects that were loaded. For example assume you are using the MilSpec multicharacter series versioning scheme which uses hyphen (-) as the initial revision label and A as the next revision label. Using this utility, you can replace the hyphen with the letter A.