Create an output variable

The Outputs form in the designer contains a variable builder for creating data structures of objects and arrays.

Before you begin

Roles required: activity_admin, activity_creator, admin

About this task

Elements in this structure are mapped with parsing rules to specific data contained in payloads returned from an endpoint or host. These variables and their values are then made available locally or for reuse in other activities.

Procedure

  1. Click the + icon in the Outputs column to create a local or output variable.

    Local variables are only available within an activity and are not visible in the data structures displayed in the Custom tab. Output variables are available for reuse in other activities, either individually or as an entire data structure. When you create a new variable of either type, the designer provides a default name of Local1 or Output1.

  2. Type your new variable name in the field and select a data type.

    Variable names must be unique within an array or an object. You can assign a data type of Encrypted to output variables that contain sensitive data. Data protected by encryption is passed to other activities or processes encrypted and is never displayed in plain text.

  3. To change the name of a variable or any of its attributes, double-click the value, type a new value in the editing field, and then press Enter.

    The icon to the left of the name reflects the data type of the variable.

  4. To reorder the variable list, select a row and then drag the row to its new location.

    When you select a row to move it, the pointer icon changes to an up/down arrow icon ().

  5. Drag and drop the row into another location.
  6. To reuse a variable from another activity, drag it from the Custom tab in the palette and drop it onto the Local or Output heading at the top of the variable list. To copy an entire data structure, drag the parent object or array into the variable list header.
    The designer duplicates the copied data structure in the outputs variable builder.
    Figure 1. Reuse of data structures
    Reusing an output variable
  7. To delete a variable, click the delete icon () in the row.