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).

Setting Description
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 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.

Required

Selecting Yes, mandates entry of a value before the form can be submitted.

Visible

Selecting Yes, displays the field on the published form.

Read-only

Selecting Yes, displays the field on the published form but does not allow 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.

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