Data lookup

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

Before you start 

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

As a designer, you can configure data lookup control within your forms to retrieve data from a third-party service. For more information about configuration, see Design a form with Data lookup 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).

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 source configuration

Allows you to provide third-party data that users can select from. The displayed data depends on the data source you select.

If the data source is:

  • Configured: The data source name is displayed.
  • Unconfigured: The Select a data source to use as input option will be displayed. You must configure the data source 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 source

Option to auto-populate the form control with the first result returned from the Data source that you have selected.

  • Yes: Auto populates and displays the first result returned form the data source 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 a specific control.

Note: The CSS Class field is available only if the Custom CSS setting is enabled in Nintex Workflow 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.

Forms