Remove an attachment using its khubId - Fluid Topics - Latest

Map Attachments

Category
Technical Notes
Audience
public
Version
Latest

To remove a map attachment from a DITA map by its khubId, add the following lines to the FluidTopicsControlFile.xml file:

<?xml version='1.0' encoding='utf-8'?>
<controlFile>
  <resources>
    <resource>
      <filePath>my_map.ditamap</filePath>
      <instances>
        <instance>
          <filePath>version1.ditaval</filePath>
          <attachments>
            <attachment>
              <isAttached>false</isAttached>
              <khubId>$ATTACHMENT_KHUB_ID</khubId>
            </attachment>
          </attachments>
        </instance>
      </instances>
    </resource>
  </resources>
</controlFile>

Where:

  • resource

    • filePath expects the absolute path to the DITA map file in the archive used to upload the DITA map to Fluid Topics. It can be retrieved from the Metadata journal in the dita:mapPath field.
  • instance

    • filePath expects the absolute path to the DITAVAL file in the archive used to upload the DITA map to Fluid Topics. It can be retrieved from the Metadata journal in the dita:ditavalPath field.
  • attachment

    • isAttached expects the false value to detach the attachment from the DITA map.
    • khubId is the ID given to the file to attach by the connector. It is derived from the originId - or the filepath if no originId was set – combined with the source. It is unique and can be retrieved from the URL of the map attachment when it is opened in the Viewer page: https://mysite.fluidtopics.net/viewer/book-attachment/$PUBLICATION_KHUB_ID/$MAP_ATTACHMENT_KHUB_ID.