Detach an Ftmap Attachment - Fluid Topics - 3.7

Manage Map Attachments in Fluid Topics

Product
Fluid Topics
FT_Version
3.7
Category
Technical Notes

To detach a previously attached content from an Ftmap:

  1. Remove the <ft:attachment> corresponding to the map attachment to detach in the Ftmap.
  2. Reupload the updated Ftml project archive in Fluid Topics.

The attachment is not deleted in case it would be attached to another document in the portal. It is only detached from the document. All its related information (originId, displayName, and so on) are stored for any further use.

Example

In this scenario, the following Ftmap file was used to publish a map with a PNG image, a PDF document, and a URL as attachments:

<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:toc>
<ft:node ft:originID="origin_id" href="topics/how_to_time_travel.html" ft:title="How to Time Travel" type="topic"></ft:node>
</ft:toc>
<ft:attachments>
<ft:attachment>
<ft:originID>drawing</ft:originID>
<ft:filePath>attachments/drawing.png</ft:filePath>
<ft:filename>time_machine_drawing.png</ft:filename>
<ft:displayName>Time Machine Drawing</ft:displayName>
<ft:mimeType>image/png</ft:mimeType>
</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>

The ZIP archive used to publish this map and its attachments contained the following elements:

_time_machine_user_guide.ftmap
|_ how_to_time_travel.html
|_ attachments
|_ drawing.png
|_ Spare_Part_Price_List.pdf

In Fluid Topics, three map attachments are available for the Time Machine User Guide document.

Documents attached to FTML content

To detach the Spare Part Price List PDF which is currently attached to the map:

  1. Remove the <ft:attachment> corresponding to the PDF attachment in the 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:toc>
    <ft:node ft:originID="origin_id" href="topics/how_to_time_travel.html" ft:title="How to Time Travel" type="topic"></ft:node>
    </ft:toc>
    <ft:attachments>
    <ft:attachment>
    <ft:originID>drawing</ft:originID>
    <ft:filePath>attachments/drawing.png</ft:filePath>
    <ft:filename>time_machine_drawing.png</ft:filename>
    <ft:displayName>Time Machine Drawing</ft:displayName>
    <ft:mimeType>image/png</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>

    Only the PNG and JPG references are kept in the Ftmap.

  2. Upload a new ZIP archive of the project with the updated Ftmap and without the PDF file:

    _time_machine_user_guide.ftmap
    |_ how_to_time_travel.html
    |_ attachments
    |_ drawing.png

    Once republished, the Time Machine User Guide document has one PNG and one JPG map attachments. The PDF was detached.

    This map has now two map attachments instead of three