Changes
Added Attributes, Cleanup Intro
[[File:UI_WinX_live_values_map_view.png |thumb|border|alt= Live value properties incorporate the features of tracking certain values including information about the reliability of the displayed value.map view|Live values map view (Windows)]]Such Live values are properties that update themselves frequently within with a configured timespan. In addition, various These properties contain information about freshnessreliability, measurement quality , and synchronization , as well as custom data (attributes). Real-time data, originating from various systems, can be delivered to the client clients with minimum delay. The Android, Xamarin and WinX clients display live values alongside other properties, and they are presented to also shown on the [[Map View|map view]] upon selecting the userspecific object.
== Content Browser ==
The row for live value properties differ differs only slightly from normal property rows. On the left of the property value, below the description, is a connectivity indicator icon (reminding of the connectivity icon from cell phones). The more current the property value and the better its quality is, the better the connectivity is indicated. If all bars are greyed out and a small red cross is shown, the last update happened very long ago or no update was received at all, or the measurement quality is bad. For detailed information about that, the a detail dialog is necessary.
=== Connectivity Indicator ===
{{Clear}}
{{Category/Version|2.5.0}}
== Detail dialog ==
The freshness is very crucial in order to know whether the live property value can be trusted, but there are other influences like how good the measurement itself was. These information gets displayed via a dialog, the user can upon upon clicking the [[Live Values#Freshness Indicator |freshness indicator]] symbol both in the content Browser or the map view.
Within the dialog, serveral detailed information can be seen:
! Description!! Information
|-
| ''Live Value''|| Provides the same information as the row itself, namely value and as an icon the connectivity indicator.
|-
| ''Recentness''|| Displays how long ago the last syncronization was, based on the internal freshness evaluation system.
|-
| ''Last Synchronization''|| Displays the exact timestamp of the last successfull successful synchronization, out of this, the recentness is evaluated.
|-
| ''Measurement time stamp''|| Measurement time stamp provided by the measurement unit itself (for instance a pressure measurement unit). Should It should not be trusted entirely since device time and measurement unti until time could have a huge difference.
|-
| ''Measurement quality''|| Quality information provided by the measurement unit or data collecting instance (e.g. OPCUA Server) which together with the "Recentness" gets combined to evaluate the [[Live Values#Freshness Indicator |freshness indicator]]. In addition, a more detailed description about of the measurement gets displayed if available.
|-
|}
</gallery>
== Attributes ==Attributes are additional data that are sent to clients with every value update. They can be customized where the live values are generated (in the plugin) to contain the unit, formatted value, description, etc. They were introduced in Version 2.6.4. == Accessing from XAML ==Live values can be easily accessed from XAML, as long as the view model has a reference to the '''Properties''' collection. === Displaying all Live Values ===This XAML code will generate a list of all live values of this object:<syntaxhighlight lang="xml"><ListView ItemsSource="{Binding Properties.ImportantLiveItems}"> <ListView.ItemTemplate> <DataTemplate> <Grid Width="100" Height="40"> <FontIcon FontFamily="Segoe MDL2 Assets" Glyph="{CategoryBinding Content.LiveValueQualitySymbol}" HorizontalAlignment="Left"/Version|2> <TextBlock Text="{Binding Content.5DisplayValue}" HorizontalAlignment="Right"/> </Grid> </DataTemplate> </ListView.0ItemTemplate></ListView></syntaxhighlight> === Accessing Single Value ===This code binds the value of the '''LMP_FLOW''' LiveValue-MetaProperty to a <code>TextBlock</code>:<syntaxhighlight lang="xml"><TextBlock Text="{Binding Properties.ImportantLiveItems[LMP_FLOW].Content.Value}"/></syntaxhighlight> Furthermore, you can bind to:* Description* QualitySymbol* Age* LastSync* TimeStamp* Attributes (see below) === Binding to Attributes ===Attributes can be bound to similarly as to the individual value:<syntaxhighlight lang="xml"><TextBlock Text="{Binding Properties.ImportantLiveItems[LMP_FLOW].Content.Attributes[Unit].Value}"/></syntaxhighlight> Furthermore, the following data are available:* Key* Description
[[Category:Android|Live Values]]
[[Category:WinX|Live Values]]
[[Category:Xamarin|Live Values]]
