Contents x
    Workflow Actions - Connect (Advanced)
    • 06 Jun 2025
    • 2 Minutes to read
    • Print
    • Dark
      Light
    Contents

    Workflow Actions - Connect (Advanced)

    • Updated on 06 Jun 2025
    • 2 Minutes to read
    • Print
    • Dark
      Light
    Article summary

    Overview

    Use this feature to run an advanced action set through Connect. An Advanced Connect Action generates output results to be consumed by a subsequent expression within the workflow, and must be configured before the workflow can contain it.

    An Advanced Connect Action Set is expected to return a valid JSON string; the workflow engine parses this JSON and makes the key/value pairs required later in the workflow available.

    Example

    If Connect returns {“key1”:”value1”,“key2”:”value2”}, the values can be used in workflow expressions in subsequent workflow actions.

    For example %{dss.key1} would resolve as value1 and %{dss.key2} would resolve as value2.

    Field

    Required (Y/N)

    Description

    Name

    YES

    Enter a name for this Connect (Advanced) action step.

    Description

    NO

    Optional description of the Connect (Advanced) action step.

    Previous Action

    NO

    A read-only field if a previous action exists,  it will be populated with the name of that action.

    Next Action

    YES

    Choose the next action step to perform after the Connect (Advanced) Action Set has run.

    Connect Action Name

    YES

    Enter the name of the Connect Action Set you want to perform.

    Note

    There is no search or dropdown function for this field, so ensure the Action Set name is entered correctly.

    When referencing an Action Set that is not in the MAIN Connect project, ensure it is referenced by its Fully Qualified Name in the format <project>.<actionset>.

    Value Pairs

    NO

    Enter a value pair: data to send to RapidIdentity Connect if the Action Set requires input parameters. To include more value pairs into this action, click Add Another Value Pair and populate the new field with another set.

    Note

    Value Pairs are input parameters passed to Connect for the Action Set being invoked. To pass string values, the value would need to be contained within single or double quotes. Boolean values should remain unquoted.

    Value Pairs can be static, hard-coded values or Workflow Expressions. For example, if the Action Set needs the idautoID of the Workflow recipient passed as an input parameter {recipient_id}, one option would be to use recipient_id='%{recipient_id}'. If the Action Set needs the full name of the requester, that could be sent as requester_name='%{requester.givenName} %{requester.sn}'.

    Connect Base URL

    NO

    The base URL of the RapidIdentity Connect system.

    Note

    Connect Base URL, Connect Action Username, Connect Action Password, and Enable Trace are only required if Global Connect Integration settings have not been configured or if the URL and credentials required to invoke this Action Set are different.

    Connect Action Username

    NO

    Enter the username credential to be used for the Connect Action Set authorization. This is only required if there is a separate designated credential for a project, or if the Connect instance is separate from the current RapidIdentity tenant.

    Connect Action Password

    NO

    Enter the password credential to be used for the Connect Action Set authorization. This is only required if there is a separate designated credential for a project, or if the Connect instance is separate from the current RapidIdentity tenant.

    Enable Trace

    NO

    Click this checkbox to enable Detailed Tracing of the Action Set in Connect.

    Was this article helpful?
    What's Next