openurl
URL

The openurl statement opens a URL (usually a web page or to create an e-mail message).


Parameters

This statement has one parameter:

url – is the the URL to be opened. If you are opening a web page, it is the absolute URL of the web page, starting with http://. If you are creating an e-mail message, it must begin with mailto: followed by the e-mail address (optionally followed by ? and the e-mail subject).


Description

The openurl statement opens a web page or creates an e-mail messages. (It can also be used to open a document, but we recommend using openanything instead).

To open a web page use the “http://” prefix. This example opens the HTML document Roadshow.html on the web server www.genericsite.com . The HTML document will be opened using the default web browser.

openurl "http://www.genericsite.com/Roadshow.html"

To create a new e-mail message use the “mailto:” prefix followed by the e-mail address. This will open the default e-mail client and create a new e-mail message addressed to the specified person. This example creates a new message addressed to webmaster@myisp.com.

openurl "mailto:webmaster@myisp.com"

To specify a subject for the new e-mail, add a suffix beginning with ?. (Note: Not all e-mail clients support this.) a new e-mail message use the “mailto:” prefix followed by the e-mail address. This example creates a new message addressed to lynn@mt.com with a subject of Your next assignment.

openurl "mailto:lynn@mt.com?Your next assignment"

To open a file on your local disk, use the prefix "file:///" , like this:

openurl "file://My Disk:My Documents:Manual.pdf"

However, we recommend using openanything instead.


Error Messages

Could not open URL – This error occurs if the URL is not valid.


See Also


History

VersionStatusNotes
10.0UpdatedCarried over from Panorama 6, but the name has been changed from shellopendocument (which, for compatibility with older databases, will still work).