system.vision.openURL

Backwards Compatibility

This function replaces system.net.openURL. Any scripts containing Vision Client scoped functions that were replaced with system.vision syntax will still work to maintain backwards compatibility. Only the system.vision variations will appear in the Script Editor's autocomplete popup.

This function is used in Python Scripting.

Description

Opens the given URL or URI scheme outside of the currently running Client in the application the host operating system deems appropriate. For example, the URL "http://www.google.com" will open in the default web browser, whereas "file://C:\\Report.pdf" will open in Adobe Acrobat. The Windows network-share style path like "\\\\Fileserver\\resources\\machine_manual.pdf" will work in Windows as well.

caution

Be careful not to use this function in a full-screen client, as launching an external program will break your full-screen exclusive mode.

Client Permission Restrictions

This scripting function has no Client Permission restrictions.

Syntax

system.vision.openURL(url)

Parameters

Type	Parameter	Description
String	url	The URL to open in a web browser or other appropriate application.

Returns

Nothing

Scope

Vision Client

Code Examples

Example #1

# This code will open a web page

system.vision.openURL("http://www.google.com")

Example #2

# This code will open a PDF document located at C: on the client computer
# Note the double backslashes are needed because backslash is the escape character
# for Python

system.vision.openURL("file://C:\\myPDF.pdf")

Example #3

# This code would open a PDF document from a Windows-based file server
# Note the double backslashes are needed because backslash is the escape character
# for Python

system.vision.openURL("\\\\MyServer\\MyDocs\\document.pdf")