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

Manage Map Attachments in Fluid Topics

Product
Fluid Topics
Fluid Topics Version
3.6
Category
Technical Notes
Language
English
Target Audience
public

All filepaths requested for map attachments must be absolute.

Example

To attach the Global Time Zones PDF file to the Time Machine Configuration Guide, prepare the following archive:

MA_time_machine_conf_guide.zip
|_ 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'?>
<controlFile>
<resources>
<resource>
<filePath>_time_machine_conf_guide.ditamap</filePath>
<instances>
<instance>
<filePath>2.0.ditaval</filePath>
<attachments>
<attachment>
<originId>Global_time_zones</originId>
<displayName>Global Time Zones</displayName>
<filePath>./map_attachments/time_zones_global.pdf</filePath>
</attachment>
</attachments>
</instance>
</instances>
</resource>
</resources>
</controlFile>

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.