List Box Tool

List Box Tool

Version:
2023.1
Last modified: May 17, 2023

One Tool Example

List Box has a One Tool Example. Visit Sample Workflows to learn how to access this and many other examples directly in Alteryx Designer.

Use List Box to add a list box where users can make multiple selections in an application or macro.

Configure the Tool

Use these options to configure the List Box tool:

  1. Enter the text or question to be displayed: Instruction text displayed to the end-user.
  2. All Checked by Default: Check the check box to show all items in the list as selected to the end-user.
  3. Select Tool Mode: Select this option to populate the list with the data types found in the connected tool.
  4. Generate Custom List: Select this option to generate a list of the selected values. Specify the format by defining an indicator for Start Text, Separator, and End Text.
  5. List Values: Select from one of these list-value types to populate the list:
List Value     Description
Field Types Populates the list with the Designer-supported field types.
External Source

Populates the list with values from a specified file or database connection.

Properties

  • Specify the file location of the External Source File.
  • Format the file to contain the Name field in the first column and the Value field in the second column.

The end-user selects a name from the list to generate the corresponding value. The file can be a relative path to the saved workflow, but the end-user must have the external source file saved to the same path.

Fields from Connected Tool

Populates the list with the fields found in a connected tool. A tool must be connected to the optional input anchor.

Properties

  • Show only fields of the following types: Select the field types to populate the list for end-user selection.
  • Include [None]: Include "None" as a valid end-user selection.
Manually set values

Populates the list with manually-entered values.

Properties

Enter one data pair per line in the format Name:Value. If no Value is specified, Name is returned as the Value.

  • Allocate Datasets
  • Geocoder Datasets
  • Drivetime Datasets
  • Behavior Analysis Datasets
  • Reference Base Maps

Select a dataset to populate the list.

If the user does not have access to the dataset, the workflow displays an error when the application or macro runs.

File Browse in this Analytic App/Macro

Populates the list with the fields found in the connected File Browse tool. A File Browse interface tool must be connected to the optional input anchor.

Properties

  • Show only fields of the following types: Select the field types to populate the list for end-user selection.
  • Include [None]: Include "None" as a valid end-user selection.
Fields from Macro Input

Populates the list with the fields found in the connected Macro Input tool. A Macro Input tool must be connected to the optional input anchor.

Properties

  • Show only fields of the following types: Select the field types to populate the list for end-user selection.
  • Include [None]: Include "None" as a valid end-user selection.
Was This Page Helpful?

Running into problems or issues with your Alteryx product? Visit the Alteryx Community or contact support. Can't submit this form? Email us.