| Insert excerpt | ||||||||
|---|---|---|---|---|---|---|---|---|
|
This page provides details of the properties for the
action node. These are part of actionflows.Insert excerpt _action_url _action_url nopanel true
Overview
Use a
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.Insert excerpt _action_url _action_url nopanel true
| Live Search | ||||||||
|---|---|---|---|---|---|---|---|---|
|
| Panel | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
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 |
mailto: 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 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 | ||||||||
|---|---|---|---|---|---|---|---|---|
|
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
Basic Settings
| Field | Description | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Name | Enter the name for the action node. | ||||||||||||||||||||
|
|
Attributes
Each open url node has 3 attributes which can be mapped to.
| Attribute | Type | Description |
|---|---|---|
| URL | String | The url of the resource to be opened. This can also be the mailto: and callto: functions. See above examples. |
| windowName (optional) | String | Name 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) | String | Comma-separated list of window features in the form name=value, or for boolean features, just name. These 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 | ||||||||
|---|---|---|---|---|---|---|---|---|
|
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|