Customizing XML files

The information presented by the TCM application is controlled by various XML files. You can modify these files to customize the information displayed, and to change the appearance or presentation of the information.

Unless otherwise specified, the files that you modify when you customize the application must be checked out of the Collaboration object store using FileNet Enterprise Manager. You check out the file, edit it, and then check it back in. If you are creating new security roles for users, you will be adding new files as well as editing some of the files provided by default.

After you make a change to one or more of the configuration files, recycle the Application Server (Tomcat, Weblogic, etc.) to eliminate any cached copies of the file, then restart the Collaboration Engine.

Document classes for TCM customization files in the object store

When you edit or create a new customization file and check it back in, you must select the correct document class for the file. If you do not specify the correct document class, the system may not recognize the file or handle it properly. The table below lists the document class for each of the configuration files that you may need to edit.

Collaboration Object Store file Document class
Teamspace Member Role.xml, Teamspace Administrator Role.xml, or other role definition files Collaboration Security Role Definition
Collaboration Access Alias Definitions.xml Collaboration Configuration
Collaboration Enterprise Security Definitions.xml Collaboration Configuration
Collaboration Applications.xml Collaboration Configuration
Collaboration Email Template Maps.xml Collaboration Configuration
Collaboration Meeting Definitions.xml Collaboration Configuration
Collaboration User Subscription Definitions.xml Collaboration Configuration
Collaboration Workflow References.xml Collaboration Configuration
[email templates] Collaboration Configuration

Configuration files in the Collaboration application folder

Configuration file Default installation location

TCMConfig.xml

See Customizing the TCMConfig.xml file for more information.

C:\Program Files\FileNet\Collaboration\Web\WEB-INF\config

appconfig.xml

See Customizing the appconfig.xml file for more information.

C:\Program Files\FileNet\Collaboration\Web\WEB-INF\config

The XML files are documented with embedded comments that describe the tags and modules you can customize.

For specific information on how to modify XML files, refer to one of the many third-party products designed specifically for editing XML.