LabKey Server makes it easy to upload and use your files in a secure and accessible file repository. Users work with files in a Files
web part, also known as a file browser
. This topic covers setting up and populating the file browser. You can also learn to use files in the Tutorial: File Repository
Create a File Browser (Admin)
An administrator can add a file browser to any folder or tab location.
- Navigate to the desired location.
- Enter > Page Admin Mode.
- In the lower left, select Files from Add Web Part and click Add.
- Click Exit Admin Mode.
There is also a file browser available in the narrow/righthand column of webparts. It offers the same drag and drop panel, but the menu bar is abbreviated, concealing the majority of menu options behind a Manage button.
Drag and Drop Upload
The Files web part provides a built-in drag-and-drop upload interface. Open a browser window and drag the desired file or files onto the drag-and-drop target area.
Folders, along with any sub-folders, can also be uploaded via drag-and-drop. Uploaded folder structure will be reproduced within the LabKey file system. Note that empty folders are ignored and not uploaded or created.
While files are uploading, a countdown of files remaining is displayed in the uploader. This message disappears on completion.
Single File Upload Button
If drag and drop is not suitable, you can also click the Upload Files
button which will let you browse to Choose a File
. You can also enter a Description
via this method. Click Upload
Create Folder Structure in the File Repository
When you import a files in a folder/subfolder structure, that structure is retained, but you can also create new folders directly in the file browser. In the file browser, select the parent folder, or select no parent to create the new folder at the top level. Click the Create Folder
Enter the name of the new folder in the popup dialog, and click Submit
Note that folder names must follow these naming rules:
- The name must not start with an 'at' character: @
- The name must not contain any of the following characters: / \ ; : ? < > * | " ^
If you would like to create multiple distinct folder structures within a single folder, make use of named file sets
Show Absolute File Paths
Administrators can grant users permission to see absolute file paths
in the file browser on a site wide basis.
To show the column containing the file paths to users granted the necessary permission:
- In the file browser, click Admin.
- Click the Toolbar and Grid Settings tab.
- Scroll down to the Configure Grid Column Settings section.
- Uncheck the box for Hidden next to Absolute File Path (permission required).
Users who have not been given the See Absolute File Paths
role will see only an empty column.