{"id":15351,"date":"2016-05-30T13:01:57","date_gmt":"2016-05-30T05:01:57","guid":{"rendered":"http:\/\/localhost\/help\/?page_id=15351"},"modified":"2024-06-11T11:05:43","modified_gmt":"2024-06-11T03:05:43","slug":"multi-select-list-4-3-2","status":"publish","type":"page","link":"https:\/\/oihelp.corporate.ifs.com\/help\/p2-explorer\/explorer-studio\/controls\/selection-list\/multi-select-list-4-3-2\/","title":{"rendered":"Multi Select List (4.3.2)"},"content":{"rendered":"\n

This article applies to the Multi Select List in versions 4.3.2 and earlier of P2 Explorer. For help on the latest version, see Multi Select List<\/span>.<\/p>\n

Overview<\/span><\/h2>\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

\"multiselectlist\"<\/a><\/p>\n\n\n\n\n\n
Option Values<\/strong>:<\/td>\nThe text that you want the control\u00a0to pass to the event it publishes.\u00a0This can either be a set of values in text format, or you can populate the values from an event<\/a>. This value is required.<\/td>\n<\/tr>\n
Option Names<\/strong>:<\/td>\nThe text that you want the control to 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 values.<\/td>\n<\/tr>\n
Selected Option<\/strong>:<\/td>\nThe name of the event that is published\u00a0when the user selects a value from this control. This value is required.<\/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<\/span><\/h2>\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 chart that shows the\u00a0downtime hours for the entities selected from the Multi Select List.<\/p>\n

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

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

\n

Step by Step: Populating a Multi Select List From a Dataset<\/span><\/h3>\n

Before you start, open a new tab in Explorer and click the \u201cCreate a New Page in Studio Mode\u201d thumbnail. Choose the grid<\/a>\u00a0layout \u2013 you can adjust the rows and columns if you like but it\u2019s not important for this exercise.<\/p>\n

You may need to adjust the configuration to suit the available\u00a0data at your site.<\/p>\n

Step 1. Add and Configure a Text Label<\/strong><\/p>\n

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

Drag and drop\u00a0the Text Label<\/a>\u00a0component\u00a0onto a grid cell, and configure it as follows:<\/p>\n