Changes

==== Editors ==== There are couple of available editors to modify different property value types. Clicking on a related property opens a dialog with type-specific editing options. Additionally, every property value editor contains buttons to commit, revert, or cancel the editing.   ===== '''Integer value editor''' =====With the Integer value editor it is possible to enter or edit non-decimal numbered property values.  ===== '''Double value editor''' =====The Double value editor enables the editing of property values consisting of decimal numbers.  ===== '''String value editor''' =====The String value editor enables the entering and editing of text property values, which can contain various types of characters and numbers. String properties can be configured with a [[MetaProperty#Text_2|length restrictionEditors]]. The editor doesn't allow users to confirm values exceeding the limit. It is possible to apply the the content of a scanned marker to the property value. <tabs><tab name="WinX">String value editors in WinX contain a Scan toggle button on the right side of the textbox. Enabling it invokes a scan window including toggle buttons for QR and OCR scanning.When scanning a code, the related content gets applied to the textbox.</tab><tab name="Xamarin">To apply the content of a marker to the String property value in Xamarin, a button with the Command <code>EditPropertyValueCommand</code> and CommandParameter <code>ScanToInput="true"</code> can be used in the UBIKPropertyArea.<source lang = "xml"><Button Command="{Binding EditPropertyValueCommand}"> <Button.CommandParameter> <uc:KeyValueList> <uc:KeyValueParameter Key="ID" Value="TEXT_READWRITE" /> <uc:KeyValueParameter Key="ScanToInput" Value="true" /> </uc:KeyValueList> </Button.CommandParameter></Button></source></tab></tabs>  ===== '''Signature editor''' =====The Signature editor provides the possibility to edit or enter a digital Signature as the value of a Property.Once clicked on such a property, a dialog with a signature field should pop up and enable the user to create a handwritten signature via mouse or touch. It can be created within 5 seconds. Once the time is expired, the stroke freezes. There are also buttons to commit the signature, cancel or revert the editing. Confirmation is only possible if a signature is entered. [[File:signaturetest.JPG|thumb|Signature editor]]  ===== '''File Reference value editor (WinX only)''' =====The File reference value editor provides the possibility to edit or set the reference of a specific file or folder as the value of a property. There can be a filter applied to allow picking only specific file type references. Clicking on such property opens a picker and related to the assigned filter a file/folder can be selected. Via confirmation its reference gets assigned to the property.  ===== '''DateTime value editor''' =====A DateTime property can be edited or set with the DateTime value editor. Clicking on it invokes a window with a picker to select a date and time. The button "Now" selects the current date and time. Additionally, there are buttons to cancel, revert or confirm the editing. Via confirmation the selected Date and Time get assigned to the value of the property.   ===== '''Geo Editor & Teach In''' ===== Editing expected location use GEO coordinate and position it with map (by using UBIK WinX).  * Fill out GEO editor text area* Switch to "Property" tag** Coordinates: [[wiki:SYSCLS GEO|GEO]]<tabs><tab name="WinX">[[File:Geoeditor.PNG|200px|thumb|GEO editor]][[File:GeoMap.PNG|200px|thumb|GEO map]]* Click on "Coordinates" icon, a full screen map will show up with highlighted GEO icon in the middle of the map, represent the coordinates show in the text area* Text box shows GEO information in "LAT." (latitude) "LON." (longitude) "ALT." (altitude)* Click anywhere on the map, the GEO icon will show on the position, text box will show corresponding coordinate* "Teach-in" button will lead the icon to the current real coordinate</tab><tab name="Xamarin">[[File:Xamarin.png|200px|thumb|Xamarin GEO editor]]* Edit "Geo item" text area and click on icon* "Geo item" will show on the screen* The text area will show the same coordinates as previous filled out. The coordinate will be formatted separately in "Latitude", "Longitude" and "Altitude"* "TEACH-IN" will change the GEO to current real coordinate</tab></tabs>  ===== '''Guid editor''' =====[[File:GuidPropertyEditorWiki.PNG|thumb|border|alt=Guid property editor dialog|Guid property editor dialog]] To edit Guid properties (that do not have a selective list available), we have implemented a special system. Since a Guid property always just contains the Guid as a reference to another object, we can use a query to find the object we want to assign to this property. When the Guid property has a FilterQuery datamember (which should contain the guid of a query), it will become editable through this query. Note that this FilterQuery guid will not actually be visible in the client. All this should be setup in the backend, the client has no control over this. When clicking an editable Guid property, you will see a dialog with up to 3 extra buttons added (see image): * View Object:This button will be enabled when there is a valid guid assigned to the property. Clicking this button will immediately navigate to the referenced object.* Edit Property:If the property has a valid FilterQuery assigned to it, clicking this button will launch that query. If no FilterQuery is assigned, this button will be invisible. Although the button is clickable in Multi Select mode, it is currently inoperable.* Clear Property Value:If the property has a guid assigned, the user can press this button to reset the value back to empty. Additionally, if a valid FilterQuery is assigned, the user will see the results of that query ''inline'', if the query delivers 200 results or fewer. The user can select an item from this horizontally scrollable list, and press "OK" to assign the UID of the selected object to the Guid property. This is useful for cases where the user does not want to jump into the full query to be able to select an object. If the user does choose to launch the full query page (or if the query returns over 200 objects), they can click any of the displayed items in the query's child list. When clicking one of them, it will immediately be set as the reference in the original Guid property. To cancel selecting an item (and stop editing the property), simply navigate to any other page (by pressing back, using navigation bar, etc). {{hint|'''Skipping the dialog'''If editing the property in a query page without having to go through the dialog is desired, one can customize the boolean variable "SkipQueryDialog" in UBIKThemes.xaml. If none can be found, simply add the following line into its "Default" ResourceDictionary.<source lang = "xml"><x:Boolean x:Key="SkipQueryDialog">True</x:Boolean></source>This functionality is currently not available for editing common properties in the Multi Select mode.}}