Insert excerpt |
---|
| _Banners |
---|
| _Banners |
---|
name | actionflow |
---|
nopanel | true |
---|
|
This page is for application designers who need to configure functionality for components or events. It explains the properties for the open URL node, which is part of an actionflow.
OverviewOpen URL Node PropertiesImage Modified Use a Insert excerpt |
---|
| _action_url |
---|
| _action_url |
---|
nopanel | true |
---|
| 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. |
Examples
Opening a Web Page
To open a webpage the open URL 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 you want the application user to provide the URL, use a calculate node ensure the URL has the correct format. For example, the following expression uses a switch statement to prepend https://www.
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
) |
The following video shows how an application user types a URL into a field, and the web page then opens.
Image Removed
The underlying actionflow includes an Open URL node, as follows:
Image Removed
Sending an Email
Use the open URL node 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 web client and sets the email address to the one provided.
Image Removed
Provide different URL expressions to populate the email:
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 Body Text Lines
The body is by default one line, that will wordwrap according to the email client settings. In order to split the body over multiple lines or paragraphs, use: %0d%0a
For example, to generate t he following email body text:
This is the body of the email.
This is the second line of the body of the email.
specify:
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." |
Combining Fields
The following expression shows how to create all the different email fields using one expression:
Code Block |
---|
"mailto: " + in.EmailAddress + "?cc=" + in.cc1 + "," + in.cc2 + "&bcc=" + in.bcc + "&subject=" + in.Subject + "&body=" + in.Body |
Calling a Telephone Number
Use the Open URL node to make a VoIP call to a telephone number. Map a valid telephone number to the URL attribute as follows:
Code Block |
---|
'callto:' + in.TelephoneNumber |
The function 'callto:'
causes the browser to open an appropriate VoIP client, such as Microsoft Teams. The VoIP client then calls the number provided. This is illustrated in the following video.
Image Removed
Worked ExampleFor full details on how to create an Open URL node, including worked examples, see Open URL Action Configuration. Insert excerpt |
---|
| _property_tabs |
---|
| _property_tabs |
---|
name | basic-h |
---|
nopanel | true |
---|
|
Insert excerpt |
---|
| _property_toolbar |
---|
| _property_toolbar |
---|
nopanel | true |
---|
|
Insert excerpt |
---|
| _parent |
---|
| _parent |
---|
nopanel | true |
---|
|
Basic SettingsField | Description |
---|
Name | Enter the name for the action node. | Insert excerpt |
---|
| _actionflow_properties |
---|
| _actionflow_properties |
---|
name | show-name |
---|
nopanel | true |
---|
|
| Insert excerpt |
---|
| _actionflow_properties |
---|
| _actionflow_properties |
---|
name | show-text |
---|
nopanel | true |
---|
|
|
AttributesEach open URL node has the following attributes which can be mapped to. Attribute | Type | Description |
---|
Name | String | Optionally specify the browser window, <iframe> or tab into which to load the specified resource. If no name is provided, PhixFlow opens a new browser window. This name must not contain whitespace. | Features | String | Optionally specify a comma-separated list of window features in the form: name=value - 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
For details about specifying window features, see the developer.mozilla.org page Window.open() . | URL | String | Specify the URL of the resource to be opened. This can also be the mailto: and callto: functions, as shown in the examples above. |
Insert excerpt |
---|
| _description |
---|
| _description |
---|
nopanel | true |
---|
|
|
nopanel | true |
---|
Live Search |
---|
spaceKey | @self |
---|
additional | none |
---|
placeholder | Search all help pages |
---|
type | page |
---|
|
Panel |
---|
borderColor | #00374F |
---|
titleColor | white |
---|
titleBGColor | #00374F |
---|
borderStyle | solid |
---|
title | Sections on this page |
---|
|
Table of Contents |
---|
maxLevel | 3 |
---|
indent | 12px |
---|
style | none |
---|
|
|
Learn More
For links to all pages in this topic, see Understanding Actionflows.
Insert excerpt |
---|
_terms_changing | _terms_changing