You can use external data variables to display data from third-party services in a Nintex Automation Cloud form. You just need to connect the external data variable to the right data source. With external data 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 Data variables tab. For more information, see Data variables.
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.
After you create a data source for a connector, you can use the external data variables in your form. Custom Xtensions added as a data source are also supported.
You can add a data source variable to a Label control through the Insert variable dialog box for its Text field.
- In the Designer tab of the Form designer, drag the Label control onto the canvas.
- Click the control to open the configuration.
- Click or hover over the Text field, and click Insert.
In the Insert variable dialog box, click External data.
In the panel that appears, click Create variable.
Specify a Name.
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.
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.
Click Create variable.
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.
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.
In the field for a form control or rule, click Insert.
The Insert variable dialog appears, displaying the Formula builder.
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.
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.
In the Rules tab of the Form designer, click Add form rule.
Specify the Name of the form rule.
In the first field for If, select a form control, and select an option in the second field.
Note: You can also add a data source variable to an If field.
In the first field for Then, select a Label control, and then in the second field, select Text.
In the third field that appears, click Insert.
Click External data, and insert the data source variable that you want to be displayed when the condition is met.
Click Create rule.
For more information on adding rules, see Rules.