Change the handling of peer reference sources

You can specify the way DITA references with the @scope attribute set to peer are handled.

About this task

References with the scope attribute set to peer are used when the resource is part of your source, but may not be available when the output is generated. You can choose whether these references are handled as internal or external source types.

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

Procedure

  1. In the TEXTML Administration perspective, connect to your server.
  2. Check out and open the /system/conf/externaltypes.xml file.
  3. On the <externaltypes> element, set the @peerasexternal attribute value:
    • true: References are handled as external source type, regardless of their type
    • false: References are evaluated to determine if they are internal or external source types:
      • If the reference's's type is declared in the list of external source types, it is handled as an external source type.

      • If reference's type is not declared in the list of external source types, it is handled as an internal source type.

  4. Save, close, and check in the file.
  5. 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.