- \n
- You want to limit the number of selections<\/strong> a user can make. For example, you may want the user to only be able to select 3 entities. \u00a0<\/li>\n
- You want to filter\u00a0the hierarchy\u00a0to only show entities of a specific type<\/strong> (primary template).<\/li>\n
- You want the hierarchy to start from a specific child node<\/strong>.<\/li>\n<\/ul>\n
The Entity Selector component consists of a list of entities, along with a set of filters. Here is what an Entity Selector looks like (version 4.4):<\/p>\n
![\"entityselectorshow\"](\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2016\/05\/entityselectorshow.png\")
<\/a><\/p>\nAnd here is what a user can do with an Entity Selector:<\/p>\n
![\"entityselectorshowannot\"](\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2016\/05\/entityselectorshowannot.png\")
<\/a><\/p>\n
\nWhat a User Can Do<\/h2>\n
With the Entity Selector, users can:<\/p>\n
- \n
- Select one or more entities<\/strong> from the list, depending on how the control was configured.\u00a0<\/li>\n
- Find an entity<\/strong> they know exists in the hierarchy. To do this, just start typing the name of an entity into the text box at the top. The list of entities will refresh as you type. When you find the entity you are looking for, click the check box in the list to select it.\u00a0<\/li>\n
- Filter the list of entities<\/strong> by selecting a hierarchy from the drop-down list. The entities in that hierarchy will be displayed in the list. You can click the arrow to scroll through the list until you find the entity you are looking for.<\/li>\n
- You can also further filter by a node<\/strong> in the hierarchy. Start typing the name of the node in the text box next to the drop-down list. As you type, you will be presented with a list of matching nodes - select one of these to display the available entities.<\/li>\n<\/ul>\n
Note that configuration can affect the results, if the control was configured to only show entities of a certain type (primary template).<\/p>\n
<\/i> \u00a0Read all about using the entity selector here: Navigation, Hierarchies, & Entities<\/a><\/p>\n
\nWhat a Page Designer Can Do<\/h2>\n
When configuring the entity selector, a page designer can:<\/p>\n
- \n
- Restrict the user to selecting a single entity (Select Mode = Single<\/em>).<\/li>\n
- Allow the user to select a specific number of entities.\u00a0(Select Mode = Multiple, Number of Selections is specified<\/em>)<\/li>\n
- Allow the user to select as many entities as they want.\u00a0(Select Mode = Multiple,\u00a0Number of Selections is unspecified<\/em>)<\/li>\n
- Restrict the entities shown in the list to be of a certain type (Template Filter is specified<\/em>).<\/li>\n
- When the page is first loaded, have the list of entities start from a specific node in a hierarchy (Start Node is specified<\/em>).<\/li>\n<\/ul>\n
![\"entityselectorconfigex\"](\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2016\/05\/entityselectorconfigex.png\")
<\/a><\/p>\n<\/i> \u00a0Read all about configuring the entity selector here:\u00a0Entity Selector<\/a><\/p>\n
\nConfiguration Tips & Best Practices<\/h2>\n
\n<\/i> \u00a0\u00a0Do not use the Hierarchy control and Entity Selector on the same page<\/strong>. Doing so may result in unexpected behaviours.<\/p>\n<\/div>\n
\u00a0<\/p>\n
You should add the following page defaults to guide the user in selecting the relevant assets:<\/p>\n
- \n
- selectedEntity<\/strong> (type Entity<\/em>) or selectedEntities<\/strong> (type EntityList<\/em>)<\/li>\n
- selectedHierarchy<\/strong> (type Text<\/em>)<\/li>\n<\/ul>\n
![\"defaultvalues2\"](\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2016\/05\/defaultvalues2.png\")
\u00a0\u00a0<\/a>![\"defaultvalues1\"](\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2016\/05\/defaultvalues1.png\")
<\/a><\/p>\nDo you have any other tips to share? Let us know in the comments below!<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"
The Entity Selector is one of the most powerful and commonly used components on a page. It allows users to select different entities from a hierarchy, and have the page data update accordingly. This article describes how to use and configure the Entity Selector.<\/p>\n
- selectedHierarchy<\/strong> (type Text<\/em>)<\/li>\n<\/ul>\n
- Allow the user to select a specific number of entities.\u00a0(Select Mode = Multiple, Number of Selections is specified<\/em>)<\/li>\n
- Find an entity<\/strong> they know exists in the hierarchy. To do this, just start typing the name of an entity into the text box at the top. The list of entities will refresh as you type. When you find the entity you are looking for, click the check box in the list to select it.\u00a0<\/li>\n
- You want to filter\u00a0the hierarchy\u00a0to only show entities of a specific type<\/strong> (primary template).<\/li>\n