Windchill System Customizations Report
The utility gathers the details of modifications made to your Windchill system and generates the WindchillSystemCustomizationsReport.xml report. The report is useful to identify the customization and configuration changes in a Windchill installation when you plan to migrate, update or upgrade your Windchill system.
When Windchill is installed, a serverbasereport.xml file is generated at Windchill/utilities/SHA1BaseReports. A new serverbasereport.xml file is generated during upgrade of Windchill. The serverbasereport.xml file is updated during update. The utility compares the modified files and directories with the server base report of entire Windchill codebase and default configuration files to generate the customization report. During installation, upgrade or update, the properties file in server base report, site.xconf and declaration.xconf are archived.
 |
PTC strongly recommends that you must not modify server base report file.
|
Using the information from the categorized WindchillSystemCustomizationsReport.xml about files that were modified for customization purposes, those files are further compared with the OOTB files that are stored in wtsafeArea or wtcustom to generate comparison reports. The basis for categorization is shown in the following figure:
 |
The customizations made to ignore list are not included in the customization report.
|
You can set the frequency of report generation to every two weeks or every month.
Reports Information
The following reports are generated as a zip package. The reports can be found in the customization folder in the zip file, along with System Customization Report.
|
Report
|
Information
|
File Type
|
||
|---|---|---|---|---|
|
WindchillSystemCustomizationsReport.xml
|
Contains information about all the modifications made to your Windchill system, such as class files or property files as part of customizations.
|
Refer the categories image
|
||
|
WindchillSystemsAPIUsageReport.xml
|
Contains information about methods that are invoked for newly added customized class files
Out of the box, utility extracts information only for Windchill API, File Access and Database Access . To include other packages such as java.lang, java .util, use the following property sha1id.directory.process.list in wt. properties file.
|
jar, class
|
||
|
WindchillSystemsBinaryComparisonReport.xml
|
Contains information about the methods or fields that were added, modified, or deleted.
Files in WT_HOME are compared with those in the wtsafearea or wtcustom directory to identify the modifications.
|
class
|
||
|
WindchillPropertyComparisonReport.xml
|
Contains information about the changes made to all property files in the Windchill system. The report lists all the properties that were added, modified, or deleted as part of customization.
The report includes original values and new values of the properties.
|
properties
|
||
|
WindchillXMLComparisonReport.xml
|
Contains information about changes made to all Windchill xconf file and xml files. The report includes original values, new values and new properties that are added to site.xconf or declaration.xconf
|
Xconf
|
||
|
WindchillDBSchemaComparisonReport.xml
|
Contains information about any changes made to tables and constraints within the database.
|
DBSchema
|
The utility also generates log files along with the comparison reports. You can use log file to check the status of report before sending it to PTC.
Property information
By default, customization report is generated for the following directories: Srclib, codebase, tasks, loadfiles, db, WHC and wtcustom. The sha1id.directory.process.list property in wt.properties defines the directories for which a customization report is generated. If you want to include more directories, add the name of the directories to the sha1id.directory.process.list property.
Sample Reports
• System Customizations Report
• API Usage Report
• Binary Comparison Report
• Property Comparison Report
• XML Comparison Report
• DBSchema Changes Report
