Data source variables

You can use data source variables to display data from third-party services in a Nintex Workflow Cloud form. You just need to connect the data source variable to the right data source. With data source variables, you can fill forms faster and ensure that the data entered is correct because data from third-party services is displayed automatically.

You can add data source variables to Label controls or populate a form control through a rule in the Rules tab. You can also add and manage data source variables from the External data tab. For more information, see External data.

To complete the configuration, you must specify the data source that you want to use. For example, if you want to display an ID from a SharePoint list, you need to add a data source variable that is connected to a SharePoint data source. You can then select the newly added data source variable and insert the SharePoint ID into your form. Once added, you can also use the data source variable in form rules. For example, you can add a rule to display the ID only when a particular condition is met.

To ensure that critical data is made available, you can also control the form's ability to be submitted should data source variables time out, not resolve, or have errors. For more information on the setting for form submissions, see Forms settings.

Supported data sources

After you create a data source for a connector, you can use the data source variables in your form. Custom Xtensions added as a data source are also supported.

For more information on data sources and connectors, see Data sources and Connectors.

Add data source variables to Label controls

You can add a data source variable to a Label control through the Insert dialog box for its Text field.

  1. In the Designer tab of the Form designer, drag the Label control onto the canvas.
  2. Click the control to open the configuration.
  3. Click or hover over the Text field, and click Insert.
  4. In the Insert dialog box, click External data.

  5. In the panel that appears, click Create data source variable.

  6. Specify a Name.

  7. Specify a data source.

    Fields are displayed depending on the specified data source and the Connector linked to the data source. For information on the supported Connectors, see Supported data sources.

  8. Specify the required details related to the data source.  

    Note: When configuring a condition for the data source variable, currently, you can use only form variables or form controls.

    For more information on data sources and Connector fields, see Data sources and Connectors.

  9. Click Create variable.

  10. Navigate to the variable that you want to insert, and then click Insert.

    The variable is added to the Text field of the Label control.

Note: If you want to deny form submissions when data source variables have errors, do not resolve, or time out, go to the General settings page to enable or disable the toggle for form submissions. For more information, see Forms settings.

Add data source variables to formulas

You can add data source variables to formulas through the Variables tab of the Formula builder. You can access the Formula builder when you insert variables with applied formulas to a field. For more information on accessing the Formula builder, see Formula builder.

  1. In the field for a form control or rule, click Insert.

    The Insert dialog appears, displaying the Formula builder.

  2. In the Lookup section, click the Variables tab.

  3. In the External data section, find the data source variable that you want to add, and click Insert.

    The data source variable is added to the Formula area.

Add data source variables to rules

You can add data source variables to a rule through its If and Then fields. For example, you can add a rule to display a data source variable only when a particular condition is met, such as when a specific data is selected from a form control.

  1. In the Rules tab of the Form designer, click Add form rule.

  2. Specify the Name of the form rule.

  3. In the first field for If, select a form control, and in the second field, select Is selected or Is not selected.

    Note: You can also add a data source variable to an If field.

  4. In the first field for Then, select a Label control, and then in the second field, select Text.

  5. In the third field that appears, click Insert.

  6. Click External data, and insert the data source variable that you want to be displayed when the condition is met.

  7. Click Create rule.

    For more information on adding rules, see Rules.

Add data source variables from External data tab

You can add data source variables from the External data tab, and use the created data source variables in your Label controls or rules.

  1. Open a form and click the External data tab.

  2. Click Create data source variable.

  3. Specify a Name.

  4. Specify a data source.

    Fields are displayed depending on the specified data source and the Connector linked to the data source. For information on the supported Connectors, see Supported data sources.

  5. Specify the required details related to the data source.  

    Note: When configuring a condition for the data source variable, you can currently use only form variables or form controls.

    For more information on data sources and Connector fields, see Data sources and Connectors.

  6. Click Create variable.

    The data source variable is added to the list of variables. You can click an object variable from the list to view the variables it contains.

    Note: 
    • To use data source variables, insert the data source variables from a Label control or a form rule. For more information, see Data source variables.

    • If you want to deny form submissions when data source variables have errors, do not resolve, or time out, go to the General settings page to enable or disable the toggle for form submissions. For more information, see Forms settings.

For more information on the External data tab, see External data.