Differences

This shows you the differences between two versions of the page.

--- rdms:webapp:databrowser [2025/04/22 08:36] – [How to Restore Deleted Files ?] burcu
+++ rdms:webapp:databrowser [2026/07/30 10:12] (current) – burcu
@@ Line 4: / Line 4: @@
 ===== General =====
-The ''Data Browser'' is the main window within the RDMS web portal that can be used for navigating through your files and execute different tasks. It is the initial window that is presented to you when you log into the web portal, 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 navigation panel.
+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:databrowser.png?direct&850 |}}
-{{ :rdms:webapp:databrowser.png?direct&1200 |}}
+\\
-When within the ''Data Browser'', the {{:rdms:webapp:hide.png?direct&direct&20|}}/{{:rdms:webapp:reveal.png?direct&20|}} buttons in the navigation panel can be used to hide or reveal the directory browser that allows you to access the different storage areas that are available for your in the RDMS.
+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:
-These are the different areas that can be accessed from the directory overview in the ''Data Browser'':
+  * **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]].
-''Starred'' ({{:rdms:webapp:starred.png?direct&30|}}): Starred files and folders are marked by the owner. It is an easy way of sorting the most used files and folders of that moment. Any file or folder that you have access to can be selected and set as a starred file or the folder.\\
+  * **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]].
-''Projects'' ({{:rdms:webapp:projects.png?direct&30|}}): Shows your available RDMS projects. Please refer to the [[rdms:solution:projects|Projects]] section of the wiki to get more information about projects in the RDMS.\\
+  * **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.
-''Team drives'' ({{:rdms:webapp:teamdrives.png?direct&30|}}): Shows your available RDMS Team Drives. Please refer to the [[rdms:solution:team|Team Drive]] section of the wiki to get more information about projects in the RDMS.\\
+  * **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]].
-''Shared'' ({{:rdms:webapp:shared.png?direct&30|}}): Shows an overview of the available RDMS locations that other users shared with you. This overview can be used for easy and fast navigation to a shared location.\\
+  * **My folder** ({{:rdms:webapp:my_folder.png?direct&30|}}): Opens your personal RDMS Home directory.
-''Bin'' ({{:rdms:webapp:bin.png?direct&30|}}): Shows the content of your bin which contains the files and folders that you deleted. You can restore data from the bin. For information on how to restore deleted files, please navigate to the [[https://wiki.hpc.rug.nl/rdms/webapp/databrowser#how_to_restore_deleted_files|How to restore deleted files]] section at the bottom of this page.\\
-''My folder'' ({{:rdms:webapp:my_folder.png?direct&30|}}): This is your personal home location in the RDMS.\\
 ===== Data Browser Functions =====
-As initially mentioned, different tasks can be executed 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:
+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 click on a file/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):
+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&700 |}}
+{{ :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          ^
+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:
-| Image File    | ''*.apng'', ''*.bmp'', ''*.gif'', ''*.jpg'', ''*.jpeg'', ''*.png'', ''*.svg''    | Displays preview of the image |
-| Documents    | ''*.pdf''  | Opens PDF in Browser. Printing/Download 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 the content of a file (here a tar archive), 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 options to open the respective file. Here 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 the selected file.
+^ 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. |
-{{ :rdms:webapp:rdms_data_preview_1.png?direct&800 |}}
+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.
-In this example case, we select a tar archive for preview. You can see in the screenshot, that its content is shown on the right side of the data browser.
+{{ :rdms:webapp:rdms_data_preview_1.png?direct&800 | }}
-{{ :rdms:webapp:rdms_data_preview_2.png?direct&800 |}}
+The following example previews a tar archive. The contents of the archive appear on the right side of the Data Browser:
-**Notes**:
+{{ :rdms:webapp:rdms_data_preview_2.png?direct&800 | }}
-  * 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.
+**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 ====
-Within the ''Data Browser'' different hotkeys are implemented which can be used to execute common data operations in a convenient way.
+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 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/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 on your keyboard while in the ''Data browser'':
+The following additional hotkeys are available in the Data Browser:
-  * ''dbn'': Create a new collection (folder)
-  * ''dbu'': Upload a new data object (file)
+  * ''dbn'': Create a new folder
-  * ''dbm'': Move the selected objects or collections
+  * ''dbu'': Upload a new file
-  * ''dbl'': Link a collection
+  * ''dbm'': Move the selected files and folders
-  * ''ctrl + h'': Display the help window
+  * ''dbl'': Link a folder
+  * ''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 on the entire web portal.
-  * 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 [[https://wiki.hpc.rug.nl/rdms/access/linux/icommands#icommands_for_meta_data_management|How to manage files in the RDMS trash folder]] section of the wiki.
+  * 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.
-**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 Files via the Web Interface |
+==== How to Restore Deleted Files ====
-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).
+You can restore files from the Bin through the Web interface. Expand the guide below for instructions. To restore files using ''iCommands'', see [[rdms:access:linux:icommands#icommands_for_meta_data_management|How to Manage Files in the RDMS Trash Folder]].
+**Note:** To permanently delete files from the Bin, you must use the command-line interface (CLI). See the instructions for using ''irmtrash'' on the [[:rdms:access:linux:icommands|iCommands]] page.
+++++ Restoring Data via the Web Interface |
+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:rdms_trash_1.png?direct&800 |}}
-Next, navigate to the file(s) you want to restore. Once selected, click the restore icon at the top part of the data browser, as seen in the screenshot below.
+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: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 file to be sent, after it is restored. You normally would want the file to be restored in its original location, but should you wish to have it restored in a different folder, this window is where you want to specify where.
+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.
 {{ :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.
+After selecting a destination, scroll down and select "Next >" to continue:
 {{ :rdms:webapp:rdms_trash_4.png?direct&800 |}}
-The RDMS will then display a summary of the file(s) to be restored and where they are being restored to. 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.
+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:
 {{ :rdms:webapp:rdms_trash_5.png?direct&800 |}}
-Here, the RDMS provides you the option to //Keep the current permissions// or also //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, permissions refer to who can access the file in the location it will be restored in. Should you choose to move the file to a new location and not add the permissions of said new location, then be aware that some users may not be able to see or access the file. Click //Ok// once you are done and wish to proceed.
+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 permission of 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:rdms_trash_6.png?direct&800 |}}
-Finally, if you choose to proceed, the RDMS will will ask for confirmation before restoring the file. If you choose //Yes//, then the file will be moved out of the bin and into the destination folder you specified.
+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&800 |}}
-You can now go back to the data browser and find the restored file there.
+You can now return to the Data Browser and access the restored files and folders.
 ++++