Manage DITA Map Attachments with a Control File - Fluid Topics - 3.6 - Technical Notes

Manage Map Attachments in Fluid Topics

Fluid Topics
Fluid Topics Version
Technical Notes
Target Audience

All filepaths requested for map attachments must be absolute.


To attach the Global Time Zones PDF file to the Time Machine Configuration Guide, prepare the following archive:
|_ FluidTopicsControlFile.xml
|_ map_attachments
|_ time_zones_global.pdf

The FluidTopicsControlFile.xml must be located at the root level of the archive.

The following lines show an example of how to add the Global Time Zones PDF file to the Time Machine Configuration Guide DITA map in its variant 2.0 in the FluidTopicsControlFile.xml file:

<?xml version='1.0' encoding='utf-8'?>
<displayName>Global Time Zones</displayName>

When successfully uploading a control file through a source that is not of the Unstructured Documents type, the following information is provided in the History table of the Knowledge Hub interface: Published=0, Failed=0 and Rejected files=0. This is due to the fact that the control file is taken into account for the specified document but is not itself indexed, searchable or accessible in the Fluid Topics portal.
No failed or rejected file means that the upload was successful
More information about the upload can be consulted in the Dataflow interface of the Back Office.