Users can use the FluidTopicsControlFile.xml or FluidTopicsControlFile.xlsx file to define metadata for each topic file present in the archive by following the instructions described in Define topic metadata.
To define a topic's ft:originId, Fluid Topics normalizes its title as follows:
- All characters are in lower case.
- Spaces become dashes (
-). - All special characters are removed, except dashes (
-), underscores (_), and periods (.). - All characters before the first letter are removed.
- If a topic title is used multiple times through a document, it becomes numbered (title, title-1, title-2, etc.).
- In the case of a possessive "'s", the apostrophe is removed entirely. For example, "Define a topic's metadata" becomes
define-a-topics-metadata.
To define and update a topic's metadata it is necessary to use a synchronous control file.
Example
The following FluidTopicsControlFile.xml or FluidTopicsControlFile.xlsx shows an example of defining metadata for a topic:
metadata sheet
| document (filePath) | topic (originId) | ft:originId | ft:clusterId | ft:title | ft:originUrl | ft:description | ft:lastEdition | Product | |
|---|---|---|---|---|---|---|---|---|---|
| path/to/document_id.docx | original-topic-id | new_origin_id | new_cluster_id | new_title | new_origin_url | new_description | new_last_edition | new_product_name |
<?xml version="1.0" encoding="UTF-8"?>
<controlFile>
<resources>
<resource lang="en-GB">
<filePath>path/to/document_id.docx</filePath>
<topics>
<topic>
<selector>
<originId>original-topic-id</originId>
</selector>
<originId>new_origin_id</originId>
<clusterId>new_cluster_id</clusterId>
<title>new_title</title>
<originUrl>new_origin_url</originUrl>
<description>new_description</description>
<lastEdition>new_last_edition</lastEdition>
<metas>
<meta key="product">
<value>new_product_name</value>
</meta>
</metas>
</topic>
</topics>
</resource>
</resources>
</controlFile>