Delete instances of a DITA map - Fluid Topics - Latest

DITA Connector Reference Guide

Category
Reference Guides
Audience
public
Version
Latest

It is possible to delete instances of a DITA map that has already been processed as follows:

  1. Create a control file, or edit an existing one.
  2. In the <filePath> element, enter the filename of the DITA map to modify.
  3. In the <instances> element, add the DITAVAL instances.
  4. In the <publishStatus> element, enter the value deleted.
  5. Create an archive containing the control file.
  6. Upload the archive through the DITA source used to publish the DITA map.

Users must name the control file FluidTopicsControlFile.xml, and they must place it at the root level of the archive.

It is not necessary to include the DITA map or the DITAVAL instances in the archive.

Example:

The following lines show the content of a FluidTopicsControlFile.xml file to delete the Novice and Expert instances of the map_to_delete_multi_ditavals DITA map:

<?xml version='1.0' encoding='utf-8'?>
<controlFile>
  <resources>
    <resource>
      <filePath>map_to_delete_multi_ditavals.ditamap</filePath>
      <instances>
        <instance>
          <filePath>Novice.ditaval</filePath>
        </instance>
        <instance>
          <filePath>Expert.ditaval</filePath>
        </instance>
      </instances>
      <publishStatus>deleted</publishStatus>
    </resource>
  </resources>
</controlFile>

Once a user uploads the control file to Fluid Topics, the Novice and Expert instances of the map_to_delete_multi_ditavals are no longer available.