Image Upload with Metadata - Fluid Topics - 3.9 - Technical Notes

Manage Images in Fluid Topics

Fluid Topics
Fluid Topics Version
Technical Notes
Target Audience

In Fluid Topics, Unstructured Documents are files intended to be indexed, such as PDF files, Word files, and so on. On Fluid Topics, users can consult or download them in the Document Viewer. To enhance the searchability of unstructured documents, metadata can be applied to these files by using the FluidTopicsControlFile.xml Control File.

Standalone image files are uploaded in Fluid Topics as Unstructured Documents. They can be indexed if metadata were set for them.

The metadata-provided standalone images can be searched for by different means:
  • You can filter them with facets: the ft:publication facet value. This facet gathers all Document name and all facet values defined in the Control File.

  • You can search for them using keywords, according to the metadata applied to the image, in the Search field.

Note: Images within a structured content cannot be assigned metadata and therefore they cannot be indexed. As a consequence, they are not searchable.
To send the two images time_zone_cheatsheet.png and standard_time_zones_of_the_world.png with related information:
  • time_zone_cheatsheet.png
    • Title: "Time Zone Cheatsheet"
    • Description: "This document helps you define a time zone to set for your time travel."
    • Category: TechDoc
  • standard_time_zones_of_the_world.png
    • Title: "Standard Time Zones of the World"
    • Description: "This document shows all the time zones available on the planet."
    • Category: TechDoc
  1. Add the images to the FluidTopicsControlFile.xml.
    <?xml version="1.0" encoding="UTF-8"?>
    <ft:resources xmlns:ft="" 
       <ft:resource xml:lang="en-US" id="time_zones_image" status="visible">
          <ft:dispName>Time Zone Cheatsheet</ft:dispName>
          <ft:description>This document helps you define a time zone to set for your time travel.</ft:description>
             <ft:facet name="Category">TechDoc</ft:facet>
       <ft:resource xml:lang="en-US" id="standard_time_zones_image" status="visible">
          <ft:dispName>Standard Time Zones of the World</ft:dispName>
          <ft:description>This document shows all the time zones available on the planet.</ft:description>
             <ft:facet name="Category">TechDoc</ft:facet>
  2. Prepare the ZIP archive. All files must be at the root level:
      ├── FluidTopicsControlFile.xml
      ├── time_zone_cheatsheet.png
      └── standard_time_zones_of_the_world.png
  3. Declare the metadata element in the and Search page configuration interfaces.
  4. Publish the ZIP archive through the Unstructured Documents processing pipeline.

These two images can be reached by the Category facet, by using TechDoc value. They are displayed with their display name, their description, and their Category tag in the Search Results page:
Images displayed in the Search Results page

Click on an image title to open it in the Document Viewer page.
Image opened in Fluid Topics Document Viewer