Create actions that trigger embed iframe events (Beta)

🚩

This documentation describes a public beta feature and is under construction. This documentation should not be considered part of our published documentation until this notice, and the corresponding Beta flag on the feature in Sigma, are removed. As with any beta feature, the feature discussed below is subject to quick, iterative changes. The latest experience in the Sigma service may differ from the contents of this document.

Beta features are subject to the disclaimer on Beta features.

Workbook actions configured in an embedded workbook support interaction with host applications. You can configure an action to send an iframe event from your embedded content to your host application, which can then react to this event with some outcome. For example, you can use these events to add custom tracking, change the UI of your application, or trigger your own application APIs.

This document explains how to configure the Generate iframe event action in an embedded workbook. For more information about actions in Sigma, see Intro to actions. For more information about embedding, see Intro to embedded analytics.

System and user requirements

📘

The following requirements apply to users who configure actions. Users who access and interact with a workbook can typically trigger all existing actions within it. Any restrictions are noted in this document.

The ability to configure actions requires the following:

• You must be assigned an account type with the Full explore or Create, edit, and publish workbooks permission enabled.

• You must be the workbook owner or be granted Can explore¹ or Can edit workbook permission.

1 If you’re granted Can explore workbook permission, you can configure actions but cannot save changes to the workbook’s published version.

This workbook action is only relevant for embedded workbooks. See Intro to embedded analytics for specific requirements for public and secure embedding.

Prerequisites

Configure an event listener and an action:outbound event in your application to receive messages about the user interactions in the embedded workbook. You can then develop custom logic in your host application to respond to these events.

• See Implement inbound and outbound events in embeds for information about about how to send and receive events between a parent application and Sigma.
• See the configuration instructions for the action:outbound event to configure the outbound event required for this workbook action to take effect.

Generate an outbound iframe event

Create an action that generates an outbound iframe event.

1. Open a workbook in Explore or Edit mode.

2. Select the element you want to trigger the action, then click Actions in the side navigation.

3. In the Actions panel, click Add action within an existing sequence, or click Add action sequence to start a new sequence.

4. In the Action modal, configure the required fields to define the response:

   Action	Select Generate iframe event.
   Event name	Enter the name of the event configured in the name property in the action:outbound event in your host application.
   Event key and Key value	Enter the key names and values configured in the values property in the action:outbound event in your host application.

5. If your trigger element is a table, pivot table, or input table, select a column in the When selecting cells in field. The action sequence triggers only when the user selects cells in that column.

6. [optional] If you want the action sequence to execute only in certain circumstances, click More, then click Add condition. See Make an action conditional for more information about action conditions.