Component Reuse

You can reuse topics and maps by adding them to multiple maps.

Overview

You reuse topics and maps by using topicref elements and mapref elements to insert that component into a map.

Figure 1. Component Reuse Operation.
The following diagram illustrates that:
  • “Topic A” is reused in “Map A” and “Map B”
  • “Topic B” is reused in “Map A” and “Map C”
  • “Map D” is reused in “Map B” and “Map C”
Tip: You can view detailed reuse information about every file in Heretto CCMS by right-clicking a file and selecting Links. The Links tab shows incoming links, outgoing links, or all file dependencies.

Example

The following example shows the behavior of the topic and map reuse indicator in the content library when you reference a file in your map.
Note: When the indicator is black, that means the component is used in a map somewhere within the content library. When the indicator is green, that means the component is reused in the currently opened map. The number indicates how many times the component is globally reused.
Figure 2. Map A
Reuse example
Figure 3. Map B
Reuse example
Figure 4. Map C
Reuse example

Reuse Components in the Content Editor

You can reuse components like topics or maps by using the Content Editor.

  1. Open a map in the Content Editor by clicking the Open icon or double-clicking the map.
  2. Right-click an element in a map.
  3. Do any of the following:
    • To insert a child component under an element in a map, select Append element > From existing file.
    • To insert an component before an element in a map, select Insert element before > From existing file.
    • To insert an component after an element in a map, select Insert element after > From existing file.
  4. In the Select File window, select a file.
  5. Click Select.

Reuse Components in the Map Editor

You can reuse components like topics or maps by using the Map Editor.

  1. In the content library, hover over a map and click the Dock button.
  2. In the content library, navigate to the component(s) that you want to add to the map.
  3. Drag and drop the component(s) from the content library into the Map Editor.
    Tip: A line appears that indicates where the component will be added. If you drop a component on another component, a green box appears. The green box indicates that the new component will be added as a child of the component that is already in the map.
  4. If prompted, from the Insert drop-down menu, select a relevant reference type and click Insert.
    Note: Your Heretto CCMS instance can be configured to automatically select the appropriate reference type for you. If you want to select the reference type on your own, you can hold Shift while dragging and dropping a resource into the map tree.

    To disable or enable the intelligent drag and drop feature, contact a Customer Success Manager.

  5. Click Insert.