Versions Compared

Key

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

Insert excerpt
_Banners
_Banners
nameactionflow
nopaneltrue


This page provides details of the properties for the 

Insert excerpt
_action_url
_action_url
nopaneltrue
action node. These are part of actionflows.

Overview

Use a 

Insert excerpt
_action_url
_action_url
nopaneltrue
node in an actionflow to open a URL in a new tab once the actionflow has completed. The node can also be used to send emails and call telephone numbers.

Live Search
spaceKey@self
additionalnone
placeholderSearch all help pages
typepage

Panel
borderColor#00374F
titleColorwhite
titleBGColor#00374F
borderStylesolid
titleSections on this page

Table of Contents
maxLevel3
indent12px
stylenone


Examples

Opening a webpage

To open a webpage the node needs a valid URL to be mapped to the URL attribute. The format of the URL must be

Code Block
'https://www.url.com'

If the URL to open is being provided by a user, it is recommended that a calculate node is used to reformat the value. For example the following switch statement can be used:

Code Block
//for URL's to open correctly they must start with https://www.

switch(
    [startsWith(in.URL, "https://"),
        in.URL
    ],
    [startsWith(in.URL, "www."),   
        "https://" + in.URL
    ],
    
    "https://www." + in.URL
    
)

Calling a telephone number

The Open URL node can also be used to call a telephone number. A valid telephone number must be mapped to the URL attribute in the format:

Code Block
'callto:' + in.TelephoneNumber

The function 'callto:' causes the browser to open an appropriate VoIP client (e.g. Microsoft Teams) which then calls the number provided.

Sending an email

In a similar manner to calling a telephone number, the Open URL node can be used to send an email. A valid email address must be mapped to the URL attribute in the format:

Code Block
'mailto:' + in.EmailAddress

The function 'mailto:' causes the browser to open an appropriate email program (e.g. Outlook) and sets the email address to the one provided.

Adding an email subject, cc, bcc and body text

It is also possible to populate the email subject, cc, bcc and body text by altering the format of the URL expression.

Subject

Code Block
'mailto:' + in.EmailAddress + "?subject=" + in.Subject

//or

'mailto:' + in.EmailAddress + "?subject=Email Subject"

cc

Code Block
'mailto:' + in.EmailAddress + "?cc=" + in.cc1 + "," + in.cc2

//or

'mailto:' + in.EmailAddress + "?cc=someoneelse@email.com, another@email.com"

bcc

Code Block
'mailto:' + in.EmailAddress + "?bcc=" + in.cc1 + "," + in.cc2

//or

'mailto:' + in.EmailAddress + "?bcc=someoneelse@email.com, another@email.com"

Body text

Code Block
'mailto:' + in.EmailAddress + "?body=" + in.Body

//or

'mailto:' + in.EmailAddress + "?body=This is the body of the email."

Adding a new line in the body

e.g. 

This is the body of the email.

This is the second line of the body of the email.

Code Block
// use %0d%0a to start a new line

'mailto:' + in.EmailAddress + "?body=This is the body of the email.%0d%0aThis is the second line of the body of the email."

Adding subject, cc, bcc and body

Code Block
"mailto: " + in.EmailAddress + "?cc=" + in.cc1 + "," + in.cc2 + "&bcc=" + in.bcc + "&subject=" + in.Subject + "&body=" + in.Body

Insert excerpt
_property_tabs
_property_tabs
namebasic-h
nopaneltrue

Insert excerpt
_parent
_parent
nopaneltrue

Basic Settings

FieldDescription
NameEnter the name for the action node.
Insert excerpt
_actionflow_properties
_actionflow_properties
nameshow-name
nopaneltrue

Insert excerpt
_actionflow_properties
_actionflow_properties
nameshow-text
nopaneltrue

Attributes

Each open url node has 3 attributes which can be mapped to.

AttributeTypeDescription
URLStringThe url of the resource to be opened. This can also be the mailto: and callto: functions. See above examples.
windowName (optional)StringName of the window, <iframe> or tab into which to load the specified resource. If no name is provided a new window will always be opened. This name should not contain whitespace.
windowFeatures (optional)StringComma-separated list of window features in the form name=value, or for boolean features, just nameThese features include options such as the window's default size and position, whether or not to open a minimal popup window, and so forth. See Window Features for more information.

Insert excerpt
_property_tabs
_property_tabs
nameaccess-h
nopaneltrue

Insert excerpt
_access
_access
nopaneltrue

Insert excerpt
_audit
_audit
nopaneltrue