Change the handling of peer reference sources

You can specify the way DITA reference links with the scope attribute set to "peer" are handled.

References with the scope attribute set to "peer" are used when the resource is part of your source, but may not available when the output is generated. You can choose whether these references are handled as internal or external source types. The externaltypes.xml file, located within the Repository in the /system/conf/ collection, contains an attribute called peerasexternal that determines how peer references are handled.

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

To change the handling of peer reference sources:

  1. In the TEXTML Administration perspective, connect to your server.
  2. Locate the externaltypes.xml file in the repository's /system/conf/ collection.
  3. Check out the file and open it for editing.
  4. Change the peerasexternal attribute:
    Table 1. Attribute settings and results

    Attribute setting

    True or False

    Result
    peerasexternal True

    Handled as external source type, regardless of their type
    False

    Evaluated to determine if internal or external source types:

    • If link's type is declared in the list of external source types, handled as an external source type

    • If link's type is not declared in the list of external source types, handled as an internal source type
  5. Save, close, and check in the file.
  6. 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.