Updating the Access Rights of a DITA-generated Map - Fluid Topics - 3.3

Upload DITA Content to Fluid Topics

Product
Fluid Topics
FT_Version
3.3
Category
Technical Notes

The access rights of a DITA-generated map can be updated through the FluidTopicsDitaControlFile.xml Control File.

Perform the following steps to update the access rights of a DITA-generated content from the Fluid Topics portal:

  1. Create or open a FluidTopicsDitaControlFile.xml control file.
  2. Enter the proper path and filename of the DITA map (and the DITAVAL if necessary) to update from within the previously upload archive in the ft:ditamapFile parameter.
  3. Set the status of the specified ft:resource to "visible".
  4. Add a restrictions element and set the groups element with one or many group element values corresponding to the groups the DITA map belongs to.
  5. Create an archive containing the modified FluidTopicsDitaControlFile.xml control file.
  6. Upload the archive using the Web Service.
Note: When successfully uploading a control file (FluidTopicsControlFile.xml or FluidTopicsDitaControlFile.xml) through a source that is not of the Unstructured Documents type, no feedback is provided in the History table of the Knowledge Hub interface. However, even though Success=0, Failed=0 and Rejected files=0 mean that the upload was successful.
No failed or rejected file means that the upload was successful
More information about the upload can be consulted in the Dataflow interface of the Back Office.

Example

The following lines show a FluidTopicsDitaControlFile.xml control file set to update the access rights of a map containing a DITAVAL:

<?xml version="1.0" encoding="UTF-8"?>
         <ft:resources xmlns:ft="http://ref.fluidtopics.com/v2/ft-dita#" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:noNamespaceSchemaLocation>
  <ft:resource status="visible">
    <ft:ditamapFile>my_map.ditamap</ft:ditamapFile>
    <ft:ditavalFile>internal.ditaval</ft:ditavalFile>
    <ft:restrictions>
        <ft:groups>
            <ft:group>group1</ft:group>
            <ft:group>group3</ft:group>
        </ft:groups>
    </ft:restrictions>
  </ft:resource>
</ft:resources>