{{indexmenu_n>2}}
====== Data Browser ======

===== General =====

The "Data Browser" is the main area of the RDMS Web interface for navigating and managing your files and folders. It is displayed when you log in to the Web interface. You can access it at any time by selecting the {{:rdms:webapp:data_browser_logo_2.png?direct&20|}} button in the navigation menu on the left. 

{{ :rdms:webapp:rdms_webbrowser.png?direct&850 |}} 

\\

In the Data Browser, use the {{:rdms:webapp:hide.png?direct&20|}} and {{:rdms:webapp:reveal.png?direct&20|}} buttons in the navigation menu to hide or show the directory browser marked by the green box in the screenshot above. Select an icon in the directory browser to access the corresponding part of the RDMS:

  * **Starred** ({{:rdms:webapp:starred.png?direct&30|}}): Contains the files and folders that you have marked with a star. Hover over or select a file or folder to display an empty star icon next to its name. Select the star to add the item to "Starred". Select the star again to remove the item. This feature provides quick access to frequently used files and folders.
  * **Projects** ({{:rdms:webapp:projects.png?direct&30|}}): Contains all the RDMS Projects that you can access. For more information, see [[rdms:solution:projects|RDMS Projects]].
  * **Team Drives** ({{:rdms:webapp:teamdrives.png?direct&30|}}): Contains all the RDMS Team Drives that you can access. For more information, see [[rdms:solution:team|RDMS Team Drives]].
  * **Shared** ({{:rdms:webapp:shared.png?direct&30|}}): Contains the RDMS locations that other users have shared with you. Use this overview to access shared locations quickly.
  * **Bin** ({{:rdms:webapp:bin.png?direct&30|}}): Contains the files and folders that you have deleted. You can use the Web interface to restore these items. For instructions on restoring or permanently deleting files and folders, see [[rdms:webapp:databrowser#how_to_restore_deleted_files|How to Restore Deleted Files]].
  * **My folder** ({{:rdms:webapp:my_folder.png?direct&30|}}): Opens your personal RDMS Home directory.


===== Data Browser Functions =====

You can perform various file-management tasks directly from the Data Browser. Select the {{:rdms:webapp:three_dots.png?direct&20|}} button in the top-right corner to open a menu from which you can create folders, upload files, move files and folders, or link folders:

{{ :rdms:webapp:three_dot_menu.png?direct&700 |}}

You can also right-click a file or folder to open a context menu with additional actions, such as assigning [[rdms:data:permissions|permissions]] to the selected item:

{{ :rdms:webapp:right_click.png?direct&500 |}}

==== Preview Data ====

The context menu in the Data Browser allows you to preview the contents of certain files. The RDMS currently supports previews of the following file formats:

^ File Type ^ File Extensions ^ Notes ^
| Image | ''*.apng'', ''*.bmp'', ''*.gif'', ''*.jpg'', ''*.jpeg'', ''*.png'', ''*.svg'' | Displays a preview of the image. |
| PDF document | ''*.pdf'' | Opens the PDF in the browser. You can print or download it from there. |
| Text-based file | ''*.csv'', ''*.html'', ''*.json'', ''*.txt'', ''*.xml'' | Displays the contents of the text file. You can also copy the contents. |
| Archive | ''*.tar'' | Displays the contents of the tar archive. |

To preview a file, right-click it and select "Open In..." from the context menu. You can preview the file on the right side of the current Data Browser or in a new browser tab. 

{{ :rdms:webapp:rdms_data_preview_1.png?direct&800 | }}

The following example previews a tar archive. The contents of the archive appear on the right side of the Data Browser:

{{ :rdms:webapp:rdms_data_preview_2.png?direct&800 | }} 

**Notes:**

  * You can preview files with a maximum size of **500 MB**.
  * More file formats will be added in the future. To request support for a specific format, contact [[rdms-support@rug.nl|rdms-support@rug.nl]].

==== Using Hotkeys ====

You can use hotkeys to perform common operations in the Data Browser. These hotkeys follow commonly used operating-system shortcuts. Use ''Shift + Up'', ''Shift + Down'', or ''Shift + Click'' to select multiple files or folders. You can also use ''Ctrl + Click'' as you would in your operating system.

The following additional hotkeys are available in the Data Browser:

  * ''dbn'': Create a new folder
  * ''dbu'': Upload a new file
  * ''dbm'': Move the selected files and folders
  * ''dbl'': Link a folder
  * ''Ctrl + H'': Display the help window

**Notes:** 


  * These hotkeys are available only in the Data Browser, except for ''Ctrl + H'', which is available throughout the Web interface.
  * On macOS, use the ''Command'' key instead of the ''Ctrl'' key. The hotkeys otherwise work as described above.


==== How to Restore Deleted Files and Delete Them Permanently ====

You can restore the files from the Bin both using the Web Interface and the ''iCommands''; see [[rdms:access:linux:icommands#icommands_for_meta_data_management|How to Manage Files in the RDMS Trash Folder]].
Files can also be permanently deleted using both the Web Interface and the ''iCommands''; see the instructions for using ''irmtrash'' on the [[rdms:access:linux:icommands#icommands_for_meta_data_management|How to Manage Files in the RDMS Trash Folder]].


++++ Restoring and Permanently Deleting Data via the Web Interface |

**Restoring Data from Bin**

First, select "Bin" in the Data Browser. Files deleted from your RDMS Home directory appear in the Bin. When you delete files from a folder within your RDMS Home directory, a Team Drive, or an RDMS Project, the Bin displays a folder corresponding to the original location:

{{ :rdms:webapp:restore_bin1.png?direct&700 |}}

Next, select the files and folders that you want to restore. You can select a complete folder, individual files, or multiple files and folders. To select multiple items, see the "Using Hotkeys" section above. After selecting the items, select the restore icon at the top of the Data Browser:

{{ :rdms:webapp:restore_bin2.png?direct&700 |}}

The RDMS opens a window in which you can select a destination for the restored files and folders. In most cases, you will want to restore them to their original location. You can also select another RDMS location that you can access.
After selecting a destination, scroll down and select "Next >" to continue:

{{ :rdms:webapp:restore_bin3.png?direct&700 |}}

The RDMS displays a summary of the selected files and folders and their destination. Check that the information is correct before continuing. Then scroll down and select how the RDMS should handle the permissions:
The RDMS provides the following options:

  * Select "Keep the current permissions" when restoring files and folders to their original location.
  * Select "Keep the current permissions and add permissions for a new location" when restoring files and folders to a different location. The restored items will also receive the permissions assigned to the destination.

**Note:** If you restore files and folders to a different location without adding its permissions, some users may be unable to view or access them.

Select "Ok" to continue.


{{ :rdms:webapp:restore_bin4.png?direct&700 |}}


The RDMS asks you to confirm the operation. Select "Yes" to move the files and folders from the Bin to the selected destination:

{{ :rdms:webapp:rdms_trash_7.png?direct&700 |}}

You can now return to the Data Browser and access the restored files and folders.

**Deleting Data Permanently**

To delete your file(s) permanently, right click on your file(s), and select "Delete permenantly": 

{{ :rdms:webapp:restore_bin7.png?direct&500 |}}

Confirm the permanent delete action:

{{ :rdms:webapp:restore_bin6.png?direct&400 |}}

++++

++++ Emptying the Bin via the Web Interface |

To empty your whole Bin, in the Bin folder, select the icon on the left-hand side of the search bar:

{{ :rdms:webapp:restore_bin8.png?direct&600 |}}

Confirm to delete the Bin:

{{ :rdms:webapp:restore_bin9.png?direct&400 |}}

++++