Windchill System Customizations Report

Specialized Administration > Configuring Your Windchill Environment > Configuring Windchill Performance Advisor > Windchill Performance Advisor Report Information > 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.

Including other packages may impact the time taken to generate the report and increases the size of the report.

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

WindchillConfigClassifyReport.xml

Contains information about different types of load files.

WindchillAttributeUsageReport.xml

Contains information about the newly added columns as standard attributes to the model table.

WindchillIntegrationUsageReport.xml

Contains information about the third-party integrations.

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