Identity Select Form Input

The Identity Select input allows choosing one or more identity references. Due to the complexity of managing reference values Identity Selects have a number of additional configuration elements, and they also produce a special type of value for the selection choice.

NOTE: The Identity Select is limited to manipulating references with less than 100 values. For larger reference collections use an Identity Table

An Identity Select will search for virtual identity objects once a user has started typing a value. Queries are debounced by 500ms, meaning that at most one query per half second will be executed.

• Placeholder – text displayed in an empty select input
• Chips – Indicates that the selection(s) should be displayed with chips instead of comma separated
• Expand Type – Selecting the correct expand type is critical. When configuring an Identity Select you have to choose which attributes to use to display Name and optional sub-title for the selection results. The attributes used to display the values MUST be present in the Expand type (which may be Short, List, Card, or Detail). Choose the smallest Expand Type which contains the chosen attributes as this will improve query performance.
• Default Value Attribute – Identity Selects do not support a normal Default Value rule, due to the complexities of working with references. Instead, if the form is bound to a Virtual Identity, one of the virtual silo's attributes may be chosen as the source of the Default Value.
• Virtual Silo Settings – Lists the virtual identity silo(s) that will be searched for the identity select. Multiple are possible because e.g. group membership might have multiple object types.
  
  If the Virtual Silo Name or Title attributes have a thumbnail photo or icon decorator it will be added as an avatar in the selection and search.
  
  • Name – Required, Choose the Virtual Identity Silo to search
  • Name Attribute – Required, the attribute displayed as the name in the selection and search dropdown
  • Title Attribute – Optional, the attribute displayed as a subtitle under the name value
• Value Rule – This rule is applied to each entry in the default selection, as well as to each searched item. It produces a value to capture in the Form data.
  
  For single selection the resulting value will have the structure:
  { Reference: <id>, Value: <object, value rule result> }
  
  For multiple selection the resulting value will have the structure:
  {
    Adds: [{ Reference: <id>, Value: <object> }...],
    Deletes: [...],
    Full: [{ Reference: <id>, Value: <object> }...]
}