87eae20de868054a5abeedeb78a24d3e296b87d5 dschmelt Tue May 21 15:09:55 2019 -0700 Adding notes about TinyURL enabling URL parameters #23030 diff --git src/hg/htdocs/FAQ/FAQlink.html src/hg/htdocs/FAQ/FAQlink.html index d1f14dd..52f72b4 100755 --- src/hg/htdocs/FAQ/FAQlink.html +++ src/hg/htdocs/FAQ/FAQlink.html @@ -19,46 +19,55 @@
  • The hgsid parameter
  • Additional URL parameters
  • Creating a sharable URL to view specific tracks

    How do I create a link to the Genome Browser to share my data?

    The easiest way to save and share tracks from the URL is by logging in to your Genome Browser account and creating a saved session. Saved sessions are a versatile way to share data that may include native annotations, Custom Tracks, Track Hubs, and Assembly Hubs. Note that the <input> format indicates a user choice and not a valid example.

    -You will be able to share Genome Browser sessions with the following link format: +You will be able to share Genome Browser sessions with the following link format:

    http://genome.ucsc.edu/s/<userName>/<sessionName>

    For instructions on creating a saved session, go to the session user guide. If you want to specify track settings in a URL directly, please read the section on -setting track visibility via URL for a complete description. -Note that URL parameters do not work with the shorter session URLs.

    +setting track visibility via URL for a complete description.

    -Or if you prefer a modifiable, longer URL, use the following format:

    -

    http://genome.ucsc.edu/cgi-bin/hgTracks?hgS_doOtherUser=submit&hgS_otherUserName=<userName>&hgS_otherUserSessionName=<SessionName>

    -

    It has the advantage of being able to add additional URL parameters to the end and the -flexibility of replacing "hgTracks" with different tools to share saved settings on the Table -Browser (hgTables), Variant Annotation Integrator (hgVai), or Data Integrator (hgIntegrator). -This will preserve your option selections and can be useful to share.

    +Or if you prefer the older style, which allows you to link to different tools, you may use the +following format:

    +

    http://genome.ucsc.edu/cgi-bin/hgTracks?hgS_doOtherUser=submit&hgS_otherUserName=<userName>&gS_otherUserSessionName=<SessionName>

    +

    +This longer format has the flexibility of replacing "hgTracks" with different tool names to share +saved settings on the Table Browser (hgTables), Variant Annotation Integrator (hgVai), or Data +Integrator (hgIntegrator). This will preserve your option selections and can be useful to share. +The following format will bring the recipient to a user's custom Table Browser selections:

    +

    http://genome.ucsc.edu/cgi-bin/hgTables?hgS_doOtherUser=submit&hgS_otherUserName=<userName>&hgS_otherUserSessionName=<SessionName>

    + +

    Both session link formats have the advantage of being able to add URL parameters to the end. +The shorter link format requires a question mark before any URL parameters, with ampersand +characters separating different parameters like so:

    +

    http://genome.ucsc.edu/s/view/clinicalzoom?textSize=18

    +

    The longer format requires an ampersand between each parameter, like so:

    +

    http://genome.ucsc.edu/cgi-bin/hgTracks?hgS_doOtherUser=submit&hgS_otherUserName=view&hgS_otherUserSessionName=clinicalzoom&textSize=18

    Linking to the Browser at a specific position

    How do I make a link to a specific genome or position?

    You can link to a specific genome assembly and position in the Genome Browser using a URL with the db= and position= parameters. Note that the <input> format indicates a user choice and not a valid example.

    http://genome.ucsc.edu/cgi-bin/hgTracks?db=<assembly>&position=<position>

    Where: