A picklist is a dropdown list that provides users with a list of valid values to select from. Filtered picklists contain more complexity and reference other lists in a model: the driver and filter lists. Selections made in a driver list determine what users can select in a filter list.
One-to-many filtered picklists map single list items in a driver list to multiple list items in a filter list. For example, Senior Director in the Role list qualifies for Plan B and Plan C in the Compensation Plan list.
Create your driver and filter lists in General Lists in the model settings bar. Ensure both lists contain list items.
For example, the Role list (driver) includes the Executive, Senior Director, and Team Leader list items. The Compensation List (filter) includes the Plan A, Plan B, and Plan C list items.
Create a list property in the filter list
- Select General Lists in the model settings bar, select the filter list, then select Open.
- Select Properties > Insert, then create a driver list property. For example, Role (driver).
- Select OK.
- Select the driver list property, then select the ellipsis (...) in the Format column.
- Select List in the Type dropdown, then select the driver list in the List dropdown.
- Select OK.
Map list item relationships between the driver and filter lists
- Select Grid View in the filter list.
- Map the relationships between list items in the driver and filter lists. For example, Senior Director maps to Plan B and Plan C.
Parent | Code | Role (driver) | |
Plan A | Executive | ||
Plan B | Senior Director | ||
Plan C | Senior Director | ||
Plan D | Team Leader | ||
Plan E | Staff Member |
Create a module for the filtered picklist
- Select Modules in the model settings bar, then select Insert Module.
- Insert two line items on columns that represent the driver and filter lists. For example, Role and Compensation Plan. In this example, you can also add the Employees list on rows, and remove Time.
- Select OK.
- In Blueprint , select the driver line item, then select the ellipsis (...) in the Format column.
- Select List in the Type dropdown, then select the driver list in the List dropdown.
- Select OK.
- Select the filter line item, then select the ellipsis (...) in the Format column.
- Select List in the Type dropdown, then select the filter list in the List dropdown.
- Select Dependent in the Filter options, then select the driver list in the Filter based on data in dropdown to view combination examples. If you want users to access all list items in the filter list, select Allow access to unfiltered items in the Format dialog to enable Show All at the bottom of the filtered picklist.
- Select OK.
In your module, you can map list items in the driver line item to valid values in the filter line item.
Role | Compensation Plan | |
Employee A | Executive | Plan A |
Employee B | Senior Director | Plan B |
Employee C | Senior Director | Plan C |
Employee D | Team Leader | Plan D |
Employee E | Staff Member | Plan E |