Adding Links to Other Websites

A URL hyperlink connects a button, chart, image, KPI, or tabular report to another website (also called an "external URL").

Here are some considerations for using hyperlinks:

• The URL must use HTTPS because Birst is hosted over HTTPS.
• Some websites do not allow their pages to be embedded. If you do not see the web page in the preview window, the site you are attempting to link to may not allow embedding but the link may still work. Save and Publish to confirm.
• The web page cannot be configured with the same-origin policy. This property prevents the web page from being embedded. On Wikipedia see Cross-origin resource sharing.
• The link must use BQL syntax, surrounded by single quotes. For example:
  • 'http://www.bing.com'
• The link can pass query parameters and use BQL. For example:
  • 'http://www.bing.com/?q=' + GetVariable('LoadNumber')
  • 'http://www.bing.com/?q=' + GetPromptValue('Time.Year')
  • 'http://www.bing.com/?q=' + GetPromptValue('Categories.CategoryName’)
• Tip: You can toggle the hyperlink functionality On and Off without losing the settings.

To add a hyperlink to a dashlet

1. Select a dashlet and in the Edit menu click Drill Across (the link icon).
   
2. Click External URL in the Drill Across window.
3. Enter the URL using BQL syntax. The URL must be surrounded by single quotes.
   
   
4. Click Apply.
5. Click Publish to save the dashboard and test the hyperlink.