# RapidIdentity Product Guide

##### Action Set Builder

The Action Set Builder is a canvas to choose specific actions from the Actions to build Action Sets. Ensure the finished Action Set is named following the RapidIdentity Connect Standards.

###### Action Set Builder

The Action Set Builder provides a code-based view, allowing users to enter Action Sets manually.

Actions are entered by clicking the Plus icon that appears at the left of the menu. This will prompt the Add Action sidebar.

Clicking the drop-down indicator next to the plus sign provides a selection of possible next actions to add.

###### Action Sets - Keyboard Shortcuts

When the Action Set Builder is in Advanced view, you can quickly find and insert any action using just the keyboard by just starting to type the name of the action, which will automatically place you in the Filter Actions... field and show you a list of actions matching what you've started typing. Once the desired action is selected in the list, pressing the Enter key will cause that action to be inserted at the current location in the Action Editor, and an additional press of Enter will start editing the first property of the action.

Additionally, for some of the most common actions, there are shortcut keys that can be pressed to automatically insert the action and, where appropriate, start editing the properties, all with a single keystroke. These numbers are shown on the top of the screen next to the Search bar.

### Note

Other keyboard shortcuts that can be used here are + (or the Insert key) to perform the Insert action, or ^ to perform the Insert before action.

Clicking Add Section prompts a right sidebar to configure the section's label and suppressTrace settings.

### Note

Click to add quotation marks and slashes that will escape a string; click to unescape a string.

Table 304. Connect - Add Section Fields

Field

Description

Supported Types

Label

Give the section a name.

Expression and Variable. Variable allows you to insert the name of an already-defined variable.

suppressTrace

Suppress detailed tracing of the actions in the section.

Boolean, Expression, and Variable. Each type requires a value to be defined.

Clicking Add Action prompts a right sidebar to choose the action to be included in that step. Actions are divided into two categories: Core Actions and User Defined Actions. User Defined Actions will be visible once custom Action Sets are saved to a project. Navigate through the folder categories to find the desired action, or use the Search for action bar at the top of the menu.

Each action has a different set of fields, but the functional commonalities are as follows:

Field Item

Description

Red Asterisk ()

Used next to a field title to denote that the value is required

Escape (quote) value ()

Click this to add characters into the field that will escape the string

Unescape (unquote) value ()

Click this to remove characters from the field

Dropdown List ()

Clicking this will expand a dropdown list of values that can be used in this field

Edit Value ()

Usually used in conjunction with Dropdown List or Password, clicking this icon will replace the current input field with a code editor. This is to support values for the particular field being either inline code expressions or variable names from elsewhere in the context

View Characters ()

Usually used in conjunction with Password, clicking this icon will show the characters entered for a password instead of obscuring it with asterisks

###### Detailed Tracing

The Detailed Tracing option is presented whenever an Action Set is run, either manually from the open Action Set itself or from the project's Action Set screen. A confirmation window will display with this option at the top.

Selecting Enable Detailed Tracing is useful to help "debug" Action Sets that do not run properly. One example of a detailed trace with one error is shown below.

In this Action Set, the variable sample was defined; however the log action was configured to execute the samples variable. Thus, the log action needs to be configured to execute sample to run properly. When fixed, the Action Set runs properly.

Detailed trace allows you to see a log of each action and the value (if any) that it returns. With detailed trace turned off, you will only see errors, warnings, and the output of any explicit log() actions within the Action Set.

The detailed trace is particularly useful for more complicated Action Sets involving the manipulation of records and record fields. The detailed trace displays records and JavaScript objects as formatted JSON to enhance readability. XML objects, date objects, and most Java objects embedded inside the record or JavaScript object display as a string value. Strings display as a string literal, including necessary quotes and escaping.