Create a topic template

You can create topic templates using the CCMS or an external XML editor and then add them to the CCMS system configuration to make them available to users of both CCMS Weband CCMS Desktop.

About this task

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

Procedure

  1. In the CCMS, create a topic with the required structure and text that is common to all topics based on this template.

    You don't have to create the topic within the CCMS, but doing so ensures that it already has the correct DOCTYPE.

    Tip: If using an existing topic as your starting point, clone the topic and rename it, then make the necessary changes.
    CAUTION: Avoid references to objects that can vary from document to document, because if these or their dependent objects are deleted or otherwise unavailable, topics created using the template will have errors.
  2. Export the topic from IXIA CCMS using Generate Output and selecting the Export output type.
  3. After saving or downloading the topic, rename the file so the template can be easily recognized by users.

    You might see other files in the export such as a customproperties file or an indexedcontent file. Disregard these files. You only need the topic itself.

  4. Open the topic template in a text editor.
  5. If necessary, remove all ixia_locid attributes and their values.

    If you are using an editor that can match regular expressions, you can use the following expression to find all instances: \b(ixia_locid)( |=)=? ?"\d+\b". This matches all occurrences of the ixia_locid attribute, along with values that have any number of digits.

  6. Optional: Add template variables.
    Variables are not generally required but certain use cases do require them. For more information, see Add custom variables to a map template.
  7. Save the template.