Attach a URL to an Ftmap - Fluid Topics - 3.7

Manage Map Attachments in Fluid Topics

Product
Fluid Topics
FT_Version
3.7
Category
Technical Notes

To add a URL as a map attachment to an Ftmap, add the following lines to the FluidTopicsControlFile.xml file:

<?xml version='1.0' encoding='utf-8'?>
<controlFile>
<resources>
<resource>
<originId>$FTMAP_ID</originId>
<attachments>
<attachment>
<originId>my_attachment</originId>
<displayName>My link</displayName>
<originUrl>$URL_TO_ATTACH</originUrl>
<mimeType>$MIMETYPE_OF_THE_URL_TARGET</mimeType>
</attachment>
</attachments>
</resource>
</resources>
</controlFile>

Where:

  • resource
    • originId expects the ft:originID defined for the Ftmap in the Ftmap file. It can be retrieved from the Metadata Journal, in the ft:originId field. If no ft:originID was defined, it takes the Ftmap filepath value.
  • attachment
    • originId is the ID given to the file to attach. Make sure that the originId is unique within ALL the Ftmap attachments.
    • displayName is the title of the file to attach. It is displayed in the Attachments tab and can be clicked for a direct access to the attachment. In the case of reusing an existing map attachment, if the displayName does not match the initial one, then it overrides it.
    • originUrl is the URL to attach to the Ftmap. This parameter is mandatory.
    • mimeType is the MIME type corresponding to the target content of the URL. It is used to display the type icon of the attachment.

Indicating an originId for the map attachment is recommended.

Example

To attach the Is Time Travel Possible? online article to the Time Machine User Guide Ftmap:

<?xml version='1.0' encoding='utf-8'?>
<controlFile>
<resources>
<resource>
<originId>time_machine_user_guide</originId>
<attachments>
<attachment>
<originId>time_travel_article</originId>
<displayName>Is Time Travel Possible?</displayName>
<originUrl>http://www.physics.org/article-questions.asp?id=131</originUrl>
<mimeType>text/html</mimeType>
</attachment>
</attachments>
</resource>
</resources>
</controlFile>

Once published to Fluid Topics, the Is Time Travel Possible? external link is now available in the Attachments tab of the Time Machine User Guide Ftmap.