Skip to main content

[en] List Box Tool List Box Tool

[en] One Tool Example

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

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

[en] Configure the Tool

[en] Use these options to configure the List Box tool:

  1. [en] Enter the text or question to be displayed: Instruction text displayed to the end-user.

  2. [en] All Checked by Default: Check the check box to show all items in the list as selected to the end user.

  3. [en] Select Tool Mode: Select this option to populate the list with the data types found in the connected tool.

  4. [en] 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. [en] List Values: Select from one of these list-value types to populate the list:

[en] List Value

[en] Description

[en] Field Types

[en] Populates the list with the Designer-supported field types.

[en] External Source

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

[en] Properties

  • [en] Specify the file location of the External Source File.

  • [en] Format the file to contain the Name field in the first column and the Value field in the second column.

[en] 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.

[en] Fields from Connected Tool

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

[en] Properties

  • [en] Show only fields of the following types: Select the field types to populate the list for end-user selection.

  • [en] Include [None]: Include "None" as a valid end-user selection.

[en] Manually set values

[en] Populates the list with manually-entered values.

[en] Properties

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

  • [en] Allocate Datasets

  • [en] Geocoder Datasets

  • [en] Drivetime Datasets

  • [en] Behavior Analysis Datasets

  • [en] Reference Base Maps

[en] Select a dataset to populate the list.

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

[en] File Browse in this Analytic App/Macro

[en] 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.

[en] Properties

  • [en] Show only fields of the following types: Select the field types to populate the list for end-user selection.

  • [en] Include [None]: Include "None" as a valid end-user selection.

[en] Fields from Macro Input

[en] 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.

[en] Properties

  • [en] Show only fields of the following types: Select the field types to populate the list for end-user selection.

  • [en] Include [None]: Include "None" as a valid end-user selection.