====== Sharing Files and Folders ======

===== General Concept of Sharing within the RDMS =====

==== From your RDMS Home Folder ====

Files stored in your Home folder are by default only accessible to the owner, but it is possible to share folders/files with other RDMS users. 

To allow another user to see and download a file/folder, the owner has to assign at least 'read' permissions to that object. 

While it is afterwards already possible to access these files/folders, it is not convenient as it requires the user with whom the object was shared that the absolute location within the RDMS is know (e.g. ''/rug/home/<username>@rug.nl/<shared_object_name>''). 

To make this easier, the RDMS web interface offers the possibility of creating a 'shared link' for a specific folder. These links become visible in 'Shared' category of the web interface which can be found on the left side of of the interface. 

The sharing with other RDMS users is therefore a two-step procedure.

==== Inside of RDMS Projects and Team Drives ====

Inside of RDMS Projects and Team Drives, the files/folders are usually visible for the other Project/Team members. Also here, it applies that as a minimum 'read' permissions are needed to be able to see the files/folders.

===== Example Workflow to share from a RDMS Home Drive =====

For this example, we assume that a folder that exists within the Home Drive of one user shall be shared with another RDMS user. We will use the 'shared link' functionality of the web interface in this process. 

In this example. the folder is called ''Folder_to_share'' and it contains several files and subfolders that shall be also shared. 

The folder is located in the user's Home directory at ''/rug/home/<username>@rug.nl/Folder_to_share''


==== Setting up the shared Link ====

In the first step of this two step procedure, the owner of the folder can setup a shared link by right-clicking on it within the web interface.

This will reveal the context menu, where the user chooses the 'Shared Link' button:

{{ :rdms:data:shared_link.png?direct&600 |}}

This will open a new window that provides some more information about the shared link, for example if there is already a shared link setup for that object. If everything looks good, the user can confirm the creation of the shared link by hitting the ''Set shared link'' button.

{{ :rdms:data:shared_link2.png?direct&600 |}}

At this point, the name of the user that just setup the share will become visible within the ''Shared'' category of the web interface, but no content will be displayed as there were no permissions assigned for the shared object yet!

{{ :rdms:data:shared_link3.png?direct&600 |}}

==== Assign the correct Permissions ====

In the second step, the owner who setup the share will now assign the desired user permissions to the shared folder. 

This is again done from the context menu that is revealed when the owner right-clicks on the the specific folder. In the context menu, it is then possible to assign either permissions for a RDMS user, for a RDMS user group or also for the members of an RDMS Project. 

{{ :rdms:data:shared_link4.png?direct&600 |}}

In this example, the owner selects the ''Add User'' option which will open a new window that allows to select the user, the desired permission level as well as the option to assign the new permission just for that folder or also for all subfolder/files contained within it. After all selections are done, the ''Set Permission'' button sets the selected permission for the selected RDMS user.

{{ :rdms:data:set_permissions.png?direct&600 |}}

If the user with whom the file was shared now again navigates to the ''Shared'' location of the web interface and selected the name of the RDMS user who setup the share, the shown window will not be empty anymore. Instead, a link that points to the shared folder becomes visible for the user with correct permissions (minimum 'read' permission).

{{ :rdms:data:shared_link6.png?direct&600 |}}

The user can now easily navigate to the shared folder and retrieve the data from that location by using the shared link within the ''Shared'' location of the web interface.

==== Stop Sharing ====



=== Remove a shared Link ===

To remove a shared link within the RDMS web interface, the user who setup the share can right-click on the specific folder and select ''Shared link'' from the context menu (also see 'Setting up the shared Link' from above).

In the newly open window, click the ''Remove shared link'' will delete the shared link. 

{{ :rdms:data:remove_shared_link.png?direct&600 |}}


=== Revoke user permissions ===

To remove the permissions that were setup for a user/group on a folder/file during sharing, just right-click on file/folder in question. Then select ''Show/Hide details'' from the context menu to reveal the details of the selected object. 

In the ''Members'' tab, you can find an overview of the currently set permissions for that object. 

{{ :rdms:data:revoke_permissions.png?direct&600 |}}

Clicking the {{:rdms:data:pencil.png?direct&30|}} button next to the user/group name will open a new window in which the permissions can be changed. To completely remove the permissions, select 'None' and hit the ''Set permission'' button. 

**Note:** Be sure that you also select 'Including sub files and folder' if you want to change/remove the permission also for all subfolders and files within the selected parent folder.