Document selector - Fluid Topics - Latest

Empower Metadata with Fluid Topics

Category
Technical Notes
Audience
public
Version
Latest

Sometimes, topics share the same title but belong to different documents. These topics are grouped together as a single search result. A document selector provides a way to differentiate between different variants of the topic. It is necessary to open the document selector and select the document containing the desired variant of the topic.

Documents are not listed in a specific order in the document selector.

Example where only the document of origin makes the difference

The following example shows two variants of Introduction to Time Machines:

Document title Document of origin Audience Version

Introduction to Time Machines

Time Machine User Guide

Novice

1.0

Introduction to Time Machines

Time Machine Configuration Guide

Novice

1.0

Fluid Topics clusters both topics because they have the same value for the ft:clusterId metadata. The title of the document of origin is the only way to distinguish between the two variants of the topic.

When uploaded to Fluid Topics, a document selector appears below the topic's title in the Search page to let users select the appropriate variant.

Example where other metadata keys are multivalued

The following example shows the Introduction to Time Machines topic for which two variants exist and where each variant has its own metadata values.

Document title Document of origin Audience Version

Introduction to Time Machines

Time Machine User Guide

Novice

1.0

Introduction to Time Machines

Time Machine Configuration Guide

Expert

2.0

When the document containing the topic is uploaded to Fluid Topics, the variants are still clustered the same way. However, when users select a document, the tags that shows the values for the Audience and Version metadata keys are updated accordingly. For example, when a user selects Time Machine User Guide, the Novice and 1.0 tags appear. When a user selects Time Machine Configuration Guide, the Expert and 2.0 tags appear.