Launch URL
Use this command to launch a URL link from a toolbar icon or a context-sensitive cell action. You can embed the Launch URL command in the Command parameter of the Action function. Items launched using Launch commands are independent to the .lvapp from which the item is launched. This command is specific to Longview Apps.
Note: You cannot use the Launch URL command in batch mode.
You can use this command in conjunction with the LVS_HTTPPROTOCOL, LVS_IDENTIFIER, LVS_LANGCODE, LVS_WEBBRIDGE, LVS_WEBBRIDGEPATH, and LVS_WEBSERVER system variables to generate a valid URL to any Longview application. For more information, see the following:
- Using the LVS_HTTPPROTOCOL system variable
- Using the LVS_IDENTIFIER system variable
- Using the LVS_LANGCODE system variable
- Using the LVS_SESSIONID system variable
- Using the LVS_WEBBRIDGE system variable
- Using the LVS_WEBBRIDGEPATH system variable
- Using the LVS_WEBSERVER system variable
where:
- URL is the URL link.
- Variable is optional and is the variable to which to pass the Value. You can pass more than one variable and value pair as long as the variable is unique. For information on variables, see Using tokens, variables, and strings.
- Value is the value to pass to the related Variable.
Note: You can use the optional Variable and Value parameters to pass variables to other Longview applications or as query strings for the URL.
- LaunchOption is optional, specifies the way to open the URL, and is one of the following:
Value Description EXTERNAL [" " IE]
where:
EXTERNAL specifies that the URL opens in a new browser window. This is the default if LaunchOption is not specified, and is the only applicable option for Longview Smart Client in standalone mode.
IE is optional and forces the URL to open externally in Microsoft Internet Explorer. Use this parameter to open any Longview application. If you specify IE, you must precede IE with " ". If you do not specify IE, URLs open in the user’s default browser.
INTERNAL ["Title"]
where:
INTERNAL specifies that the URL opens in a new tab within the client. This is applicable only to Longview Tax and Longview Performance Manager, and is generally used in preconfigured code. The INTERNAL option should only be used to launch URLs that directly return HTML content, as opposed to launching another application via a URL.
Title is optional and is the title for the tab of the launched URL.
Syntax example
Set Variable sFullURL = "$LVS_HttpProtocol$:/"+"/$LVS_WebServer$" + "$LVS_WebBridgePath$" + "Longview.ReportViewer.application" + "?LongviewWebSID=$LVS_SessionID$" + "&LongviewWebBridge=$LVS_WebBridge$" + "&LongviewIdentifier=$LVS_IDENTIFIER$" + "&LongviewLangCode=$LVS_LANGCODE$" + "&LongviewReportName=Controllable Expenses.rtp" + "&selectedSymbols=ENTITIES:$C_ENTITIES$"
Launch URL "$sFullURL$" EXTERNAL " " IE