Action Types
Each Event can have actions assigned to them, and each Action has some specific purpose. Each event can have any number of actions, and different types of actions can do different things.

If you want to delete an action, use the Delete
icon.
Each Action is called in order from top to bottom. To control this execution order, you can reorder the list of Actions using the Up Arrow
and Down Arrow
icons next to the list. However, Actions are not executed synchronously: sequential actions do not wait for any prior Actions to finish executing before running. Thus, if Action 1 is a long-running script, while Action 2 is quick to finish, it is possible that Action 2 will finish before Action 1.

Shared Action Options
The bottom of each action lists a set of options. The options listed in the table below are shared across all action types.
| Specifies whether the action should be used or ignored. |
Prevent Default |
The following feature is new in Ignition version 8.0.15
Click here to check out the other new features
Prevents the browser's default behavior from occurring. Useful when you want to prevent the browser's built-in right-click menu from showing. |
Stop Propagation |
The following feature is new in Ignition version 8.0.15
Click here to check out the other new features
Prevents events from higher up in the component hierarchy from triggering when the selected event triggers. |
Accelerometer Action
Retrieves accelerometer data from the device's accelerometer (a common feature on smartphones). This is a Native App Action, designed to help in gathering data from a mobile device. Each action needs to be configured in two parts:
- The action is run on a mobile device, indicating that a type of data should begin to be gathered.
- As the data is gathered, or once it's finished being gathered, it is sent to the Gateway to be handled by the corresponding Session Event.
Action Setting | Description |
---|
Continuous | Begins recording accelerometer data, which repeatedly updates the accelerometer object in the current session's Session Properties. - Sample Rate indicates how often the accelerometer object should be updated.
- Context provides the opportunity to pass a custom object through to the Accelerometer Data Received Session Event. Note that a session object is already provided to that event script.
|
Batch | Records accelerometer data at a specified interval for a specified rate, then sends the accumulated data to the Gateway, to be handled by the Accelerometer Data Received Session Event. - Sample Rate indicates how often a reading should be made.
- Duration specifies for how long data should be logged.
- Context provides the opportunity to pass a custom object through to the Accelerometer Data Received Session Event. Note that a session object is already provided to that event script.
|
Off | Turns off accelerometer data recording. |
Alter Logging Action
Perspective sessions log their session activity and errors to the logs of the browser they run in. Alter Logging allows us to change how verbose this logging is. This is useful for session debugging.
Action Setting | Description |
---|
Remote Logging Enabled | Indicates whether the browser logs should also be sent to the Gateway to log in the Gateway logs. Note that for all messages to be visible, the Perpective.Client logger must be set to the same logging level as the level indicated in this action. |
Set Logging Level | Dictates how verbose the session's logging should be. A logging level of all (or trace) shows all possible records, while a level of off shows none. Options are: - all
- trace
- debug
- info
- warn
- error
- fatal
- off
|
Dock Action
Allows you to open or close a docked view. The view must be configured as docked in the Page Configuration section of the designer, and must be configured with a dock ID. The dock ID can be whatever you'd like. We'll need it here in order to run the action.
Action Setting | Description |
---|
Dock Action | There are three types of dock actions: - Open: Opens the docked view.
- Close: Closes the docked view.
- Toggle: Toggles the state of the docked view, so opens the view if it currently closed, or closes it when it is currently open.
|
Identifier | The ID of the docked view. Dock ID values can be set when you configure a view as docked. |
Parameters | Parameters that can be passed into the docked view. The name of the parameters must match the name of the view parameters that are already set up. |
Fullscreen Action
The following feature is new in Ignition version
8.0.10
Click here to check out the other new features
Enters full screen mode. Requesting to enter full screen mode only works with events that originate from user interactions. Some browsers may not support full screen requests.
Action Setting | Description |
---|
Enter | Enters full screen mode. |
Exit | Exits full screen mode. |
Toggle | Changes the Session's browser to whichever mode it is not currently in. |
View | Enters full screen mode on a targeted view. |
Page | Enters full screen mode on a targeted page. |
Login and Logout Actions
Logs the current user in or out of the session. The only action property is the Enabled option which specifies whether the action should be used or ignored.
Action Setting | Description |
---|
Ask the IdP to re-authenticate users | Determines how re-authentication requests sent to the Identity Provider will be handled. Note that Identity Providers can choose to ignore re-authentication requests, defaulting to their own behavior. Options are as follows: - Project - Use the re-authentication setting located in the General category of Project Properties.
- Enable - Prompt the user to provide their credentials, even if they're already logged into the session.
- Disable - When selected, the user will not have to provide their credentials if they're already logged in.
|
Navigation Action
The Navigation action allows you to navigate to different views, pages, or URLs from an event. The Navigation action has several modes. Each mode allows for a different type of navigation and different options. The following table lists the types of navigation:
Type | Description |
---|
Page | Navigates to a separate page. Type | Description |
---|
Set Page | A string denoting the page URL of the target page. | Open in new tab | Specifies whether the newly opened page should replace the current page, or open in a new browser tab. |
|
View | |
Url | Navigates to an external web address. Type | Description |
---|
Enter Url | The URL that the action should navigate to. Example: https://inductiveautomation.com/ | Open in new tab: | Specifies whether the newly opened page should replace the current page, or open in a new browser tab. |
|
Popup Action
Opens a view as a popup, or closes an existing popup.
Action Setting | Description |
---|
Popup Action | - Open: Opens a view as a popup.
- Close: Closes an existing popup.
- Toggle: Opens a popup if it isn't open, and closes the popup if it is open.
|
Select View | The path to the view that should appear as a popup. |
Parameters | |
Identifier | A string that specifies a unique popup identity. If you want to close an open popup from a popup action, you'll need to supply the identifier that was used to open it. |
Title | A string of text to display in the titlebar. If omitted, no titlebar is used. |
Show close button | A boolean indicating if a Close Icon should be displayed on the popup. |
Draggable | A boolean indicating if the popup should be able to be dragged to new positions. |
Resizable | A boolean indicating if the popup is allowed to be resized. |
Modal | A boolean indicating if the popup should be modal, meaning it is the only view the user can interact with while open. |
Background dismissible | A boolean indicating if the popup can be dismissed by clicking outside of it. This setting is only applied if the modal option is enabled. If omitted, defaults to false. |
|
The following feature is new in Ignition version 8.0.6
Click here to check out the other new features
Exact Positioning controls where in the session the popup should appear, and how large it should be. If no specifications are given, the popup will open centered at its default size.
|
|
The following feature is new in Ignition version 8.0.6
Click here to check out the other new features
Relative Positioning enables the popup to be positioned based off of the mouse cursor position when used with a Mouse Event. The Circle icon in the center represents the mouse location. The arrows icons represent the location the popup will appear in relation to the user's mouse cursor. Click on an arrow to position the popup window. 
|
Refresh Action
Reloads the current browser tab.
Scan Barcode Action
Allows the user to scan a single barcode on their mobile device, which is then sent to the Gateway and handled by the Barcode Scanned Session Event.
This is a Native App Action, designed to help in gathering data from a mobile device. Each action needs to be configured in two parts:
- The action is run on a mobile device, indicating that a type of data should begin to be gathered.
- As the data is gathered, or once it's finished being gathered, it is sent to the Gateway to be handled by the corresponding Session Event.
Action Setting | Description |
---|
Barcode Type | Indicates the format of the barcode to be scanned. Any can be used to catch all barcodes. |
Context | Provides the opportunity to pass a custom object through to the Barcode Scanned Session Event. Note that a session object is already provided to that event script. |
Scan Ndef NFC Action
Allows the Perspective app to catch any scans by the phone using the NFC data exchange format (Ndef), which is then sent to the Gateway and handled by the NFC Ndef Scanned Session Event. This suppresses any default behavior of the phone in catching the scan.
Action Property | Description |
---|
Single Mode | Listens for a single NDEF scan to send. |
Continuous Mode | Listens indefinitely for NDEF scans, which are sent to the gateway as they are received. |
Off Mode | Turns off listening for NDEF scans. |
Script Action
Write a script that happens on the event specified. See Perspective Component Methods and system.perspective Functions for more details on how to configure script actions.
The following feature is new in Ignition version
8.0.5
Click here to check out the other new features
Script actions contain a built-in "event" object, that further contains values pertaining to the underlying event. As of 8.0.5 these values and descriptions are displayed in the docstring.Theme Action
Changes the theme for the session.
Action Setting | Description |
---|
Select Theme | Theme that will be used, for example dark, light, light-cool etc. Dropdown list of all available themes. |