Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Insert excerpt
_Banners
_Banners
nameactionflow
nopaneltrue

By the end of this chapter you will understand what an Open URL action is and how to use them, and you will have created a Open URL Actionflow in your application.

What is an Open URL Action?

The 

Insert excerpt
_action_url
_action_url
nopaneltrue
 action opens a URL in a new tab. This action node can also be configured to send emails and call telephone numbers. 

The 

Insert excerpt
_action_url
_action_url
nopaneltrue
 action node contains three input parameters, which can be mapped onto:

To open a webpage, a valid URL must be mapped onto the URL attribute, in the format:

Code Block
https://www.phixflow.com

Creating Open URL Actions

  1. Click and drag the 
    Insert excerpt
    _action_url
    _action_url
    nopaneltrue
     icon in the toolbar onto the canvas
  2. Enter a name for the Open URL action, then select Create Action
  3. In the Open URL Action 
    Insert excerpt
    _property_settings
    _property_settings
    nopaneltrue
     on the right, the available Input Parameters can be seen
HTML Comment
hiddentrue

Insert excerpt
Open URL Node
Open URL Node
nopaneltrue

Worked Example

Here's a worked example using the School Data (available from the Learning Centre).

In this example, we are using:

  • Teacher Management screen containing a grid of the School Teachers data - this screen was created using the Tile with Buttons template
Tip

If you are completing this chapter as part of the Actionflow course and using a training instance, this data has already been pre-loaded into the Actionflow Foundation Application.

In

 For this example, we

will use

'll be working on the Teachers data on the Teacher Management screen

to configure

.

We want an icon in a grid in the Teachers grid, on the Teacher Management screen, to open a webpage .

Expand
titleSee screen setup
Image Removed

when clicked. To do this, we will configure an Open URL Action that opens a specified URL when the user clicks an icon.

Open URL Action to Open Webpage

Setup the Input

  1. On the Teacher Management screen, where the Actionflow will be initiated from, click on the attribute, Find Address, on the grid (column header) to open the View Attribute 
    Insert excerpt
    _property_settings
    _property_settings
    nopaneltrue
  2. Click on the 
    Insert excerpt
    _property_tabs
    _property_tabs
    nameaction
    nopaneltrue
  3. Here you will find a blank Actionflow, FindAddress, along with the Action Icon Style you can see in the grid -: 
  4. Click on the Actionflow link, , to open the blank Actionflow
  5. Select Click to Connect and for the input, choose the School_Teachers 
    Insert excerpt
    _view_show_icononly
    _view_show_icononly
    nopaneltrue
     View datasource
    , then select Connect Input
  6. On the Mappings window, drag the attribute, Address, from the left (Teachers View) to into the Drag and Drop area on the right (Input Connection Point)
    1. Select Save
  7. Click and drag the 
    Insert excerpt
    _action_url
    _action_url
    nopaneltrue
     icon from the toolbar onto the canvas
  8. In the Create Open URL Action window enter:
    1. Name: Open Map
    2. Select Create Action
  9. Click and drag the 

    Insert excerpt
    _driving_interface_connection_point
    _driving_interface_connection_point
    nameicon
    nopaneltrue
     icon onto the 
    Insert excerpt
    _action_url
    _action_url
    nopaneltrue
     action node

    Expand
    titleCheckpoint

    Image Added


Setup the Calculate and Open URL Action

We need to add a Calculate Action to the FindAddress Actionflow because the attribute data we want to use for our Open URL node is not in a URL format. We will use a calculate node to turn our address data into a google search.

  1. Click and drag the 
    Insert excerpt
    _action_calculate
    _action_calculate
    nopaneltrue
     icon from the toolbar onto the canvas
  2. In the Create Calculate Action window enter:
    1. Name: Add Prefix
    2. Select Create Action
  3. Drag the Add Prefix Calculate Action node onto the in connector between the 

    Insert excerpt
    _input
    _input
    nopaneltrue
     node and the 
    Insert excerpt
    _action_url
    _action_url
    nopaneltrue
     Open Map Map action node and drop it when the 
    Insert excerpt
    _add_icon
    _add_icon
    nopaneltrue
     icon appears

  4. Right-click on the in connector between the 
    Insert excerpt
    _input
    _input
    nopaneltrue
     
    node and the 
    Insert excerpt
    _actionflow_calculate
    _actionflow_calculate
    nopaneltrue
     and select 
    Insert excerpt
    _open_mappings
    _open_mappings
    nopaneltrue
  5. On the Mappings window, drag the Address attribute from the left to into the Drag and Drop area on the right (calculate action)
    1. Select Save
  6. Click on the Add Prefix Calculate Action to open its 
    Insert excerpt
    _property_settings
    _property_settings
    nopaneltrue
     and in the Output Attributes section click 
    Insert excerpt
    _addIcon
    _addIcon
    nopaneltrue
  7. Create the following attribute:
    1. Name: PrefixedAddress
    2. Type: choose String
    3. Expression: 

      Code Block
      languagejs
      themeEmacs
      "https://www.google.com/search?q="+in.Address


    4. Select

      Insert excerpt
      _finish
      _finish
      nopaneltrue

  8. Right-click on the in connector between the 

    Insert excerpt
    _action_calculate
    _action_calculate
    nopaneltrue
     node action and the 
    Insert excerpt
    _action_url
    _action_url
    nopaneltrue
     and  action and select 
    Insert excerpt
    _open_mappings
    _open_mappings
    nopaneltrue

  9. On the Mappings window, drag the Address  PrefixedAddress attribute from the left (Calculate Action) onto the URL input parameter on the right (Open URL Action)

    1. Select Save
      Expand
      titleCheckpoint

      Image Added

  10. Close the Actionflow to return to the Teacher Management screen
  11. Insert excerpt
    _lock
    _lock
    nopaneltrue
     the screen and press the  icon for a record to see the Actionflow in action
    1. We can see that the Actionflow is working because a new tab will open in your browser, with the Address teacher's address line in a Google search 

1.15 View Action Configuration