Limit the Access Rights of an Unstructured Document to Specific Groups - Fluid Topics - 3.4 - Technical Notes

Upload Unstructured Documents to Fluid Topics

Product
Fluid Topics
FT_Version
3.4
Category
Technical Notes
audience
public

It is possible to assign rights in a control file as follows:

  1. Create or edit the FluidTopicsControlFile.xml control file:
    <?xml version='1.0' encoding='utf-8'?>
    <controlFile>
        <resources>
            <resource>
                <filePath>path_to_the_document_which_access_must_be_limited</filePath>
                <rights>
                    <accessLevel>restricted</accessLevel>
                    <groups>
                        <group>specific_group</group>
                    </groups>
                </rights>
            </resource>
        </resources>
    </controlFile>
    Where:
    • filePath expects the path to the unstructured document file in the archive used to upload the unstructured document to Fluid Topics. It can be retrieved from the ud:id of the Metadata Journal , if no originId was set for the document.
    • rights>accessLevel expects the level of access you wish to apply to the unstructured document in Fluid Topics:
    • groups>group is used within groups to define each group that can access the documents when the accesslevel is restricted. group is mandatory in groups.
    Attention: If the document is not in the archive and no originId was defined for the document, then the filePath must be used to identify the document.
  2. Compress the FluidTopicsControlFile.xml file in a ZIP archive.
  3. Upload the ZIP archive to Fluid Topics through the Unstructured Documents source used to publish the unstructured document.
    Note: There is no need to include the unstructured document files in the archive.
Example
The following lines show how to limit the Time Machine Assembly PDF document to Technicians and R&D groups:
<?xml version='1.0' encoding='utf-8'?>
<controlFile>
    <resources>
        <resource>
            <filePath>time_machine_assembly.pdf</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 Assembly PDF document access is limited to the Technicians and R&D user groups.