Share data
Share data within your GenomeSpace account in two ways.
-
With other GenomeSpace users by sharing or URL address as detailed in the sections on this page.
-
With all others by providing URL links to the data. Generate URL links within your GenomeSpace account or within a connected storage account, e.g. Dropbox or Google Drive.
When sharing with other GenomeSpace users, you can search for their user name with a partial name or by email address by clicking on the provided  magnifying icon within dialog boxes. If a user has opted-out of being in username searches, then you must know their exact username to share with them. If you wish to opt out of username searches, click on your username in the upper-right and clear the checkbox next to Include me in user searches.
When sharing URL links, considerations differ whether the link is for tool access or for download purposes.
For tool access. If you are providing a URL link for bioinformatic tool access, i.e. visualization, then be sure to check that the tool accepts the generated URL address.
-
A URL address generated within GenomeSpace for a file within a connected storage account will differ from the URL address to the same file generated from the storage account. GenomeSpace preserves 3-letter file extensions required by many bioinformatic tools to recognize and process data while commercial storage accounts may not.
For download. File download links are viable with public data. A public share setting allows anyone with the URL address to access the data. If this is a concern consider the following.
-
Longer link addresses, with random strings of text, provide better security.
-
You can reset to a restrictive share setting after your colleagues have downloaded the data.
-
It's easy to invite your colleagues to join GenomeSpace. Click the Invite a collaborator button next to the GenomeSpace logo (Screenshot).
Get to the share options for your file or folder
You can view the share settings for files and folders within any directory.
|
folder sharing |
-
Click the triangle next to the directory name or right-click and select Sharing in the left directories panel.
-
Select the folder from the main files panel and go to File menu>Sharing.
-
Right-click folder from the main files panel and select Sharing from the pop-up menu.
|
|
file sharing |
-
Select the file checkbox and go to File menu>Sharing.
-
Right-click file and select Sharing from the pop-up menu.
|
The Sharing & Permissions dialog box (Screenshot) will list the file or folder name, the owner, users with which the item is shared with including the owner, the level of privilege for each user, and a button to edit the share setting (#1).
Change sharing & permissions
You can change share settings for a file or folder within directories for which you have read/write permission. Currently these include your user folder and subfolders, connected Dropbox, and Read/Write S3 Buckets. The two levels of permission are read-only (Read) which allows copying, and read-write-delete (Write & Delete in the dialog but otherwise known as Read & Write).
If you grant permissions to a folder, all the files and subfolders in that folder inherit those permissions. In this way you can make your entire User directory writable by a colleague. You cannot remove inherited permissions. Remove permissions from the original top-level folder to which they were applied.
-
Bring up the Sharing & Permissions dialog box as outlined in the previous section. Click the Edit Sharing button.
-
The Edit Sharing & Permissions dialog box displays (Screenshot 2015.02.06).
-
Remove permissions for a shared user (KevinSpacey in example) by clicking on the red x next to the permission, Read or Write & Delete.
-
Removing a read permission automatically removes extant write & delete permission.
-
Share with another GenomeSpace user by typing in the username and set permission settings.
-
To look up a user name by partial name or complete email address, click the magnifying glass .
-
Share with a group of GenomeSpace users.
-
From the dropdown menu, select which groups to show. Those defined by you (my groups) or by other GenomeSpace users (all groups).
-
Select a group from the second dropdown menu and set permission settings.
-
Click the gear icon
 to manage your groups as detailed in Manage Groups & Tools.
-
Share with all GenomeSpace users (Share with Public) by checking the square box next to Allow public access. Set permissions.
-
Email a message, typed in the field, to the user or group members to which you shared the item.
-
For items made public, no message is sent.
-
To save changes, click the Grant Permissions button and see changes reflected in the dialog box.
Find shared items in the Shared To and Public folders
Depending on the share setting, shared items appear in two locations.
Items you share with others remain in their original directory stucture in your account. In addition, if you've made something public, it will appear in a folder with your user name in the Public folder in the left directories panel.
An item shared to you selectively by another user will appear in a Shared to [your user name] folder in the left directories panel. Items made public by other users appear in the Public folder in subfolders organized by user name.
-
Click on the Filename column header to sort these folders alphabetically.
-
Within the Public folder is a SharedData subfolder containing items shared by the GenomeSpace team, including demo data used in Recipes and presentations from workshops. See Recipe demo datasets for more information.
Create a link that opens a particular directory
Right-clicking a file and selecting View file link from the pop-up menu displays the URL address of the file. The structure of the folder path is preserved in the URL address so you can append a given address by editing the text with the file path of the new folder. Users with share permission to the folder can use the link to access the shared data.
When sharing data with other GenomeSpace users, or perhaps for your own convenience, create a URL that will open the shared folder within a permitted user account. For example, in the following URL address, the section that follows [?pathOrUrl=] shows the directory path and opens the SharedData folder within the Public directory:
|
