Changes
== Technical concept ==
The items of a dynamic selective list are instances of [[ContentClass]], also known as {{UBIK}} objects. So selecting a dynamic selective list item is just like selecting a query result item during editing a Guid/link property. In fact, properties having dynamic selective lists are Guid properties and the feature shares the same technology as the general [[UBIK_WinX_Client_Basics#Guid_editor|Guid property editing]]. In other words:
* The items are found through a filter query (specifically a DSL_QUERY);
* The display strings of the selected item are presented as the display value of the property;
=== Data hierarchy ===
To resolve the suitable dynamic selective list items, {{UBIK}} first looks for so-called dependency objects, namely objects that the property being edited depends on. This is done through checking the data hierarchy upward, starting from the object being edited, with the following rules:
* The process is recursive. {{UBIK}} looks up the hierarchy until it either reaches the top/root or finds an object with the [[#Dependency_property_values|dependency property]].
* An object can have multiple parent objects. All those parents are taken into account in the item resolving process. Finding one dependency object along a parent lineage doesn't stop {{UBIK}} from checking the other lineages and this is why it's possible to have multiple dependency objects.
* It's also possible that the dependency object is the one being edited itself.
=== Dependency property values ===
Dependency property values are those values that directly determine which dynamic selective list items are available. Once {{UBIK}} finds the dependency objects in the [[#Data_hierarchy|data hierarchy]], it tries to extract values from the specified properties ([[#Dynamic_selective_list_criteria|dependency property name]]) on those objects.
The values are then used as inputs for the filter query (configured on the property being edited) according to the [[#Dynamic_selective_list_criteria|dynamic selective list criteria]]. From there on, the item resolving process becomes identical to [[Offline_Query_(UBIK_WinX)#Offline_query_criteria|offline querying]].
=== Dynamic selective list criteria ===
{{UBIK}} relies on special objects with the DSL_Criterion_CLS to resolve items dynamically. These objects carry the following properties and each of them serves a different purpose of configurability.
* DYNAMIC_SELECTIVE_LIST: The Guid of the DSL_QUERY instance that should be used in resolving dynamic selective list items.
* DEPENDENCY_CLASS: (Optional) The Guid of the [[MetaClass]] which instructs {{UBIK}} the type of objects to exclusively look for when searching for dependency objects in the data hierarchy. If unspecified, any object having the specified dependency property can be a dependency object.
* DEPENDENCY_PROPERTY_NAME: The name of the property whose values determine the dynamic selective list items.
* QUERY_CRITERION_NAME: The name of the property that the resolved dependency property values should be filled into for querying.
* IS_MULTI_VALUE_STRING: (Optional) Whether the value of the dependency property should be interpreted as multiple string values separated by ";" Defaults to false.
* IGNORE_NULL: (Optional) Whether null dependency property values should serve as a filtering criterion or be ignored. Defaults to false.
==See also==
* [[Offline_Query_(UBIK_WinX)#Offline_query_criteria|Offline query]]
[[Category:Client|Dynamic Selective List (Client)]]
[[Category:WinX|Dynamic Selective List (Client)]]
[[Category:Xamarin|Dynamic Selective List (Client)]]
