Configure the Document Types panel

You can configure the contents of the Document Types panel in the Search View.

In the default configuration, the Document Types panel looks as follows (when the Maps type is selected):

The Document Types panel is configured in the equivalence.xml file. This file determines how DITA and custom objects are handled by the IXIASOFT CCMS interface. Objects that are designated as equivalent to topics, for example, display the same right-click menu options and are searched in a similar manner.

The following code shows the default configuration in the equivalence.xml file for the Maps document type:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE equivalences PUBLIC "-//ixiasoft.com//cms//config//equivalence" "equivalence.dtd">

<equivalences>
   <equivalence type="map" standardSearch="true" groupName="Maps">
      <object type="map"/>
      <object type="bookmap" icon="/system/conf/icons/bookmap-icon.png"/>
      <object type="subjectScheme"/>
   </equivalence>
	
...
</equivalences>

The following table describes the elements and attributes used to configure the Document Type panel:

Table 1. Elements and attributes of the equivalence.xml file

Element	Description
<equivalence>	Defines a top-level document type in the Document Type panel (for example, Maps, Topics, etc.) It has the following attributes:
	Attribute	Description
	type	Type of the object. This must be a valid type (for example, map, topic, resource, etc.). Mandatory.
	standardSearch	Indicates if this type is displayed in the Document Type panel. Valid values are true (type is displayed) and false (type is not displayed). This attribute is optional; if not specified, it defaults to true.
	groupName	Label displayed in the Document Type panel. This attribute is optional; if not specified, it defaults to the value of the type attribute. All the <equivalence> objects with the same group name will be organized in the same drop-down list. For example, consider the following configuration: <equivalence type="project" standardSearch="true" groupName="Others"> <object type="project"/> </equivalence> <equivalence type="snapshot" standardSearch="true" groupName="Others"> <object type="snapshot"/> </equivalence> Both project and snapshot will appear in the Others drop-down list.
<object>	Defines the items in the document type's drop-down list. It has the following attributes:
	Attribute	Description
	type	Type of the object. This must be a valid type (for example, map, topic, resource, etc.). Mandatory.
	icon	Specifies a link to the icon that should be used for this object in the view. The image must be stored in the Content Store. For example: <object type="bookmap" icon="/system/conf/icons/bookmap-icon.png"/>

Note: You should make these configuration changes in the Test environment and test them before copying them to the Production environment. In a dedicated SaaS deployment, after testing the changes, ask IXIASOFT Customer Support to copy the changes to the Production environment.

1. In the TEXTML Administration perspective, connect to your server.
2. Locate the equivalence.xml file in the repository's /system/conf collection.
3. Check out the file and open it for editing.
4. Make the necessary changes in the file.
5. Save, close, and check in the file.
6. Inform users of the changes.
   The changes will be applied automatically once users close and then reopen their IXIASOFT CCMS Desktop. Users can also apply the changes without restarting their CCMS Desktop by clicking IXIASOFT CCMS > Synchronize Configuration.