Create a FluidTopicsControlFile.xml control file - Fluid Topics - 3.6

Upload Unstructured Documents to Fluid Topics

Version
3.6
Category
Technical Notes
Audience
public

In each package must be included a Control File containing all processing instructions and metadata that will be used to enrich your content (for example, setting facets without modifying the source content).

Package structure must be stable over time since folder structure is used to generate Fluid Topics internal identifiers for legacy documents but there are no restriction on how files are organized within each package.

This Control File must be named FluidTopicsControlFile.xml and must be located at the root level of the archive.

This file has a root node named ft:resources encompassing a list of ft:resource sub nodes.

The Control File must be validated using an XSD schema that is available online: Control File xsd.

Fluid Topics determines if a resource is a new resource, or a resource already existing in the Knowledge Hub that needs to be updated by comparing origId values. Therefore if you provide an origId, it is critical that it remains consistent over time. If you did not provide one initially, then Fluid Topics generates one based on the path+filename in the archive. This means that you should not set the origId value if you did not do so the first time and that you should always have the file located at the same position in the archives.

To create a FluidTopicsControlFile.xml Control File corresponding to your unstructured documents:

  1. Use the following template.
  2. Replace all ${variables} with information according to your content.