List Lookup control

Allows users to make selections based on values in a SharePoint list. The selection the user makes can be used to filter the available values in another List Lookup control on the form.

Note: This control is supported in Nintex Mobile, except for noted fields.

Tip: This control is available in the SharePoint category of the Form Controls toolbox.

Control settings

Following are the fields and options visible in the control settings dialog box for this form control.

Note: CSS formatting controls are available in the classic forms designer only. To style responsive forms, configure theme settings in the Properties pane.

Section Field Description Nintex Mobile

General

Name

Assign a name to the control. The name is used for comparison validation and other control references. 

Yes

 

Title (R)

Text to display above the field on the published form. Acts as a label for the control.

Yes

 

Description (R)

Helper text to display under the field on the published form.

Yes

 

ID connected to

The column to bind to the item ID of the returned lookup value. The specified column must be of the type "Single line of text."

Note: The List Lookup control returns both the ID and the text of the item selected in the lookup. Each can be bound to a column in the current list. For Nintex Workflow to act on the returned lookup value, the item ID must be bound to a column (ID connected to).

Yes

 

Text connected to

The column to bind to the item text of the returned lookup value. The specified column must be of the type "Single line of text."

Note: The List Lookup control returns both the ID and the text of the item selected in the lookup. Each can be bound to a column in the current list. For Nintex Workflow to act on the returned lookup value, the item ID must be bound to a column (ID connected to).

Yes

 

Source SharePoint site

The ID or the URL of the SharePoint site that contains the source list. Click Browse to view a list of sites for selection.

Yes

 

Source List

The list name or ID of the source SharePoint list.

Yes

 

Source view

The SharePoint view to source the items from.

Yes

 

List column name

The name of the column to show in the lookup control.

Yes

 

Allow multiple values

Allows the user to select multiple values in the control.

  • Yes
  • No
  • Expression: Evaluate an expression (formula) constructed from reference tokens and functions for a Yes/No value. The expression must resolve to a Yes/No value at runtime to be valid. If the expression does not resolve to a Yes/No value it will revert to the default.

    Note: The Expression option is not supported when accessing the form using NintexMobile Apps.

Yes

Appearance

Visible

Hide or show the control at runtime. Select one of the following options.

  • Yes
  • No
  • Expression: Evaluate an expression (formula) constructed from reference tokens and functions for a Yes/No value. The expression must resolve to a Yes/No value at runtime to be valid. If the expression does not resolve to a Yes/No value it will revert to the default.

Yes

 

Enabled

Enable the control to receive user input at run time. Select one of the following options.

  • Yes
  • No
  • Expression: Evaluate an expression (formula) constructed from reference tokens and functions for a Yes/No value. The expression must resolve to a Yes/No value at runtime to be valid. If the expression does not resolve to a Yes/No value it will revert to the default.

Yes

 

Display format

Type of control to display. Select one of the following options.

  • Drop down list (available when Allow multiple values is set to No): Renders the control as a drop-down list.
  • Option buttons (available when Allow multiple values is set to No): Renders the control as buttons, with one button per value.
  • Default (available when Allow multiple values is set to Yes): Renders the control as an Add/Remove selection box.
  • Check boxes (Multiple-Selection) (available when Allow multiple values is set to Yes): Renders the control as check boxes, with one check box per value.
  • List (Multiple-Selection) (available when Allow multiple values is set to Yes): Renders the control as a list.

Yes

 

Use custom "Please select" text

Specify whether or not to use custom "Please select" text. Select one of the following options.

  • Yes
    • Custom "Please select" text
  • No
  • Expression: Evaluate an expression (formula) constructed from reference tokens and functions for a Yes/No value. The expression must resolve to a Yes/No value at runtime to be valid. If the expression does not resolve to a Yes/No value it will revert to the default.

    • Custom "Please select" text

Yes

Filtering

Filter available selections

Select one of the following options.

  • Display all items: Does not filter available selections.
  • By a control's value
    • Where field: Specify the field.
    • Filtered by control: Specify the control by name.
    • Action when no filter applied
  • By a specified value
    • Where field: Specify the field.
    • Filtered by control: Specify the control by name.
    • Action when no filter applied

Yes

Formatting (C)

Control CSS class

The CSS class to apply to the inner input control.

No

 

CSS class

The CSS class to apply to the control.

Use this setting to apply advanced styling options using custom CSS classes defined in the form settings.

No

 

Border

Specify borders to display. Select zero or more of the following options.

  • Top
  • Bottom
  • Left
  • Right

No

 

Border Style

Specify the style of the border line. Select one of the following options.

  • Default
  • None
  • Dotted
  • Dashed
  • Solid
  • Double
  • Groove
  • Ridge
  • Inset
  • Outset

No

 

Border Width (Pixels)

The width of the line in pixels.

To hide the border, enter zero ("0").

No

 

Border Color

The color of the line.

No

 

Padding Width (Pixels)

The width of the padding between the edge of the control and the content of the control.

No

Validation

Required

Specify whether you want to mandate entry of a value for this field before the form is submitted. Select one of the following options.

  • Yes: Mandates entry of a value for this field.
    • Required error message: The error message to display when the required field is not specified.

  • No: Entry for this field is not mandatory.
  • Expression: Evaluate an expression (formula) constructed from reference tokens and functions for a Yes/No value. The expression must resolve to a Yes/No value at runtime to be valid. If the expression does not resolve to a Yes/No value it will revert to the default.

    • Required error message: The error message to display when the required field is not specified.

Yes

 

Use custom validation (C)

JavaScript function for the control validation.

  • Yes
    • Custom validation function: Specify the JavaScript function name for the client-side custom validation.

      Note: The JavaScript function is to be specified in the Custom JavaScript section within the form settings.

    • Custom error message: The error message to display when an invalid value is entered.

  • No

Custom JavaScript is available in the classic forms designer only.

No

Advanced

Help text

Text to display as a tooltip to guide the completion of the form.

No

 

Control Mode

Select one of the following options.

  • Auto
  • Edit: Force control be in edit mode.
  • Display: Force control to be in display mode.

No

 

Prepend ID to value

Specify whether or not to include the item ID number in front of the value. Select one of the following options.

  • Yes
  • No
  • Expression: Evaluate an expression (formula) constructed from reference tokens and functions for a Yes/No value. The expression must resolve to a Yes/No value at runtime to be valid. If the expression does not resolve to a Yes/No value it will revert to the default.

No

 

Store Client ID in JavaScript variable (C)

Specify whether or not to store the client ID in a JavaScript variable. Select one of the following options.

  • Yes: A JavaScript variable is created to reference the client ID of this control.
    • Client ID JavaScript variable name: The name of the variable to store the client ID in.

  • No

Custom JavaScript is available in the classic forms designer only.

No

 

Resize at runtime (C)

Dynamically adjust size and adjust the form length and position of other controls accordingly. Select one of the following options.

  • Yes
  • No
  • Expression: Evaluate an expression (formula) constructed from reference tokens and functions for a Yes/No value. The expression must resolve to a Yes/No value at runtime to be valid. If the expression does not resolve to a Yes/No value it will revert to the default.

No

(R): Available with the responsive designer only.

(C): Available with the classic designer only.