Links make it easier for you to find and organize files and folders in your Workspace. A link references to the original file that can be stored in workspace or on the external data store (eNode). |
In this guide, you will learn about links - a mechanism that allows you to create a shortcut that references the original file or folder stored in the other location.
We show you how to add a link to a file stored on the external data store (eNode) or to another file or folder in your workspace. eNode link gives easy access to the file stored on an external data store without the need to copy it to your Workspace. As a result, you can access the file as if you had it in your workspace but the file does not use your Workspace storage space. A workspace link is a shortcut that points to a file or directory within your workspace or in workspace of a user that shared it with you (see more in Sharing files and applications guide). Workspace links make it easier to organize files and folders inside your Workspace.
You can add files from external data stores to your workspace directly from the Data Search or from the file viewer. Both Data Search and file viewer allow you to add a file as a copy (Add to workspace action) or as a link (Add to workspace as link action). Add to workspace as link creates a link in your workspace that points to the file stored on the external data store. A link gives easy access to the external file without the need to physically copy it to your Workspace. As a result, you can access the file as if you had it in your workspace but the file does not use your Workspace storage space.
An eNode link might be creating either form the Data Search (Figure 1.1) or from any file visualization (Figure 1.2). In the first case the option Add to workspace as link is available within the MORE menu (marked in Figure 1.1), in the second - within the ACTIONS menu (marked in Figure 1.2).
Figure 1.1. Data Search view with options for creating a link to eNode file marked
Figure 1.2. File visualization with options for creating a link to eNode file marked
After choosing the respective action, a popup window will appear, where you will be able to select the directory where the link will be added e.g. the Project-B directory (Figure 1.3)
Figure 1.3. Selecting the directory where the link should be added
After this, the the link is added to the selected directory (e.g. Project-B as selected in the window from Figure 1.3). The link is marked with a special "link icon" - as marked in Figure 1.4. When showing the File information menu for the link in workspace, you will see the information that link points to a file from an external data store (marked in top-right corner of Figure 1.4). You can also see that the link has all the properties of the source file (e.g. the type Catalog, episode LAI CHAU: water reservoir), but that its size is 0B, which means that it does not take up any storage space in your workspace.
Figure 1.4. Workspace view of the created link and File information view
Although an eNode link in your workspace behaves almost the same as a regular workspace file, the fact that you are using a file that is not physically stored in you workspace has the some important implications:
A workspace link is a shortcut that points to a file or directory within your workspace or the workspace of a user that shared it with you*. Workspace links make it easier to find and organize files and folders without copying them. You can also think of them as symbolic links in the Linux system or a shortcut in Windows.
* In general, links to the workspace of other users work in the same way as links to your workspace, therefore, this guide will be enough for you to learn how to use and manage them. However, for more details on creating and specific features of links to files shared by other users please see the Sharing files and applications guide.
To create a workspace link use the workspace item (file or directory) menu and select the Create link action (marked in Figure 2.1). Note, that the action will not be available if the file/directory already is a workspace link, not to create an infinite loop when accessing it. Nevertheless, you can create a workspace link to an item that is a link to an eNode file.
Figure 2.1. Menu used for creating a Workspace link
After this operation you will be presented with a popup window where you will be able to select the directory where the link will be created - e.g. Project-A in Figure 2.2. Note, that the window is the same as in case of creating of eNode links - Figure 1.3.
Figure 2.2. Selecting the directory where the link should be added
After this process, the link to the catalog.mat file was created in the Project-A directory. The link is marked with a special "link icon" - as marked in Figure 2.3. When showing the File information menu for the created link, you will see the information to which file the link points (top of Figure 2.4). You can also see that the link has all the properties of the source file (e.g. the type Catalog and format MAT), but that its size is 0B, which means that it does not take up any storage space in your workspace.
Figure 2.3. Workspace view after creating a link
Figure 2.4. Information about created link
You can repeat the process to create multiple links to the same file. For example, you can use links as shortcuts to the original file in different projects (e.g. Figure 2.5). You can make sure that files are in consistent places without moving or copying the original.
Figure 2.5. Multiple workspace links to the same file
With workspace links you can arrange freely your projects within workspace. However, you have to remember that a link is only a pointer to your file, not a file itself. Therefore, if the file is changed, when accessing the link you will see it updated and you will not be able to access its previous version. The links are also sensitive to changes in the location of the source file - if you move, rename or delete the file or directory to which the link points, the link will break (see the section Broken Links) and you will no longer be able to use it unless the path is restored. Note, also, that if you change the source file type or format (see Managing properties of workspace files), the link will behave the same as the source file, which might affect displaying its contents or using it as input to an application.
For most operations file links can be used in the same way as the source files:
Some operations work differently on file links than on source files:
As mentioned before, there are several situations when the content of the link cannot be accessed - the link becomes "broken". These are:
For workspace links:
A broken link has a specific marking in the workspace tree - the link icon is displayed on a red background (see Figure 3.1) and when showing its file information (Figure 3.2), there is a message that the original file is available. The file properties also show the UNDEFINED type of the file (as the real type cannot be determined without the source file).
It is important to know, that in some cases a broken link can be fixed - as soon as the cause of the unavailability of the original file is resolved, a broken link becomes a working link again. In case of an eNode link this usually requires administrative actions on the data store servers, but if the cause of breaking the link was losing permissions to the source file, you might extend your affiliation or apply for a newly required one (if your request it legitimate). In case of a workspace link, restoring the original file to the previous name or location will fix the link. Remember also that the links are very light and inexpensive files, therefore, you can always create new ones.
Figure 3.1. Broken link within the workspace tree
Figure 3.2. File information details of a broken link