Displaying Filter Selections from a Blueprint Picklist
Display a sequence of Search Filter options selected from a picklist in a Blueprint.
When using Targeted Search and Blueprint Maker to connect a Search Filter Group to a Blueprint picklist, there are additional display options to consider for display. These include displaying the human readable name (instead of the label) and also displaying human-readable multi-selections in a sequence. The steps and information below describe how to prepare your Blueprint for your preferred display.
Create a Page Blueprint
Begin by following the instructions outlined on Using Targeted Search Filters in a Blueprint Maker Blueprint. When it comes to placing the substitution field that represents your Filter Group picklist selection, proceed to the step below.
Set the substitution field syntax
There are several options to consider when placing and typing out the substitution field that represents your Filter Group picklist. As a reminder, during the Blueprint Wizard process, a user will be prompted to select one or more options comprised of Filters from a Filter Group. As the designer of the Blueprint, you must consider whether to display the human-readable name (AKA display name) or just the label (as text). If displaying human-readable names, you may also want to consider how to display multiple selections (e.g. as a comma-separated sequence). Use the table below to guide your decision.
| Syntax | Example for Blueprint | Example Output (multi-select) |
|---|---|---|
| (no additional syntax) | [[office]] | office-atlanta, office-oakland, office-chicago |
| -human-readable-filters | [[office-human-readable-filters]] | Atlanta Oakland Chicago |
| -human-readable-filters-comma-separated | [[office-human-readable-filters-comma-separated]] | Atlanta, Oakland, Chicago |
| -human-readable-filters-dash-separated | [[office-human-readable-filters-dash-separated]] | Atlanta-Oakland-Chicago |
Proceed with defining your JSON
Continue with the instructions on Using Targeted Search Filters in a Blueprint Maker Blueprint. Ensure that when defining your substitution field in the JSON as a blueprintField object, you set the "type" attribute to "list" and correctly set the "filterGroup" attribute to the name of the Filter Group (e.g. "Offices" in our example here).
