...

Overview

...

Insert excerpt

	_Banners
	_Banners
name	actionflow
nopanel	true

Excerpt

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.

Overview

Image Added

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 Added

The underlying actionflow includes an Open URL node, as follows:

Image Added

Sending an Email

Excerpt

name	emailclient

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 Added

Provide different URL expressions to populate the email:

subject
cc
bcc
body text

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 Added

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 Settings

Field	Description
Name	Enter the name for the action node

...

Pass data through to subsequent action nodes.

Input Connection Points]

Todo-Fiona - duplicate from elsewhere

Calculate Action Expressions

Calculate actions process data using expressions; see pages in the topic Expressions and Scripts.

This section has a toolbar with standard buttons. The grid contains a list of the expressions that the calculate action will perform.

...

Attributes

Each 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

	_

...

The expression properties has sections for Parent Details , Audit Summary and the following Basic Settings:

...

Field

...

Select one of the data types: Todo-Fiona - what does this do?

String
Bigstring
Integer
Float
Decimal
Date
Datetime
Graphic
TrueFalse

...

Enter an expression. To work in a larger pop-up window, click Image Removed.

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
nopanel	true

Versions Compared

Old Version 2

New Version Current

Key

Overview

Overview

Examples

Opening a Web Page

Image Added

Sending an Email

Subject

CC

BCC

Body Text

Adding Body Text Lines

Combining Fields

Calling a Telephone Number

Insert excerpt
_property_tabs
_property_tabs
name basic-h
nopanel true

Basic Settings

Input Connection Points]

Calculate Action Expressions

Attributes

Live Search
spaceKey @self
additional none
placeholder Search all help pages
type page

Page Comparison

Versions Compared

Old Version 2

New Version Current

Key

Overview

Overview

Examples

Opening a Web Page

Image Added

Sending an Email

Subject

CC

BCC

Body Text

Adding Body Text Lines

Combining Fields

Calling a Telephone Number

Insert excerpt_property_tabs_property_tabsnamebasic-hnopaneltrue

Basic Settings

Input Connection Points]

Calculate Action Expressions

Attributes

Live SearchspaceKey@selfadditionalnoneplaceholderSearch all help pagestypepage

Insert excerpt
_property_tabs
_property_tabs
name basic-h
nopanel true

Live Search
spaceKey @self
additional none
placeholder Search all help pages
type page