Linking to a file in the drive

Last modified by mmorgan on 2022/04/21 15:44

Sharing links to the Drive that contain /lib/ in the URL (https://drive.ebrains.eu/lib/...) is not recommended although we are no longer aware of any specific issue with doing these links. Such links are shared by people who simply copy the URL from their browser page, typically from OnlyOffice.

Note: Users have experienced problems with links to EBRAINS services when referenced in a Word document and accessed from Microsoft Word (not OnlyOffice). This seems to be a known issue with Microsoft Word, not a bug with EBRAINS services.

To link to a file in the Drive, click on the "Share" icon as shown below.

image-20220125161720-1.png

Clicking on this "Share" icon (shown above) brings up a popup (as shown below).

image-20220125162218-2.png

Two types of links are supported for files in the Drive: Share links and Internal links.

  1. The "Share Link" generates a public link. A public link makes the file accessible in read-only mode to anyone that has the link, including users without an EBRAINS account. Even someone with write permission in that collab will only have read access to that file when accessing it via a public link. Public links contain the string "/f/" for files and "/d/" for directories.
  2. The "Internal Link" generates a smart link. A smart link provides access only to those with corresponding read or write permissions in that collab. Smart links contain the string "/smart-link/".

A third type of link is supported for folders in the Drive.

  1. The "Upload Link" provides a URL for any user to upload a document that will be placed in the selected folder. The URL does not allow users to view the contents of the folder. Upload links contain the string "/u/d/"

WARNING: creating a public link to a folder makes all of its content accessible to users who have the link.

When sharing a smart link or public link with users, consider also indicating the URL of the collab's Drive (e.g. https://wiki.ebrains.eu/bin/view/Collabs/mycollab/Drive) because it cannot (yet) be determined from the smart link or the public link. That is the URL displayed in your browser when viewing the Drive from the Wiki.

wiki_drive_url.png

Avoid sharing the URL displayed in your browser from a Drive (not Wiki) window because that URL is specific to your role in that collab and therefore may not be accessible to other users of the same collab.

Links to moved files

Links do not follow files when they are renamed or moved. However, if you create a link to a file test.docx, then delete that file and upload another document with the filename test.docx, the created link will still work and will point to the newer file.