Appboard/2.4/builder/widgets/actions/launch url

Revision as of 20:43, 4 September 2013 by imported>Mike.berman

The "Launch URL" Action loads and displays a pre-configured piece of web content. You can launch the content in the current Widget, in a new window, or in any AppBoard Web Widget.


You can generate custom parameters in the URL that you launch. This provides flexibility for you to generate contextual web pages relevant to the Widget containing the Action.


How To Create a Launch URL Action

For instructions on adding an Action to a Widget, see the general instructions in How To Create an Action in a Widget.

How To Configure a Launch URL Action

Perform the following steps to configure a "Launch URL" Action:


  1. Follow the instructions above to create the basic "Launch URL" Action.
  2. Name: Enter a name for this Action. For convenience, a default name is provided that you may use. The Name is not used anywhere else in AppBoard, and only displayed on this configuration page.
  3. On selection of:
    1. Select "any" or "specific" for the type of data selection by the User that will trigger the Action. When selecting "specific", perform the following additional steps:
      1. Click the Filter button. The Filter Editor is displayed.
      2. Click Add Rule to create one or more rules that indicate what data should trigger the Action, when selected.
      3. Click Close to save the Filter settings.
  4. Under Target, select one of the targeting options:
    • New Window: The URL will be launched in a new browser window, independent of AppBoard.
    • This Window: The URL will replace the Widget that is launching the Action, in Appboard.
    • <Name of a Web Widget>: The URL will replace the selected Web Widget, in Appboard. This Web Widget can be on the same Board as the Widget that is launching the Action, or on a different Board.
  5. Under URL, enter the URL to be launched when the Action is invoked. Note that a list of tokens is provided under Available Tokens, to assist with providing parameters to use n the URL. You can highlight a field name token and copy/paste the token into the URL field using Control-C.
  6. Click Finish to exit the Widget Wizard and test the Action.


Sample Use Cases

Launch a Contextual Map in Another Widget

Suppose you have a Table Widget with data related to a geographical region; each row of the table represents a local area in the region. Next to the table is a Map Widget. When the User clicks on a row in the table, you want to pass that location in to the Map Widget so that the selected local area will be displayed on the map. For instructions on configuring this example, see how to launch a contextual map Channel.


Launch Help URLs in a New Window

As another example, suppose you have a table that lists web pages that provide additional information on a topic. The fields in the table are "CommandName" and "CommandHelpURL", as shown in the following image:


Table With List of Web Links


Perform the following steps to configure the Launch URL Action:


  1. Log in to AppBoard Builder as administrator.
  2. In the Table Widget display, click the lightning bolt icon to go to the Actions Editor.
  3. Add a "Launch URL" Action.
  4. Under Target, select "New Window".
  5. Under Available Tokens, highlight the field name ${CommandHelpURL} and copy the token using Control-C.
  6. Under URL, paste the ${CommandHelpURL} token as the value to be launched. (See image below)
  7. Click Finish.
  8. In the Table Widget display, click a row in the table. A new window is launched with the URL from the selected row.


Configuration of the Example Launch URL Action


Launching File-Based URLs

In some cases, AppBoard can be configured to directly access files on a server through a URL reference. It is possible to represent the paths of local or network files using various forms of URL syntax. Although this can be done, the administrator should be careful to test the file access under all scenarios where AppBoard may be deployed. There are security restrictions that apply to any browser plug-in, and what is accessible depends on the security policy of the browser and the OS where the files are hosted. URLs that work in one environment may not work in another. In some cases, error messages may be displayed back to the user, due to the browser attempting to access a file resource in AppBoard that is not permitted by the network security model.