Configure widget actions in Appspace Multizone Signage Channels to trigger behavior when a widget event occurs. Widget actions are configured on an individual widget and affect only that widget, while channel actions apply to the whole channel.
For: Communicators and IT Administrators — Multizone Signage Channel Widget Actions
What’s in this article:
Prerequisites
-
You must be a Publisher for the selected location, channel, or channel group. A Manage widget or Manage content grant on a single widget does not include the Actions tab.
-
Create a Multizone Signage Channel and add at least one widget to a layout.
-
Review the available events, targets, and methods in Supported Signage Channel Actions and Events.
Note: Widget actions are configured in the layout editor. A widget opens there with these tabs: Edit, Content, Actions, Properties, and Permissions. The Content tab appears only for Media Zone, RSS Viewer, RSS Ticker, Event Calendar, Table Listing, Text Ticker, Media Container, and Remote Control.
Configure a Widget Action
A widget action combines an event, a target, and a method. The event determines when the action runs, the target determines what the action affects, and the method determines what the action does. The selected widget is the source. The New Action panel does not include a Source field. If the widget has no actions yet, the list shows No actions configured yet.
-
Select Channels from the Appspace menu.
-
Open the Multizone Signage Channel.
-
Select the Edit tab.
-
Select the layout that contains the widget.
-
Select Edit from the layout more options menu.
-
Select the widget you want to configure.
-
Select the Actions tab.
-
Click Add.
-
Select the action event from the Event menu.
-
Select the action target from the Target field.
-
Select the action method from the Method menu.
-
Enter any required method parameters.
-
Click Save on the New Action panel.
-
Click Save on the layout editor header.
The New Action panel opens after you click Add. After you save the panel and the layout, the action appears in the widget actions list.
Tip: You can also open the layout editor from the layout preview. Click the + button on the widget and select Open editor. Clicking a widget that has a Content view opens that content view instead of the layout editor.
Note: The events available on a widget vary by widget type. The methods available vary by the selected Target. Clock and Weather expose only the shared widget events. Remote Control and RSS Ticker expose events but have no widget-specific methods. See Supported Signage Channel Actions and Events.
Note: Confirm the action on the channel Preview tab, not the preview on the Edit page.
Configure Widget Action Conditions
Conditions appear only when the selected event has condition fields. Conditions define the requirements that must be met before the action runs. Many widget events, including Mouse Click / Touch, On Freeze, and On Unfreeze, do not expose condition fields.
-
Select an event that supports conditions.
-
Click + Add under Conditions.
-
Select the condition logic from the Condition Logic menu.
-
Select a condition Field.
-
Select a comparison operator.
-
Enter the condition value.
The action runs only when the configured condition requirements are met.
| Condition Logic | Behavior |
|---|---|
| At least one condition is met | The action runs when any one configured condition is true. |
| All conditions are met | The action runs only when every configured condition is true. |
Comparison operators are equals, not equals, is greater than, is less than, is greater than or equal, is less than or equal, contains, does not contain, starts with, and ends with. For event payload fields, see Supported Signage Channel Actions and Events.
Manage Widget Actions
Use the widget actions list to review, change, or remove the actions configured on a widget. Changes stay in the layout until you click Save on the layout editor header.
To change an action:
-
Select the Actions tab for the widget.
-
Select the action you want to change.
-
Select Edit.
-
Change the event, target, method, or conditions in the Edit Action panel.
-
Click Save on the Edit Action panel.
-
Click Save on the layout editor header.
To remove an action:
-
Select the action you want to remove.
-
Select Delete.
-
Confirm the deletion.
-
Click Save on the layout editor header.
The widget actions list reflects your changes after you save the layout.