Data Browser [CIT Research Documentation]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
{{indexmenu_n>2}}
====== Data Browser ======

===== General =====

The "Data Browser" is the main way within the RDMS web interface that you can use to navigate through your files and folders. In this window, you can also execute different tasks related to the management of your files. It is also the starting window that is presented to you when you log into the web interface, but it can be accessed at any time by hitting the {{:rdms:webapp:data_browser_logo_2.png?direct&direct&20|}} button on the left-sided Menu panel. 

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

When within the Data Browser, you can use the {{:rdms:webapp:hide.png?direct&direct&20|}}/{{:rdms:webapp:reveal.png?direct&20|}} buttons in the Menu sidebar to hide or reveal the directory browser (green box in the screenshot above). Inside the directory browser, you can access different parts of the system by clicking on the respective icon. A brief explanation of the items in the directory browser follows below:

  * **Starred** ({{:rdms:webapp:starred.png?direct&30|}}): Starred files and folders are a collection of files and folders that you highlighted in the RDMS. Hovering on or clicking a file or folder in the Data Browser will reveal an empty star icon beside the file or folder name. If you click on the star icon, you will mark the file, and the star will fill. You will then be able to see the file listed in this part of the Data Browser. Unmarking a file will remove it from this list. This is an easy way of keeping all your most-used files and folders in a single location.
  * **Projects** ({{:rdms:webapp:projects.png?direct&30|}}): This part of the Data Browser collects all the RDMS Projects that you are part of. Please refer to the [[rdms:solution:projects|Projects]] section of the wiki to get more information about Projects in the RDMS.
  * **Team drives** ({{:rdms:webapp:teamdrives.png?direct&30|}}): This part of the Data Browser collects all the RDMS Team Drives that you are part of. Please refer to the [[rdms:solution:team|Team Drive]] section of the wiki to get more information about Team Drives in the RDMS.
  * **Shared** ({{:rdms:webapp:shared.png?direct&30|}}): This part of the Data Browser shows an overview of all the RDMS locations that other users shared with you. You can use this overview to navigate easily and quickly to a shared location.
  * **Bin** ({{:rdms:webapp:bin.png?direct&30|}}): This part of the Data Browser contains all the files and folders that you deleted. The web interface currently only allows you to restore data from the Bin (see the [[rdms:webapp:databrowser#how_to_restore_deleted_files|How to restore deleted files]] section at the bottom of this page). Information on how to permanently delete files can also be found there.
  * **My folder** ({{:rdms:webapp:my_folder.png?direct&30|}}): This is your personal home location in the RDMS.

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

As mentioned above, you can execute different file management tasks directly from the Data Browser. For example, you can use the {{:rdms:webapp:three_dots.png?direct&20|}} button on the top-right corner to reveal a menu that allows you to create new folders, upload files, move data, or link folders:

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

You can also right-click on a file or folder in your Data Browser to reveal a context menu that allows you to execute more tasks (e.g. assigning [[rdms:data:permissions|permissions]] on the selected object):

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

==== Preview Data ====
The context menu in the data browser also allows you to preview the content of certain files. So far, the RDMS supports the preview of the following file formats:

^ Type      ^ File Extensions       ^ Notes          ^
| Image File    | ''*.apng'', ''*.bmp'', ''*.gif'', ''*.jpg'', ''*.jpeg'', ''*.png'', ''*.svg''    | Displays preview of the image. |
| Documents    | ''*.pdf''  | Opens PDF in Browser. Printing/Download is possible from there. |
| Text-based   | ''*.csv'', ''*.html'', ''*.json'', ''*.txt'', ''*.xml''      | Displays content of text file. Content can be copied from here as well.        |
| Other   | ''*.tar''    | Displays the content of the tar bundle.       |

To preview a file, right-click the file and open the context menu. Then select the "Open In..." option from the context menu. The function will present you with different ways to open the respective file. You can choose to preview the file either on the right side of the current data browser window or to use a new browser tab to preview it.  

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

In this example case, we select a tar archive for preview. You can see in the screenshot below that the content of the tar archive is shown on the right side of the data browser.

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

**Notes**:
  * The preview function is limited to files with a **maximum size of 500 MB**.
  * In the future, we will add more data formats that can be previewed. If you need a certain preview function, please contact [[rdms-support@rug.nl|rdms-support@rug.nl]] with your request.

==== Using Hotkeys ====

Within the Data Browser, different hotkeys are implemented that you can use to execute common data operations in a convenient way.
The hotkeys in the Data Browser are designed to be as close as possible to hotkeys used on other operating systems. As such, the basic hotkey combinations ''shift + up'', ''shift + down'', and ''shift + click'' are available to select multiple files or folders. The ''ctrl + click'' combination also works like expected from your operating system.

Additional hotkey functions that are currently implemented can be accessed by typing the strings below on your keyboard while in the Data Browser:
  * ''dbn'': Create a new collection (folder)
  * ''dbu'': Upload a new data object (file)
  * ''dbm'': Move the selected objects or collections
  * ''dbl'': Link a collection
  * ''ctrl + h'': Display the help window

**Notes:** 
  * The listed hotkeys are only available in the Data Browser, with the exception of the ''ctrl + h'' hotkey combination, which is available in the entire web interface.
  * For Mac users, the ''ctrl'' key is replaced by the ''command'' key. The hotkeys then function in the same way as described above.

==== How to Restore Deleted Files ====

Files in your bin can be restored via the web interface. Click below to reveal the guide showing you how to do so. If you would like to use ''iCommands'' to restore files, please navigate to the corresponding command in the [[rdms:access:linux:icommands#icommands_for_meta_data_management|How to manage files in the RDMS trash folder]] section of the wiki.

**Note**: Please keep in mind that if you wish to **permanently delete** files stored in your bin, the only way to do so is by using the Command Line Interface (CLI). Look to the section explaining how to use ''irmtrash'' on the [[:rdms:access:linux:icommands|iCommands]] page.

++++ Restoring Data via the Web Interface |
Here, we explain how to restore files using the web interface. First, navigate to the Bin folder in the Data Browser (see screenshot below). Files that have been deleted from your Home Drive will appear in the Bin. Files deleted from folders within your Home Drive, or from your Team Drive or Projects, will generate a folder in the Bin corresponding to their original location (see the screenshot).

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

Next, you can select the data that you want to restore. You can select a whole folder or single files inside of it. Also multiple files and folders can be selected (see "Using Hotkeys" section above). Once you selected the respective data, click the restore icon at the top part of the Data Browser, as seen in the screenshot below.

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

The RDMS will open a new window and ask you for additional information. The first window asks you to specify where you want the deleted data to be sent after it is restored. In most scenarios, you would want the data to be restored in its original location, but you can also select another RDMS location that are available to you. 

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

Once you have chosen a destination, whether it is the original one or a new destination, you can scroll down to press the "Next >" button to move on to the next window.

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

The RDMS will then display a summary of the data to be restored and the selected destination. Please check that the information is correct before proceeding. If all information is correct, scroll down to select the last option before restoring the file.

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

Here, the RDMS provides you with two option: "Keep the current permissions" or "Keep the current permissions and add permission of a new location". If you are **restoring the file to its original location**, you can simply choose to **keep the current permissions**. If you wish to **restore the file in a new location**, it is probably best to **add the permissions of the new location** as well. In this case, the data will automatically also get the permissions of its destination location assigned. Should you choose to restore the data to a new location without adding its permissions, then be aware that some users may not be able to see or access the data. Click "Ok" once you are done and wish to proceed.

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

Finally, the RDMS will ask for a final confirmation before restoring the data. If you choose "Yes", then the data will be moved out of the bin and to the destination location that you selected. 

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

You can now go back to the data browser to access the restored data.

++++