The Identity Table input allows manipulating larger numbers of references for which a dropdown list would be too cumbersome. Due to the complexity of managing reference values Identity Tables have a number of additional configuration elements, and they also produce a special type of value for the selection choice.
NOTE: The Identity Table allows working with arbitrarily large sets of references, but it only supports delta updates (Adds and Deletes) and does provide a Full property on the result set.
An Identity Table will search for virtual identity objects once a user has started typing a value in the add box. Queries are debounced by 500ms, meaning that at most one query per half second will be executed. Changes are staged as Adding and Deleting options and persist through paging operations until the form page is submitted. The Reset button will clear out any staged changes.
- Default Value Attribute – Identity Tables 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. NOTE: although the identity table CAN be used for Create type operations starting from an empty list, usually the Identity Select will be preferred for this scenario. Most of hte time an Identity Table should be used to edit an existing object with a Default Value Attribute. Note that both direct and reverse references may be selected if they're defined in the virtual identity (Member and Member Of)
- 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 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 Adding and Deleting selection. It produces values to capture in the Form data.
The resulting value will have the structure:
{
Adds: [{ Reference: <id>, Value: <object> }...],
Deletes: [{ Reference: <id>, Value: <object> }...]
}
Comments
0 comments
Please sign in to leave a comment.