Downgrade Repository Customization
Repository is a directory in the Windchill codebase which contains artefacts that are used by the framework during downgrading. Downgrade is classified in two operations, transformation and filtering. These two operations support the following types of repositories maintained in the codebase/registry that are:
• XSL Repository, located at <windchill_codebase>/registry/XSLRepo/<Release specific directories>
• Filter Repository, located at <windchill_codebase>/registry/TransformationEngine/filter/<Release specific directories>
Out of the box Windchill provides qualified release-specific directories containing the transformation and filtering artefacts.
If you want to add custom artefacts to support your business requirements, you can create and define a custom repository using the following guidelines.
• You can perform customization of repositories on Windchill 11.0.M030 release or later.
• All the folders of the repositories should have correct release-specific prefixes as per the standard Windchill release convention.
For example, to add a custom path of transformation for Windchill 11.0 M030copy the Windchill 11.0.M030 folder provided out of the box and create a custom directory named 11.0.M030_Custom. Add the custom artefacts to the 11.0.M030_Custom folder. When adding custom artefacts, make sure you retain all the artefacts that are provided out of the box in this folder.
• After the 11.0.M030_Custom directory is created, the framework will be consumed as an enumeration called TransformRelease. Update the TransformRelease.java and TransformReleaseRB.rbinfo files with 11.0.M030_Custom entries. The custom directory must be customized using enumCustomize script present in $(wt.home)/bin folder to define your own display information. For more details on custom enumeration, see The Enumerated Type Customization Utility
To update the resource file:
1. Create a folder in xslRepo($WT_HOME/codebase/registry/XSLRepo) with the name 11.0.M030_custom (copy the required xsls from the existing folder).
2. Add entries in Windchill/src/com/ptc/transformation/TransformationReleaseRB.rbinfo as shown below:
11.0.M030_custom.value=11.0.M030 Custom
11.0.M030_custom.comment=Transformation release for 11.0.M030
3. Build the resource file and run the following command from Windchill Shell:
ant -f bin/tools.xml bundle -Dbundle.input=com.ptc.transformation.*
4. Restart Windchill.
5. Create a package and lock it. Create a base delivery and a downgrade delivery. Perform a downgrade for the release 11.0.M030_custom.
To update the resource using EnumCustomize utility, launch the utility and browse to com/ptc/transformation/TransformResource.ser file. Add the new resource (Display name: 11.0.M030 Custom, Key= 11.0.M030_custom)
• You can create multiple custom repository directories for same supported releases.
• You can evaluate and create your own release-specific path through the above-mentioned guidelines. However, PTC recommends that you apply customization to repositories for the releases that are supported out of the box.
 |
To ensure that all downgrade delivery entries and associated changes reflect in the UI, we strongly recommend that you restart the server after applying the changes.
|