Changes

HowTo:Configure Hierarchy Filtering

3,401 bytes added, 07:54, 24 October 2017

~~<Descriptive text goes here~~Hierarchy Filtering allows the UBIK data designer to provide filter rules for the global object hierarchy on the client.For example, if a user wants to see all objects having the color green and a certain progress value, we have to create hierarchy filter rules - only allowing to view filterable objects that meet both of these criteria.When the filter is applied, objects that do not meet the criteria will be invisible. This means they will not be seen when browsing through the data and not even be found when doing queries or search operations. The designer can decide which objects are affected by the filtering by declaring objects as [[SYSCLS_HIERARCHYFILTERABLE|hierarchy filterable]] objects. These will be filtered based on the defined criteria. In addition, the designer can also declare objects to be [[SYSCLS_HIERARCHYFILTERABLE|hierachy filterable folder]] objects. These objects are filtered depending if there is visible content inside the data branch beneath this object. By defining these objects and rules, it is possible to thin out whole data branches depending on filter rules.>

{{Template:HowTo/Begin}}

~~= Instructions =~~

~~~~

~~<Give step-by-step instructions, use images, ...>~~

= Studio =

~~<Give step-by-step instructions, use images,~~ * declare the metaclasses to be filtered with the [[SYSCLS_HIERARCHYFILTERABLE|hierarchy filterable classification]].* declare the metaclasses to be used as filterable folder objects with the [[SYSCLS_HIERARCHYFILTERABLEFOLDER|hierarchy filterable folder classification]].* objects that should not be affected by the filtering do not have any of both classifications.>

= Client =

* define a preset file containing the property names of the filter criteria. Place it in the local databse directory ({AppData}\LocalState\Databases\<~~Give step-~~Profile or Project name>\<Profile or Project name>.hfpreset). One filter setting consists of the Property ID to be filteres, and the level of filtering for this property, which is relevant when composing filter rules in the UI. Level 0 is a global filter rule, all other levels will depend from the objects already filtered bythe predecessing filter level.<source lang="xml"><?xml version="1.0" encoding="utf-~~step instructions~~8"?><HierarchyFilterPreset xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <HierarchyFilterSettings> <HierarchyFilterSetting> <PropertyName>MP_DESCRIPTION</PropertyName> <Level>0</Level> </HierarchyFilterSetting> <HierarchyFilterSetting> <PropertyName>MP_BRAND</PropertyName> <Level>1</Level> </HierarchyFilterSetting> <HierarchyFilterSetting> <PropertyName>MP_MODEL</PropertyName> <Level>2</Level> </HierarchyFilterSetting> </HierarchyFilterSettings></HierarchyFilterPreset></source>* define one or more profiles for filtering. Create files having the extension ("*.hfprofile") * a filter rule consists of the property id, ~~use images~~the value to be compared and a comparison mode (StartsWith, Equals)<?xml version="1.0" encoding="utf-8"?><HierarchyFilterRulesProfile xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <Name>HF_CUSTOM_01</Name> <IsDefault>true</IsDefault> <HierarchyFilterRules> <HierarchyFilterRule> <PropertyName>MP_DESCRIPTION</PropertyName> <Value>PUMP</Value> <MatchingMode>StartsWith</MatchingMode> </HierarchyFilterRule> <HierarchyFilterRule> <PropertyName>MP_BRAND</PropertyName> <Value>MÜLLER</Value> <MatchingMode>Equals</MatchingMode> </HierarchyFilterRule> <HierarchyFilterRule> <PropertyName>MP_MODEL</PropertyName> <Value>SUPER</Value> <MatchingMode>StartsWith</MatchingMode> </HierarchyFilterRule> </HierarchyFilterRules></HierarchyFilterRulesProfile>

{{Template:HowTo/End}}

[[Category:How-To|Configure Hierarchy Filtering]]

[[Category:WinX|Configure Hierarchy Filtering]]

BMA

681

edits