Relationship Table Links
Relationship tables enable you to link related topics in a map.
Default Relationship Table Overview
You begin a relationship table by adding a reltable element to a map. To enable linking between the particular topics in a map, you insert the topicref elements into the appropriate relationship table cells. Heretto CCMS enables you to perform these actions by using an intuitive relationship table editor.
The default relationship table layout includes three columns that correspond to the following topic types:
- concept topic
- task topic
- reference topic
By default, relationship tables handle linking in the following way:
- Topics in a given table row link to each other
- Topics in the same table cell don't link to each other
In the following example “Concept A” links to “Task A”, “Reference A”, “Reference B” and “Reference C” because these topics are in the same table row
The following PDF output examples illustrate the default linking settings of a relationship table.
Customized Relationship Table Overview
Relationship tables are highly customizable. The following attributes enable you to adjust the most useful linking settings in your relationship tables.
- collection-type attribute
- Assigning the family value to the collection-type attribute of the relcell element enables linking between topics inserted in the same relationship table cell.
In the following example, the cell that contains the concept topics is configured to enable cell linking.
The following PDF output example illustrates linking between “Reference A”, “Reference B”, and “Reference C” inserted in the same relationship table cell.
- linking attribute
Assigning the sourceonly value to the linking attribute of the topicref element modifies the topic linking in the following way:
Prevents other topics from linking to the topic
Enables the topic to link to other topics
Assigning the targetonly value to the linking attribute of the topicref element modifies the topic linking in the following way:
Enables other topics to link to the topic
Prevents the topic from linking to other topics
The following PDF output examples illustrate “Concept A” with linking attribute set to targetonly value.
The following PDF output example illustrates “Concept A” that links to “Task A” with linking attribute set to the targetonly value. “Task A” does not link to other topics in the same relationship table row.
Consider using relationship tables if you want to reuse topics in multiple maps or reduce the number of dependencies between topics.
Keep the following considerations in mind when working with relationship tables:
- Relationship tables require little maintenance because every link is in the reltable map element.
- Heretto CCMS includes an editor that enables you to easily manage linking in relationship tables by dragging and dropping topics into the appropriate table columns.
- Relationship tables do not limit topic reuse because you link topics on a map level.
You can add multiple relationship tables to a map. It is useful if you plan to maintain a large number of relationship table links.
Keep the following considerations in mind when publishing maps with relationship tables:
- Relationship table links are published at the end of a topic in the “Related Links” section.
- If you publish to a print-friendly output (for example, PDF), links may reference a page number.
- Relationship table links resolve at publish by populating the link text with topic titles.