Upload an Ftmap with an Attachment - 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

Users with the ADMIN or KHUB_ADMIN role can attach files or URLs to an Ftmap when publishing it.

Example

The following Ftmap is an exhaustive example of the types of attachments which can be added to a Ftmap:

<ft:map xmlns:ft="http://ref.fluidtopics.com/v3/ft#" ft:lang="en-US" ft:originID="ftmap_id" ft:title="Time Machine User Guide"
ft:editorialType="book">
<ft:rights accessLevel="restricted">
<ft:groups>
<ft:group>Expert</ft:group>
</ft:groups>
</ft:rights>
<ft:metas>
<ft:meta key="Status" type="stringTree">Market-Ready</ft:meta>
<ft:meta key="Version" type="string">2.0</ft:meta>
<ft:meta key="audience" type="string">Expert</ft:meta>
</ft:metas>
<ft:toc>
<ft:node ft:originID="first_topic" href="topics/intro_to_time_machines.html" ft:title="Introduction to Time Machines" type="topic">
<ft:node ft:originID="origin_id" href="topics/how_to_time_travel.html" ft:title="How to Time Travel" type="topic">
</ft:node>
</ft:node>
</ft:toc>
<ft:attachments>
<ft:attachment>
<ft:filePath>attachments/drawing.png</ft:filePath>
</ft:attachment>
<ft:attachment>
<ft:originID>spare_parts</ft:originID>
<ft:filePath>attachments/Spare_Part_Price_List.pdf</ft:filePath>
<ft:filename>time_machine_spare_part_prices.pdf</ft:filename>
<ft:displayName>Spare Part Price List</ft:displayName>
<ft:mimeType>application/pdf</ft:mimeType>
</ft:attachment>
<ft:attachment>
<ft:originID>mounting_scheme</ft:originID>
<ft:url>https://timemachines.com/time-machine.jpg</ft:url>
<ft:displayName>Time Machine Mounting Scheme</ft:displayName>
<ft:mimeType>image/jpeg</ft:mimeType>
</ft:attachment>
</ft:attachments>
</ft:map>

Once uploaded successfully, the map attachments of the Time Machine User Guide are displayed in the Attachments tab of the Reader page. A Type icon appears to the left of the title of each attachment to help users know at a glance what type of content to expect before opening an attachment

For example, when redirecting users to a JPEG image available on a different web page, it can be helpful to display the JPEG icon and an arrow in the Reader page. To do so, add the filename with the image/jpeg MIME type in the <ft:mimeType> tag as in the following example:

...
<ft:attachment>
<ft:originID>mounting_scheme</ft:originID>
<ft:url>https://timemachines.com/time-machine</ft:url>
<ft:displayName>Time Machine Mounting Scheme</ft:displayName>
<ft:mimeType>image/jpeg</ft:mimeType>
</ft:attachment>
...

This prompts Fluid Topics to display icons showing users that Time Machine Mounting Scheme is both an external link and a JPG image:

An external link to the JPEG content as a map attachment