Jump to: navigation, search

Difference between revisions of "Active List Client"

(→‎Introduction)
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{UnderConstructionStart}}
 
{{UnderConstructionStart}}
  
−
==Introduction {{Version/MobileSince|5.1.0.0}}==
+
==Introduction {{Version/WinXSince|5.1.0.0}} {{Version/MobileSince|5.1.0.0}}==
−
If an Active List is defined on a [[Instance|Content Object]] that is associated with an [[MetaProperty#Integer|integer]] [[MetaProperty]], the property is displayed using the existing icon (the same icon applied to properties with a [[UBIK WinX Client Basics#Selective List Properties|SelectiveList]]), followed by the property's display string and the label of the currently selected list item in a closed drop-down component. An ActiveList (i.e., if it has been configured on the server for the content object) always takes precedence over a MetaProperty SelectiveList  
+
If an Active List is defined on a [[Instance|Content Object]] that is associated with an [[MetaProperty#Integer|integer]] [[MetaProperty]], the property is displayed like a usual [[UBIK WinX Client Basics#Selective List Properties|SelectiveList]] which is based on a [[MetaProperty]]. An ActiveList (i.e., if it has been configured on the server for a content object) always takes precedence over a MetaProperty SelectiveList. For editing, it behaves exactly the same as with a standard [[SELECTIVELIST|SelectiveList]].
  
−
For editing, it behaves exactly the same as with a standard SelectiveList. The client uses a dropdown menu UI component and the dropdown menu allows the user to select exactly one value from the Active List.
+
{{Hint|There are no visible differences in the UI between an ActiveList and a MetaProperty SelectiveList.}}
  
−
When the user opens the dropdown:
+
[[Multi_Select_%28UBIK_Client%29#Editing_common_properties_of_selected_items_.28UWP_only.29|Mass editing]] is currently not supported for Properties containing Active Lists.
−
* All available options from the ActiveList are displayed as text labels.
+
−
* The label for each option is shown in the language configured on the web service. If a translation for the configured language is unavailable, the label is displayed in the default language.
+
−
* Each option in the ActiveList has an associated unique integer value that is set to the MetaProperty when selected.
+
−
* Only one option can be selected at a time. Selecting an option updates the MetaProperty value immediately.
+
−
 
+
−
Sorting of items in the dropdown:
+
−
 
+
−
* If all options in the ActiveList have unique sort order values, they are displayed in ascending order of these sort order values.
+
−
* If sort orders are not unique, options with the same sort order are sorted in ascending order by their label.
+
  
 
=== XAML ===
 
=== XAML ===
−
To enable access to an ActiveList from XAML, a new property named SelectiveItems was added to the PropertyViewModel. This property returns the ActiveList if one is configured on the content object; otherwise, it falls back to the SelectiveList defined on the MetaProperty if no ActiveList is available for the content object. Below is an example of how this can be implemented in XAML. For the SelectedItem, it is important to use the PropertyValueToSelectiveItem converter and pass the control’s own ItemsSource path as the ConverterParameter, so that the list can be provided to the converter. This means that no DataTriggers or similar mechanisms are required to switch between ActiveLists and MetaProperty SelectiveLists or to perform any checks.
+
A new SelectiveItems property was added to the PropertyViewModel to enable access to an ActiveList via XAML. No DataTriggers or additional checks are required, as the correct list selection is handled automatically.
  
 
<tabs>
 
<tabs>
−
<tab name="MAUI">
+
<tab name="Mobile (MAUI)">
 
<source lang = "xml">
 
<source lang = "xml">
 +
xmlns:controls="clr-namespace:UBIK.MAUI.Controls"
 +
 
<controls:SfListViewExt
 
<controls:SfListViewExt
 
     x:Name="SelectiveList"
 
     x:Name="SelectiveList"
Line 37: Line 30:
 
<tab name="UWP">
 
<tab name="UWP">
 
<source lang = "xml">
 
<source lang = "xml">
 +
xmlns:controls="using:UBIK.WinX.Controls"
 +
 
<controls:ComboBoxExt
 
<controls:ComboBoxExt
 
     x:Name="ComboBox"
 
     x:Name="ComboBox"
Line 50: Line 45:
 
</tab>
 
</tab>
 
</tabs>
 
</tabs>
 +
 +
 +
== See also ==
 +
* [[UBIK Active Lists|Active Lists Server]]
 +
* [[MROCLS PICK LIST TASK|Pick List Task]]
 +
* [[MRO_Objects_(Client)#Pick_List_Task|MRO Objects (Client) Pick List Task]]
  
 
{{UnderConstructionEnd}}
 
{{UnderConstructionEnd}}
  
−
[[Category:Active List|Active List Client]]
 
 
[[Category:Client|Active List Client]]
 
[[Category:Client|Active List Client]]
 +
[[Category:Mobile|Active List Client]]
 
[[Category:Version 5.1|Active List Client]]
 
[[Category:Version 5.1|Active List Client]]
 +
[[Category:WinX|Active List Client]]

Revision as of 10:01, 20 April 2026

Wiki Under Construction Start.PNG

Introduction

If an Active List is defined on a Content Object that is associated with an integer MetaProperty, the property is displayed like a usual SelectiveList which is based on a MetaProperty. An ActiveList (i.e., if it has been configured on the server for a content object) always takes precedence over a MetaProperty SelectiveList. For editing, it behaves exactly the same as with a standard SelectiveList.

IC Hint square.pngThere are no visible differences in the UI between an ActiveList and a MetaProperty SelectiveList.

Mass editing is currently not supported for Properties containing Active Lists.

XAML

A new SelectiveItems property was added to the PropertyViewModel to enable access to an ActiveList via XAML. No DataTriggers or additional checks are required, as the correct list selection is handled automatically.

Mobile (MAUI)

xmlns:controls="clr-namespace:UBIK.MAUI.Controls"

<controls:SfListViewExt
   x:Name="SelectiveList"
   BindingContext="{TemplateBinding BindingContext}"
   ItemSize="40"
   ItemTemplate="{StaticResource PopupSelectiveListItemTemplate}"
   ItemsSource="{Binding SelectiveItems}"
   SelectedItem="{Binding ValueItem.PropertyValue, Mode=OneWay, Converter={StaticResource PropertyValueToSelectiveItem}, ConverterParameter={Binding Source={x:Reference SelectiveList}, Path=ItemsSource}}"
   SelectionBackground="{DynamicResource UBIKAccentColor}"
   SelectionMode="Single"
   Style="{DynamicResource UBIKListView}" />

UWP

xmlns:controls="using:UBIK.WinX.Controls"

<controls:ComboBoxExt
   x:Name="ComboBox"
   Grid.ColumnSpan="2"
   HorizontalAlignment="Stretch"
   DisplayMemberPath="DisplayText"
   ItemsSource="{Binding PropertyViewModel.SelectiveItems}"
   PlaceholderText="{Binding PropertyEdit_PickerPlaceholder, Source={StaticResource AppResources}}"
   SelectedValue="{Binding PropertyValue, Mode=TwoWay}"
   SelectedValuePath="Value"
   Visibility="{Binding PropertyViewModel.ShowComboBox, Converter={StaticResource BoolToVisConverter}}" />


See also

Wiki Under Construction End.PNG

Retrieved from "https://wiki.augmensys.com/index.php?title=Active_List_Client&oldid=29707"