Create actions that modify input table data

Workbooks support actions that modify data in input tables.

This document explains how to configure actions to insert rows. For more information about actions in Sigma, see Intro to actions.

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.

Add a row

Create an action that adds a new row in the target input table.

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 Insert row.
   Into	Select the existing input table to update with the added row.
   With values	For each column of your input table, select an option to determine the type of value Sigma passes to the inserted row, then define the value. The available options depend on the elements in the workbook. Static values: Passes a specified (fixed) value. Column: Passes the value of the specified table column. Control: Passes the value of the specified control element. Formula: Passes a value based on the defined formula. To leave a column blank, select Static values and leave the value unset.

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.

7. Confirm that the data entry permissions on the input table are set to accept edits in Published mode. See Set data entry permission for more information.