Closed Early Access just started: Discover what's coming in v4.0.
Learn more

Dynamic connections

A dynamic connection is a variable that contains a connection.Team connection value

Imagine that you have a scenario that automatically sends emails to multiple email addresses. Your team doesn’t have a team email so you want your colleagues to use their work emails when they run the scenario:

dynamic-connections-usecase-scenario.png

You can set a dynamic connection in both Gmail modules. That way, your teammates can use their own Gmail connections to send the emails when they run the scenario.

[Note] Note
Dynamic connections are available to the Enterprise plan users only.

Creating a scenario with a dynamic connection

Almost every module requires a connection to work properly. To create a scenario with a dynamic connection, you have to assign a connection to build the scenario. Boost.space Integrator calls the initial connection as the “build-time value.”

When you finish the scenario, you can assign a different connection to the dynamic connection anytime.

 

  1. Go to your scenario and select an app module.
  2. Click the button_ell.png button, and then click Create a dynamic connection.

     

    create_dynamic_dropbox.png
  3. In the Dynamic connection name field, type the name of the connection.
  4. Set the Build-time value for the dynamic connection:

     

    1. In the Build-time value, choose a connection to use when building the scenario or click Add to create a new connection.

       

      build-time.png
    2. In the Connection name field, enter a name for the connection.

       

      connection_name_window.png
    3. Click Save. Dropbox prompts you to grant Boost.space Integrator access to your data.
    4. Grant Boost.space Integrator access to your Dropbox account.
    5. Click Save.

    You have set the build-time value for the dynamic connection. You can see the connection in the Build-time value field.

  5. Select whether you want to use the build-time connection as the default or not. Boost.space Integrator uses the default value to run the scenario. You can select a different connection when you run the scenario on-demand.
  6. (Optional): You can select the dynamic connection default value in the Default value selection box or create a new connection with the Add button.
    pdcs-dropbox-new-form-screen-3.png
    [Note] Note
    If you don’t provide a default for the dynamic connection, you can schedule the scenario to On-demand only.
  7. Click Save.

You created a dynamic connection. Now you can continue configuring the module.

[Tip] Tip
You can set the default for the dynamic connection in the scenario inputs interface as well:

pdcs-in-scenario-io.png

You can find the list of dynamic connections:

  • In the module:

     

    dynam_module.png
  • In the Scenarioinputs window:

     

    SI_dynamic.png

    In the Build-time value tab, the dynamic connection with the connection its using:

     

    build_time_both.png

Running a scenario with a dynamic connection

A dynamic connection is like a variable or a container for connections, which is empty until you assign a connection to it. To run a scenario with a dynamic connection, you have to assign a connection to it or use a default. You can either create a new dynamic connection or use an existing one.Creating a scenario with a Dynamic connection

Using an existing dynamic connection

To run a scenario with a dynamic connection, use the scenario inputs. In scenario inputs, assign a connection to the dynamic connection for your scenario run or use the default.

[Note] Note
To run your scenario on schedule, you have to provide a default for your dynamic connections. Boost.space Integrator uses the default connection in scheduled scenario runs.

 

  1. Go to your scenario.
  2. Click Run once. A scenario inputs window appears.

     

    RunOnceInputWithoutPC.png
  3. You can either set up a new connection or use an existing connection.
    • To set up a new connection, click Add. The app prompts you to grant Boost.space Integrator access to your account.
    • To use a connection that already exists, select the connection from the dropdown list.
    [Note] Note
    The dropdown list shows only connections available for the app.
  4. Click OK.

Boost.space Integrator runs the scenario with the selected connections.

Updating a dynamic connection

Compared to other connections, dynamic connections are flexible and can change the value they contain. For example, you might want to assign a different connection to the dynamic connection with each scenario run. This might be practical when you want to frequently use different credentials in the scenario.

Another option is to update just the default for the dynamic connection for scheduled scenario runs.

You can update a dynamic connection:

  • in the app module
  • in scenario inputs

Updating dynamic connections in the app module

 

  1. Open the Connections dropdown list in the app module and find the dynamic connection you want to edit.
  2. Click Edit.

     

    Edit_dynamic.png
  3. Optional: You can change the dynamic connection name as well.
  4. In the Build-time value dropdown list, select the connection you want to assign to the dynamic connection. Click Add, if you want to create a new connection.Creating a scenario with a Dynamic connection

     

    Update_Dynamci.png
  5. Click Save.

You have updated the dynamic connection. When the scenario runs, the dynamic connection will use the connection you assigned.

Updating dynamic connections in the scenario inputs

 

  1. Go to the scenario in which you want to update the dynamic connection.
  2. Click scenario inputs.
  3. Go to the Build-time value tab.

     

    SI_dynamic_builttime.png
  4. Click Edit.
  5. In the dropdown list, select another connection you want to assign to the dynamic connection. Click Add if you want to create a new connection.Creating a scenario with a Dynamic connection
  6. Click Save.

You have updated the dynamic connection. When the scenario runs, the dynamic connection will use the connection you assigned.