Connectors

Variable Connector

The Variable connector lets you store and retrieve flow and user attributes as variables in your PingOne DaVinci flow.

Setup

Resources

For information and setup help, see the following:

Configuring the Variable connector

In DaVinci, add a Variable connector. For more information, see Adding a connector.

This connector doesn’t have a configuration at the environment level. You configure it in your flow instead.

Using the connector in a flow

Variables are values that can be read and modified during a flow. In DaVinci, variables allow users to track and adjust values within flows. They can be read and modified during a flow. Variables can be strings, Boolean values, numbers, or objects.

In a flow, variables can be used to track information and a variable’s value can be used to determine which nodes are run within the flow. Every variable has a context, which determines how widely its value is shared. There are three types of variables:

Flow Instance Variable

Persists only for a single execution of a flow. This is useful for storing things temporarily for an execution, such as if you want to store a particular value from one node to use it later in the flow.

Flow Variable

Persists across multiple executions of that flow. This is useful for storing common things that are shared across multiple executions of the same flow.

User Variable

A shadow user must be available in order to use this variable. This capability adds a value to the user’s details or userInfo in DaVinci.

The DaVinci Variable connector has several capabilities that allow you to manage flows, flow instances, and user variables used across flows and instances.

Capabilities

Flow Instance Variable

Add and update flow instance variable

Show details

  • Properties

  • Input Schema

  • Output Schema

saveVariables selectNameValueListColumn

  • default object

    • properties object

  • output object::

Flow Variable

Add and update flow variable

Show details

  • Properties

  • Input Schema

  • Output Schema

saveFlowVariables selectNameValueListColumn

  • default object

    • properties object

  • output object::

Flow Instance variable: Increment by N

Flow instance variables are local to the specific instance of a flow.

Show details

  • Properties

  • Input Schema

  • Output Schema

Local Variable Name textField
incrementCounter textField

  • default object

    • variables object

    • properties object

      • variable

      • incrementCounter

  • output object

    • newValue number

Output Example

 { "newValue" : 4 }

User Variable

Add and update user variables used across flows and flow instances.

Show details

  • Properties

  • Input Schema

  • Output Schema

saveVariables selectNameValueListColumn

  • default object

    • userInfo object required

      User Information record to which the variable is saved.

    • properties object

  • output object::

User variable: Increment by N

If the user is known, variables can contain user context across flows and flow instances.

Show details

  • Properties

  • Input Schema

  • Output Schema

Local Variable Name textField
incrementCounter textField

  • default object

    • userInfo object required

      User Information record to which the variable is saved.

    • properties object

      • variable

      • incrementCounter

  • output object

    • newValue number

Output Example

 { "newValue" : 4 }

Set Language

Set the language to be used for localized content.

Show details

  • Properties

  • Input Schema

  • Output Schema

Locale textField required

The language to be used for localized content. This should be a valid locale code, such as "en-US" or "fr-FR".

  • default object

    • properties object

      • locale string required

  • language string