Data lookup

This control is supported on Nintex Mobile in online mode only.

Use the Data lookupform control to allow users to select an input from a list of values (through a drop-down list) retrieved from a third-party service.

As a designer, you can configure data lookup form control within your forms to retrieve data from a third-party service. For more information about configuration, see Design a form with Data lookup form control.

Note: When you configure data lookup form control in forms, your third-party service data will be accessible to form designers and participants(end-users).

Before you start

You must configure a data lookup before adding a data lookup form control in your form. For more information, see Data lookups.

Section	Setting	Description
(Unlabeled)	Title	Field title displayed on the published form.
	Customize	Switch toggle to Yes to enable customization of the variable Name of the form control.
	Name	(This field becomes configurable only when you switch the Customize toggle to Yes.) Customizes the name of the variable A placeholder that stores changes each time the workflow runs, such as the information entered in a form, or the name of a file. You can also create variables to store information you use in the workflow, such as an email address. for the field. If the name is not customized, the Title will be used as the variable name.
	Data lookup configuration	Allows you to provide third-party data that users can select from. The displayed data depends on the data lookup you select. If the data lookup is: Configured: The data lookup name is displayed. Unconfigured: The Select a data lookup to use as input option will be displayed. You must configure the data lookup to complete the configuration of the control.
Option configuration	Option label	This field represents individual fields in the third-party services.
	Option value	This field represents values from the selected fields in the third-party services.
	Display first list option from data lookup	Option to auto-populate the form control with the first result returned from the data lookup that you have selected. Yes: Auto populates and displays the first result returned form the data lookup in the form field. No: Set to No by default and the form field is not auto populated.
	Required	Options to make the field a mandatory or optional field in the form. Select from the following options: Yes: Requires entry of value before the form can be submitted. No: Makes the field optional and allows the form to be submitted without an input in this field.
	Visible	Options to show or hide the field in the form. Yes: Displays the field on the form. No: Hides the field on the form.
	Read-only	Options to make the field Read-only. Yes: Displays the field on the published form but does not allow user input. No: Allows user input.
	Placeholder	Default text displayed in the field on the published form. This default text disappears when the user types the first valid character inside the field.
	Description	A description of the field to display below the field on the published form.
	Tooltip	The message which appears when users hover their cursor or click the information icon beside the field in the form.
	Shrink	Reduces the width of the control when placed in a row with other form controls.
	Expand	Increases the width of the control when placed in a row with other form controls.
Styling	CSS class	Add a CSS class to apply a style to this form control. You can create the CSS class in the CSS code editor in form styles. Enter one class name or multiple class names separated by a space. For more information, see Add a custom CSS to individual controls. Note: The CSS Class field is available only if the Custom CSS setting is enabled in Nintex Automation Cloud Form settings.
	Border color	Border color to apply to the field. To select a color, click the color box and use the color picker to specify the color you want. You can click on the color map to select the color or enter the Hex code. To revert back to the global style, click Reset to global style.
	Control fill	The color to fill the inside of the field. To select a color, click the color box and use the color picker to specify the color you want. You can click on the color map to select the color or enter the Hex code. To revert back to the global style, click Reset to global style.
	Control input color	The font color of the input in the field. To select a color, click the color box and use the color picker to specify the color you want. You can click on the color map to select the color or enter the Hex code. To revert back to the global style, click Reset to global style.