{"id":14624,"date":"2016-05-02T14:18:48","date_gmt":"2016-05-02T06:18:48","guid":{"rendered":"http:\/\/localhost\/help\/?page_id=14624"},"modified":"2017-12-14T14:34:18","modified_gmt":"2017-12-14T06:34:18","slug":"hierarchy-4-3-2","status":"publish","type":"page","link":"https:\/\/oihelp.corporate.ifs.com\/help\/p2-explorer\/explorer-studio\/controls\/hierarchy\/hierarchy-4-3-2\/","title":{"rendered":"Hierarchy (4.3.2)"},"content":{"rendered":"\n

This article applies to versions 4.3.2 and earlier of P2 Explorer.\u00a0For help on the latest version of the Hierarchy, see Hierarchy<\/a>.<\/p>\n

Overview<\/h3>\n

The hierarchy control allows a user to select an entity from a specific hierarchy. This control is often used in conjunction with the hierarchy picker<\/a>. First, the user selects the hierarchy from the hierarchy picker. The hierarchy control reads this event, and then makes the entities in that hierarchy available to the user, who will pick the entities they are interested in.<\/p>\n

The following diagram shows a hierarchy control:<\/p>\n

\"\"<\/a><\/i><\/div>\n
\u00a0<\/div>\n\n\n\n\n\n\n
Page Size<\/strong>:<\/td>\n\n

Sets the number of entities displayed in the hierarchy before paging begins. This is optional, but recommended to improve performance and usability.<\/p>\n

\"pagesize10\"<\/a><\/p>\n<\/td>\n<\/tr>\n

Single Selection Mode<\/strong>:<\/td>\nAllows the user to only select a single entity. Multiple selections are not allowed.<\/td>\n<\/tr>\n
Selected Entities<\/strong>:<\/td>\nThe name of the event that the hierarchy publishes to. This event will contain the entities that are selected, and other controls (such as a chart) can listen to this event.<\/td>\n<\/tr>\n
Hierarchy Name<\/strong>:<\/td>\nThe name of the hierarchy for which to display entities.\u00a0<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n

Tutorial<\/span><\/h3>\n

In this tutorial, we\u2019ll look at adding a Hierarchy to a page, along with a Selection List. When the user selects entities from the Hierarchy, the Selection List displays the selected entities.\u00a0<\/p>\n

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

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

\n

Step by Step: Creating a Hierarchy That Shows the Selected Entities in a Selection List<\/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

If you have access to the training environment, you can follow the steps exactly as outlined here. Otherwise, you will need to adjust the configuration to suit your data.<\/p>\n

Step 1. Add the Hierarchy to the page<\/strong><\/p>\n

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

Drag and drop the Hierarchy<\/strong> <\/em>component\u00a0onto a grid cell.<\/p>\n

Step 2.\u00a0\u00a0Configure the\u00a0Hierarchy<\/strong><\/p>\n

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

In this step, you\u2019ll notice that the Selected Entities<\/strong><\/em> and Hierarchy Name<\/strong><\/em>\u00a0events are already filled in with defaults. You can change this if you like, but you will need to remember your changes and substitute appropriately for the next step.\u00a0Configure the settings as follows:<\/p>\n