{"id":3405,"date":"2015-05-01T01:11:39","date_gmt":"2015-04-30T17:11:39","guid":{"rendered":"http:\/\/localhost\/help\/?page_id=3405"},"modified":"2024-06-11T11:05:43","modified_gmt":"2024-06-11T03:05:43","slug":"multi-select-list","status":"publish","type":"page","link":"https:\/\/oihelp.corporate.ifs.com\/help\/p2-explorer\/explorer-studio\/controls\/selection-list\/multi-select-list\/","title":{"rendered":"Multi Select List (4.4)"},"content":{"rendered":"\n

This article applies to the Multi Select List in versions 4.4.0 - 4.4.1 of P2 Explorer. The Multi Select List was renamed to the Selection List<\/a>\u00a0in version 4.4.2. For help on earlier versions, see Multi Select List (4.3.2).\u00a0<\/p>\n

Overview<\/span><\/h3>\n

The Multi Select List allows a user to select multiple items from a defined list. If there are more list items than will fit on the page, the Multi Select List displays a scrollbar that provides\u00a0\"infinite scrolling\" , and also allows users to filter the list options.<\/p>\n

The Multi Select List publishes an event that is a list of items. This event is typically used as an input to a dataset to filter its data. For example, you may want to obtain a subset of entities from a dataset.<\/p>\n

The following diagram shows a Multi Select List component being configured:<\/p>\n

\"Multi<\/a><\/p>\n\n\n\n\n\n\n
Option Values<\/strong>:<\/td>\nThe text that you want the component\u00a0to pass to the\u00a0variable.\u00a0This can either be a set of values in text format, or you can populate the values from a dataset. This value is required.<\/td>\n<\/tr>\n
Option Names<\/strong>:<\/td>\nThe text that you want the component\u00a0to display in the list. This can either be a set of values in text format, or you can populate the values from an event. The names must be listed in the same order as the Option Values. If this is left blank, the Option Values will be displayed.<\/td>\n<\/tr>\n
Selected Options<\/strong>:<\/td>\nThe name of the variable\u00a0that stores the value that the user selects from this control. This is required.<\/td>\n<\/tr>\n
Style<\/strong>:<\/td>\nThe style you want to apply to the Multi Select List component.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n

While this component could be used on a page to select Entities returned from a query, it is important to note that functionality from P2 Server, such as Template Filtering and Data Source Name Replacement, will not be available from this component. Essentially, Explorer will treat these items as text, and not apply any special functionality which could possibly be associated with Entities.<\/p>\n<\/blockquote>\n

\n

Tutorial:\u00a0Populating a Multi Select List From a Dataset<\/span><\/h3>\n

In this tutorial, we\u2019ll look at populating the Multi Select List with entities from a dataset. We'll then use this list to drive a pie chart that shows the\u00a0downtime hours for the entities selected from the Multi Select List.<\/p>\n

\"Multi<\/a><\/p>\n

Let\u2019s go through this process, step-by-step.<\/p>\n

Note<\/strong>: This configuration uses the Sample Data<\/em> table and dataset queries that can be optionally made available\u00a0during initial installation and setup. If you don't have access to this data, you will need to adjust the configuration to suit your data at your site.<\/p>\n

\u00a0<\/p>\n

Step 1. Prepare a Studio Page<\/strong><\/p>\n

\"New<\/p>\n

Before you start, click the New Page<\/strong>\u00a0button on the Home tab of the ribbon. Choose the Grid layout.<\/p>\n

\"Grid<\/p>\n