Create a Fluid Topics control file - Fluid Topics - Latest

Unstructured Documents Connector Reference Guide

Category
Reference Guides
Audience
public
Version
Latest

All unstructured documents archives uploaded to the Knowledge Hub must include a control file.

The control file contains processing instructions and metadata used to enrich the uploaded content. The process to create the control file is documented in Create a Fluid Topics control file.

The control file must be named FluidTopicsControlFile.xml or FluidTopicsControlFile.xlsx, and must be located at the root level of the archive.

Users can validate their control file using the Control File XSD.

  • With unstructured documents, when defining metadata using an asynchronous control file, by default, the metadata defined in the control file replace the document's existing metadata.

    Use the action="append" attribute of the <meta> element to add a metadata key to a document's metadata, rather than replacing the existing ones.

    For example:

    <metas action="append">
        <meta key="example">
            <value>test</value>
        </meta>
    </metas>
    

    If the document already had the example metadata key, the test value is not added to the existing values of example. Instead, test becomes the new and only value of example.

  • When editing the ft:originId of an unstructured document, it is mandatory to use <originId>. Using the <metas> nod to force the ft:originId makes it impossible to edit the publication asynchronously.