Configure what is available as a conref source

You can configure the Referable-Content view (CCMS Desktop) and the Reuse dialog (CCMS Web) to display reusable elements from any topic types.

About this task

The CCMS provides a specialized topic that you can use to store individual elements that you plan to use as conref sources—the referable-content topic type.. By default, the Referable-Content view and Reuse dialog only display elements that have an @id attribute and are contained in a referable-content topic. If you want to reuse elements from other topic types and make them available for use as a conref source, you need to change two indexes and a unit in the Index Definition file.

CAUTION: Be careful when editing the Index Definition document. Changes can significantly affect the indexing process, and any errors in the document can lead to data corruption or other errors. Consult with IXIA CCMS Customer Support before making changes if you are unsure.

Important: Make configuration changes in a test environment and confirm they work before copying them to a production environment.

Make these changes at a time when system use is at a minimum.

Procedure

Open the TEXTML Administration perspective.
Connect to a server in TEXTML Administration perspective.
Check out and open the Index Definition file.

Locate the reusable_element_id index.

<index NAME="reusable_element_id"> 
    <stringindex KEEPEXTRACTEDVALUES="True"> 
        <elements> 
            <element DEPTH="INFINITE" XPATH="//rcbody/*[@id]/@id"/> 
        </elements> 
    </stringindex> 
</index>

Replace the highlighted xpath with the expression which captures the elements you want to include in the Referable-Content view.
For example, to include all elements with the @id attribute contained in any topic type, replace the default xpath with:
```
<element DEPTH="INFINITE" XPATH="//*[contains(@class, ' topic/body ')]/*[@id]/@id"/>
```
Note: Because the CCMS is specialization-aware, using topic/body also indexes content from other topic types based on the <topic> element such as <task> (task/taskbody), <concept> (concept/conbody), and <reference> (reference/refbody).

Locate the reusable_element_name index.

<index NAME="reusable_element_name">
    <stringindex KEEPEXTRACTEDVALUES="True">
        <elements>
            <element DEPTH="INFINITE" XPATH="for $e in (//rcbody//*[@id]) return local-name($e)"/>
        </elements>
    </stringindex>
</index>>

Replace the highlighted xpath with the expression which defines the elements that you want to include.
To continue the previous example, replace the default xpath with the following:
```
<element DEPTH="INFINITE" XPATH="for $e in (//*[contains(@class, ' topic/body ')]/*[@id]) return local-name($e)"/>
```

Locate the reusable_units unit.

<unit NAME="reusable_units">
    <unitelements>
        <unitelement XPATH="/referable-content/title"/>
        <unitelement XPATH="//rcbody//*[@id]"/>
    </unitelements>
</unit>

Replace the highlighted xpath with the expression which captures the elements you want to search as a self-contained block of content.
To continue the example, replace the default xpath with the following:
```
<unitelement XPATH="//*[contains(@class, ' topic/body ')]/*[@id]"/>
```
Save, close, and check in the file.
Inform users of the changes.
The changes are automatically applied once users close and then reopen their IXIA CCMS Desktop. Users can also apply the changes without restarting their CCMS Desktop by clicking IXIA CCMS > Synchronize Configuration.