Limit the Access Rights of a DITA Map to Specific Groups - Fluid Topics - 3.6

Upload DITA Content to Fluid Topics

Product
Fluid Topics
FT_Version
3.6
Category
Technical Notes

To limit access to specific groups to a DITA Map, perform the following steps:

  1. Create or edit the FluidTopicsControlFile.xml control file:
    <?xml version='1.0' encoding='utf-8'?>
    <controlFile>
      <resources>
        <resource>
          <filePath>map_which_access_must_be_limited.ditamap</filePath>
          <rights>
            <accessLevel>restricted</accessLevel>
            <groups>
              <group>specific_group</group>
            </groups>
          </rights>
        </resource>   
      </resources>
    </controlFile>
    Where:
    • resource
      • filePath expects the 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 .
    • rights
      • accessLevel expects the restricted value to limit the access to the DITA map to specific groups in Fluid Topics.
      • groups>group is used within groups to define each group that can access the documents. group is mandatory in groups.
  2. Compress the FluidTopicsControlFile.xml file in a ZIP archive.
  3. Upload the ZIP archive to Fluid Topics through the DITA source used to publish the DITA map.
    Note: There is no need to send the DITA map nor the DITAVALs back.
Example
The following lines show how to limit the Time Machine Datasheets DITA map to Technicians and R&D groups:
<?xml version='1.0' encoding='utf-8'?>
<controlFile>
  <resources>
    <resource>
      <filePath>_time_machine_datasheets.ditamap</filePath>
      <rights>
        <accessLevel>restricted</accessLevel>
        <groups>
          <group>Technicians</group>
          <group>R&D</group>
        </groups>
      </rights>
    </resource>   
  </resources>
</controlFile>
Once published to Fluid Topics, the Time Machine Datasheets map access is limited to the Technicians and R&D user groups.