Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

In advanced search, you can use a SQL-like query to search for items in that view. In the example below, we’re selecting for all files that have a Cell Type of “PSC”.

...

...

Versioning is an essential component of conducting reproducible research. Views can be versioned to create a snapshot of your data at a specific point in time. This snapshot can then be referenced and shared. For example, if you are publishing a collection of sequencing files in a File View, you may want to share your work with others for analysis. You can use the File View to check that your annotations are correct, then create your first version when it’s ready to share. Later, when you’ve added more files and annotations, you can create a second version to share for additional analysis. You can refer back to previous versions to see what Files and Annotations were used at each step of your research.

As you refine a View, changes are saved to the synID (e.g. syn456). Unlike Files, which are automatically versioned anytime the file is changed, you decide when to manually create a View version. Creating a new version adds a number to the parent synID (e.g. syn456.2), which can be used to reference or query that version within Synapse. Navigating to the parent synID (syn456) will always display the most recent changes to the View, regardless of whether you have included them in a version.

Create a View Version

From a View, click Entity View Tools, then select Create a New View Version from the dropdown menu.

Add a label and a comment about this version. Any text entered in the label field is appended with the word “Version” in the version history. For example, entering “Final” as a label appears as “Version Final” in your version history.

Select and Share Versions

Navigate to Entity View Tools and select Version History to see a table with version history information.

Click on your desired version number. After the page updates, your selected version is indicated in bold text in the Version History table, and the View is displayed below.

To return to the current version, click Go to the current version in the top left of the version history.

To share a version, copy the URL at the top of the page to share with other Synapse users, or you can mint a DOI for the selected version.

Delete a Version

To remove a version, navigate to Entity View Tools and select Version History. Click on the “x” on the right hand side of the table to delete a specific version.

Once deleted, a version number cannot be reused. Any URL or Wiki links pointing to a deleted version will break.

Insert a View into a Wiki

...