Jump to: navigation, search

Difference between revisions of "Settings"

(→‎Scan)
 
(38 intermediate revisions by 5 users not shown)
Line 1: Line 1:
−
=Android=
+
= UWP/WinX/Xamarin =
  
−
Settings list provides a list of all the settings that control the client environment, giving the user the possibility to display and configure these settings. The settings are ordered according to theme, the part of environment it's responsible for controlling. Within each theme the settings are sorted alphabetically. Mandatory settings are indicated with a {{key press|*}}  next to the name.
+
There are several categories of settings, each providing a group of configurable options for (a) specific feature(s).
  
 +
{| class="wikitable" style="text-align: center; width: 30%; float:left; margin-left: auto; margin-right: 0px"
 +
|+ Table Legend
 +
|-
 +
! Symbol
 +
! Meaning
 +
|-
 +
| 🟢
 +
|| Supported and accessible in the UI
 +
|-
 +
| 🟡
 +
|| Supported and accessible through [[UBIK_WinX_Client_Basics#Profiles|Profile]] xml
 +
|-
 +
| 🟠
 +
|| Not supported
 +
|-
 +
| ⚪
 +
|| Obsolete
 +
|}
  
−
== Available settings ==
+
<br/>
−
All users have at least access to all settings statet in [[#List of settings|List of settings]]. Additional settings, namely the [[#AR settings|AR settings]] or [[#Demo settings|Demo settings]] are only available if the regarding plugin is part of the application built. {{Tip/Version|Since version 2.5.0 the former system of global settings and user-specific settings has been replaced by user-specific settings only.}}
+
<br/>
 +
<br/>
 +
<br/>
 +
<br/>
 +
<br/>
 +
<br/>
 +
<br/>
 +
<br/>
  
−
=== List of settings ===
 
  
−
The basic stock of settings includes:
+
== General ==
 +
This initial section in the Profile description contains some general settings.
  
−
{| class="wikitable" | width = "75%"
+
{| class="wikitable" | width = "100%"
 
|-
 
|-
−
! Name!! Purpose
+
! style="width:28%; text-align: left" | Name
 +
!! style="width:44%; text-align: left" | Purpose
 +
!! style="width:7%; text-align: center" | WinX
 +
!! style="width:7%; text-align: center" | Xamarin<br/>iOS
 +
!! style="width:7%; text-align: center" | Xamarin<br/>UWP
 +
!! style="width:7%; text-align: center" | Xamarin<br/>Android
 
|-
 
|-
−
| ''AuthServerName''|| The name of the server to connect to for user authentication
+
| ''AutoBranchSync''
 +
|| Denotes whether the automatic branch download below an object will be synchronized automatically or not. It is set to "false" by default. '''This is now obsolete, see General Settings -> EnableAutoBranchDownload instead.'''
 +
(*) Refers to ''EnableAutoBranchDownload''. The Auto Branch Download can be set in the General Settings (UWP & Xamarin).
 +
|| 🟢*
 +
|| 🟢*
 +
|| 🟢*
 +
|| 🟢*
 
|-
 
|-
−
| ''AuthPortNumber''|| The port number to use when connecting to the authentication server (optional)
+
| ''AutoBranchSyncPeriod''
 +
|| Denotes the period for automatic branch synchronization in minutes. Its value is set to "0" by default, when the ''AutoBranchSync'' is set to false. '''Otherwise it should take an other figure. This is now obsolete, see General Settings -> EnableAutoBranchDownload instead.'''
 +
(*) Refers to ''EnableAutoBranchDownload''. The Auto Branch Download can be set in the General Settings (UWP & Xamarin).
 +
|| 🟢*
 +
|| 🟢*
 +
|| 🟢*
 +
|| 🟢*
 
|-
 
|-
−
| ''AuthProtocol''|| The protocol to use for authentication over the Internet (e.g.: HTTPS). {{Version/AndroidSince|2.4.2}}
+
| ''AutoLogoutTime'' {{Version/WinXSince|4.2}}{{Version/XamarinSince|4.2}}
 +
|| Configures the number of minutes of user inactivity before the app automatically logs out. Its value is set to "0" by default, which means the app will never actively log out automatically.
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
| ''UBIKAuthContentService''|| The name of the UBIK authentication service
+
| ''BranchDownloadSubLevels''
 +
|| Determines how a branch download is performed. If not configured (equals to '''0''' by default), an entire branch is downloaded in one attempt. If set to 1 for example, the 1st level children of the selected root is first analyzed, then sub branch downloads are performed for each of the children. Basically the higher the number, the more "fragmented" the branch download becomes. This usually increases the overall download time, but can be helpful for scenarios like really large branches or unstable networks since it has a better chance of finishing smaller individual downloads.
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
| ''MemoryUsage''|| Whether {{UBIK}} should [[Memory Usage (Android)|lazy load]] or [[Memory Usage (Android)|eager load]] all the content. {{Version/AndroidSince|2.4.0}}
+
| ''Customizing''
 +
|| Denote your specific folder for XAMLs that depict how the Content is displayed, here. If, by default, the value is set to ''i:nil='''true''''', then the specific XAML folder is denoted by the name of the Profile at the bottom of the Profile Description.
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
| ''Protocol''|| The protocol to use for data communication over the Internet (e.g.: HTTPS)
+
| ''UICompatibilityLevel''
 +
|| Determines which UI versions the client app should try to be compatible with. In major version updates, UI redesigns can happen and sometimes old UI components might even be completely removed. For example, the app bars are removed since {{Version/WinXSince|4.0}} (level 400) because their features are embedded into other parts of the new UI. For those who want to stick with the previous UI for a while, this setting just needs to set to a level earlier, e.g. 380.
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
| ''PortNumber''|| The port number to use when connecting to the content server (optional)
+
| ''ExpertMode''
 +
|| This boolean field denotes whether the Metadefinitions are updated whenever the Profile of the App is loaded anew or not. By default the value is set to '''false''', i.e. the Metadefinitions are only updated when the Application is initialized the first time, or when all data has been purged.
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
| ''PriorityThreshold''|| Any property with a priority number greater than this integer setting value is regarded as a high priority property and is highlighted when being displayed
+
| ''ShowUnreleasedFeatures''
 +
|| This boolean field denotes whether some unofficially released features/options should be enabled/shown. For example, the developer settings in the Xamarin app is hidden by default and only shown when this value is set to true.
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
| ''UpdateExpirySeconds''|| The number of seconds one has to wait before the same update will be considered necessary. If an update of certain content has just ended successfully and is requested again within the amount of time configured in this setting, the client simply dismisses the new request. However, this setting does not affect [[Forced Updates in Manual Synchronization Mode]].
+
| ''SendCrashReports''
 +
|| Determines whether the device sends crash reports to the App Center or not. '''Please note that the diagnostic data is still saved locally and that all users on the device share the same switch. This means if one user enables crash reports, all users on this device will also send crash reports.'''
 +
Can be set in the General Settings -> Send crash reports (UWP & Xamarin).
 +
|| 🟢
 +
|| 🟢
 +
|| 🟢
 +
|| 🟢
 
|-
 
|-
−
| ''SyncMode''|| The possible values are '''Automatic''', '''Manual Commit''' and '''Offline'''. For more details, please refer to [[Sync Mode]].
+
|''IsFavorite''  
 +
|| This boolean field denotes whether the Profile will be shown as a favourite on top of a list when there are also other Profiles in the Application client available.
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
| ''ShowSystemProperties''|| If set to true, all properties will be displayed; otherwise, only the ones that are marked as [[METACLASSSCOPE#Visibility|visible]].
+
|''LastUsed''  
 +
|| Contains a Timestamp when this profile was used the last time.  
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
| ''UBIKContextName''|| The {{UBIK}} [[CONTEXT]] name
+
|''Name''  
 +
|| This field denotes the name of the Profile. It also determines the name of the subfolder containing XAML customizing files, if the value of the ''Customizing'' field is set to ''i:nil=true'', as well as the name of the subfolder containing database files, if the value of the ''Project'' field is set to ''i:nil=true''. Can be set in the General Settings (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
| ''UBIKApplicationName''|| The {{UBIK}} [[APPLICATION]] name
+
|''Customizing''  
 +
|| This field determines the name of the subfolder containing XAML customizing files. It might be common to have to carry the same name as the ''Name'' field. If it is unspecified (''i:nil=true''), the value of ''Name'' will be used as subfolder name.
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
| ''UBIKContentService''|| The name of the {{UBIK}} content service
+
|''Project''  
−
|-
+
|| This field can name a special project. It determines the name of the subfolder containing database files. It might be common to have to carry the same name as the ''Name'' field. If it is unspecified (''i:nil=true''), the value of ''Name'' will be used as subfolder name. Can be set in the General Settings (UWP).
−
| ''ServerName''|| The name of the server to connect to for fetching content
+
|| 🟢
−
|-
+
|| 🟡
−
| ''ExpectSingleSearchResult''|| If checked, single search results will be displayed in the ContentBrowser immediately instead of being shown in the result list. Available since {{Version/Android|2.5.0}}
+
|| 🟡
 +
|| 🟡
 
|-
 
|-
 
|}
 
|}
  
 +
{{Attention|The UICompatibilityLevel setting tells the client app to be compatible to the specified versions of the UI if possible. This doesn't mean all existing UI customizings are still supported in newer versions of the app. In fact, any feature where this setting has an effect will explicitly mention it. Otherwise, you should always check the "XAML Notes" tab of each version's release note page.}}
  
  
−
=== AR settings ===
 
−
The AR plugin has additional settings:
 
  
−
{| class="wikitable" | width = "75%"
+
== Connection ==
 +
This section contains properties to denote the internal connection settings of the App.
 +
{| class="wikitable" | width = "100%"
 
|-
 
|-
−
! Name!! Purpose
+
! style="width:28%; text-align: left" | Name
 +
!! style="width:44%; text-align: left" | Purpose
 +
!! style="width:7%; text-align: center" | WinX
 +
!! style="width:7%; text-align: center" | Xamarin<br/>iOS
 +
!! style="width:7%; text-align: center" | Xamarin<br/>UWP
 +
!! style="width:7%; text-align: center" | Xamarin<br/>Android
 
|-
 
|-
−
| ''CompassOffsetDegrees'' || The offset in degrees to change the magnetic north and therefore the orientation of the device (global setting).
+
|''Application''  
 +
|| Denotes the name of the Application that will be run, e.g. one could use ''YourApp'' as the name for an Application. Can be set in the Connection Settings (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
| ''Pose Estimation Systems''|| The different  pose estimation systems considered in the [[Location Manager]] can be activated or deactivated with this setting.
+
|''AuthenticationPort''  
 +
|| Denotes the Port used on the Authentication Server. Default values might be: ''443; 777; 888;'' Can be set in the Connection Settings (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
| ''SpatialiteDbPath''|| The path to the sqlite database containing the routing graph. It will be looked for on the public internal storage (Google calls that the "Primary External Storage"), which is NOT the SD-card.
+
|''AuthenticationProtocol''  
 +
|| Denotes which Transfer Protocol for Authentication might be used. By default ''https'' is used. Can be set in the Connection Settings (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
| ''StandardMapZoomLevel''|| Specifies the zoom level, which should be applied when using the zoom features of the [[Map_View]].
+
|''AuthenticationServer''  
 +
|| Denotes the Authentication Server, e.g. ''your.auth-server.net'' could be used. Can be set in the Connection Settings (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
| ''DefaultMapZoomLocation''|| Specifies the position, which should be zoomed to when opening the [[Map_View]] after login.
+
|''AuthenticationService''  
 +
|| Denotes the path on the Authentication Server to the Authentication Service File, e.g. the path might be ''YourFolder/YourApp/USAM/USAM.svc''. In this case the User System Authentication Manager (USAM) is used. Can be set in the Connection Settings (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
| ''ContentDistanceFilterThreshold''|| The threshold in meters up to which billboards are displayed in Augmented Reality activities; also influences the scaling of billboards depending on their distance. {{Version/AndroidSince|2.5.4}}
+
|''AuthenticationServiceConfig''  
 +
|| WSHttpBinding (the default value) or BasicHttpBinding. It should be set according to the [[Configuration_Files/Services.config|webservice configuration]]. Can be set in the Connection Settings -> Content Service Config (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
| ''NFC Scan Result Type''|| Specifies the type of information, which should be extracted from scanned [[RFID tags]]. {{Version/AndroidSince|3.0.0}}
+
|''ConnectionTimeOut''  
 +
|| Denotes the time in seconds when a web service call is dropped by the app. It's necessary so that the app doesn't wait indefinitely in events such as connection lost. The default value is ''300'' seconds. If you know your individual web service calls will take longer, the value should be increased accordingly. Can be set in the Connection Settings -> Time-Out of data connection (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
|}
+
|''ContentPort'' 
−
 
+
|| Denotes the Port used on the Content Server. Default values might be: ''443; 777; 888;'' Often it is the same port as for the one for the Authentication Server.
−
 
+
|| 🟢
−
 
+
|| 🟡
−
=== Demo settings ===
+
|| 🟡
−
 
+
|| 🟡
−
Additionally, the demo application and its unique user specific settings are listed as follows
+
−
 
+
−
{| class="wikitable" | width = "75%"
+
 
|-
 
|-
−
! Name!! Purpose
+
|''ContentProtocol''
 +
|| Denotes which Transfer Protocol for the Content might be used. By default ''https'' is used. Can be set in the Connection Settings (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
| ''NumberPropertyEditor''|| Whether to use the normal keyboard or the [[UBIK Number Pickers]] for editing numeric properties
+
|''ContentServer''  
 +
|| Denotes the Content Server, e.g. ''your.content-server.net'' could be used. Could be the same server as the Authentication Server. Can be set in the Connection Settings (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
| ''CurrentAltitude''|| The (mock) altitude in meters to use in Augmented Reality activities, for non-manual locations (e.g. GPS, since the altutide for this is too inaccurate)
+
|''ContentService''  
 +
|| Denotes the path on the Content Server to the Content Service File, e.g. the path might be ''YourFolder/YourApp/CONTENT/UBIKContent.svc''. Make sure that the path points to the ''UBIKContent.svc'' file. Can be set in the Connection Settings (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
| ''AltitudeOffset''|| The offset in meters to add to the current altitude in Augmented Reality activities (used for configuration of the device height)
+
| ''ContentServiceConfig''
 +
|| WSHttpBinding (the default value) or BasicHttpBinding. It should be set according to the [[Configuration_Files/Services.config|webservice configuration]]. Can be set in the Connection Settings (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
| ''ContentDistanceFilterThreshold''|| The threshold in meters up to which billboards are displayed in Augmented Reality activities
+
|''Context''  
 +
|| Denotes the name of the Context, e.g. ''CXT_YourApp_001''. This context is specified inside UBIK and all the different Metadefintions are loaded from it. Can be set in the Connection Settings (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
| ''SupportIntentTarget''|| The actual Uri / Activity class / app package to be opened as an Android intent when the support action is triggered. {{Version/AndroidSince|2.5.2}}
+
|''SignalingServer''  
 +
|| Denotes the Server for Remote Support.  
 +
|| 🟡
 +
|| 🟠
 +
|| 🟠
 +
|| 🟠
 
|-
 
|-
−
| ''SupportIntentType''|| The type of the target (URI/APP_PACKAGE/ACTIVITY_CLASS) to be opened as an Android intent when the support action is triggered. {{Version/AndroidSince|2.5.2}}
+
|''SyncMode''  
 +
|| Denotes the Synchronization Mode of the Application. Possible Values are: Manual(Online), Offline, Auto; by default the SyncMode is set to ''Manual''. For Version 4.2 and up, the selected Sync Mode gets saved into the current Profile.
 +
|| 🟢
 +
|| 🟢
 +
|| 🟢
 +
|| 🟢
 
|-
 
|-
 
|}
 
|}
Line 100: Line 272:
  
  
−
== Characteristics of settings ==
+
== Content ==
−
 
+
These internal content settings control the behaviors and activities of the content data.
−
Settings have the following characteristics and behavior within the application:
+
{| class="wikitable" | width = "100%"
−
* Available and editable before and after the login.
+
−
* Changes done before login are applied to the next user who attempts to login.
+
−
** This goes for applying presets as well.
+
−
** After applying a preset, changes of settings are also applied.
+
−
** The settings defined are not just used by the user as new settings configuration, but are merged with the settings the user already has, and are overriding them.
+
−
* Changes after login are saved for the user currently logged in. After logout and new login, they are restored, merged with the settings changed before login if there are some and finally they get applied to the user.
+
−
* If a completely new user attempts to login without defining settings before or loading a preset, the default values of the settings as defined for the respective app are used.
+
−
 
+
−
 
+
−
 
+
−
== PreSet actions ==
+
−
 
+
−
=== Load PreSets ===
+
−
 
+
−
The {{key press|Load PreSet}} button can be used to [[HowTo:Load Presets]] onto the settings.
+
−
 
+
−
=== Save PreSets ===
+
−
 
+
−
The {{key press|Save PreSet}} button that is only available after login, can be used to [[HowTo:Save Settings as Presets]].
+
−
 
+
−
= WinX =
+
−
 
+
−
There are several categories of settings, each providing a group of configurable options for (a) specific feature(s).
+
−
 
+
−
== General ==
+
−
This initial section in the Profile description contains some general settings.
+
−
{| class="wikitable" | width = "75%"
+
 
|-
 
|-
−
! Name!! Purpose
+
! style="width:28%; text-align: left" | Name
 +
!! style="width:44%; text-align: left" | Purpose
 +
!! style="width:7%; text-align: center" | WinX
 +
!! style="width:7%; text-align: center" | Xamarin<br/>iOS
 +
!! style="width:7%; text-align: center" | Xamarin<br/>UWP
 +
!! style="width:7%; text-align: center" | Xamarin<br/>Android
 
|-
 
|-
−
| ''AutoBranchSync''|| Denotes whether the automatic branch download below an object will be synchronized automatically or not. It is set to "false" by default.
+
|''AutoSaveMode''
 +
|| If this boolean field is set ''true'' changed Objects will be saved automatically when users leave the relevant pages. Otherwise, the User will see a save button and be asked to save the changes when leaving the relevant pages. Can be set in the General Settings -> Enable auto save mode (UWP).
 +
(*) Supported but not configurable on Xamarin.
 +
|| 🟢
 +
|| 🟡*
 +
|| 🟡*
 +
|| 🟡*
 
|-
 
|-
−
| ''AutoBranchSyncPeriod''|| Denotes the period for automatic branch synchronization in minutes. Its value is set to "0" by default, when the ''AutoBranchSync'' is set to false. Otherwise it should take an other figure.
+
|''ChildPageChildrenPortion''  
 +
|| Denotes the Portion of the visible Content Page Area that is split between the Children of an Object and its Properties. Usually the value is between ''0'' and ''100''. By default it is normally set to ''67'', i.e. taking two thirds of the Content Page Area to display Children of a given Object.
 +
|| ⚪
 +
|| ⚪
 +
|| ⚪
 +
|| ⚪
 
|-
 
|-
−
| ''BranchDownloadSubLevels''|| Denotes which and how many sublevels below a branch should be downloaded. Its value is set to '''0''' by default, i.e. it does not download lower levels automatically.
+
|''ChildPagePropertyPortion''  
 +
|| Denotes the Portion of the visible Content Page Area that is split between the Properties of an Object and its Children . Usually the value is between ''0'' and ''100''. By default it is normally set to ''33'', i. e. taking one third of the Content Page Area to display Properties of a given Object.
 +
|| ⚪
 +
|| ⚪
 +
|| ⚪
 +
|| ⚪
 
|-
 
|-
−
| ''Customizing''|| Denote your specific folder for XAMLs that depict how the Content is displayed, here. If, by default, the value is set to ''i:nil='''true''''', then the specific XAML folder is denoted by the name of the Profile at the bottom of the Profile Description.
+
|''DetailsPageChildrenPortion''  
 +
|| Denotes the Portion of the visible Details Page Area that is split between the Children of an Object and its Properties. Usually the value is between ''0'' and ''100''. By default it is normally set to ''67'', i.e. taking two thirds of the Details Page Area to display Children of a given Object.
 +
|| ⚪
 +
|| ⚪
 +
|| ⚪
 +
|| ⚪
 
|-
 
|-
−
| ''ExpertMode''|| This boolean field denotes whether the Metadefinitions are loaded whenever the Profile of the App is loaded anew or not. By default the value is set to '''false''', i.e. the Metadefinitions are only loaded when the Application is initialized the first time, or when all data has been purged.
+
|''DetailsPagePropertyPortion''  
 +
|| Denotes the Portion of the visible Details Page Area that is split between the Properties of an Object and its Children . Usually the value is between ''0'' and ''100''. By default it is normally set to ''33'', i. e. taking one third of the Details Page Area to display Properties of a given Object.
 +
|| ⚪
 +
|| ⚪
 +
|| ⚪
 +
|| ⚪
 
|-
 
|-
−
|}
+
|''DocumentInternalMode''
−
 
+
|| Denotes whether a Document is truly displayed only inside of the Application, then the boolean field should be set to ''true''. If there should be a preview of the Document available inside the Application only and the Document is to be opened by an external Application, the boolean field should be set to ''false''. By default the field is set to ''false''.
−
 
+
|| ⚪
−
 
+
|| 🟠
−
== Connection ==
+
|| 🟠
−
This section contains properties to denote the internal connection settings of the App.
+
|| 🟠
−
{| class="wikitable" | width = "75%"
+
 
|-
 
|-
−
! Name!! Purpose
+
|''DocumentPageChildrenPortion''
 +
|| Denotes the Portion of the visible Document Page Area that is split between a Document lying beneath an Object and its Properties. Usually the value is between ''0'' and ''100''. By default it is normally set to ''80'', i.e. taking  80% of the Document Page Area to display a Document connected to a given Object.
 +
|| ⚪
 +
|| ⚪
 +
|| ⚪
 +
|| ⚪
 
|-
 
|-
−
|''Application'' || Denotes the name of the Application that will be run, e.g. one could use '''YourApp''' as the name for an Application.
+
|''DocumentPagePropertyPortion''  
 +
|| Denotes the Portion of the visible Document Page Area that is split between the Properties of an Object and a Document belonging to it . Usually the value is between ''0'' and ''100''. By default it is normally set to ''20'', i. e. taking 20% of the Document Page Area to display Properties of a Document belonging to a given Object.
 +
|| ⚪
 +
|| ⚪
 +
|| ⚪
 +
|| ⚪
 
|-
 
|-
−
|''AuthenticationPort'' || Denotes the Port used on the Authentication Server. Default values might be: '''''443; 777; 888;'''''
+
|''DocumentPagePropertyWidth''  
 +
|| Denotes the maximum width (in pixels) that Properties of a Document can take when a Document belonging to an Object is displayed. By default the value is ''300 px''.
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
|''AuthenticationProtocol'' || Denotes which Transfer Protocol for Authentication might be used. By default '''https''' is used.
+
|''[[Content_Logging#Log_setting|EnableSyncLogging]]''
 +
|| Determines whether certain content-related activities should be recorded as log files. Denotes whether a logging of different events, e.g. loading an object, changing a Property on an Object, etc. should take place. By default, this boolean field is set to ''true''. Can be set in the General Settings -> Content logging (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
|''AuthenticationServer'' || Denotes the Authentication Server, e.g. '''your.auth-server.net''' could be used.
+
|''EnableAutoBranchDownload''  
 +
|| Denotes whether [[Branch_Download#Automatic_Download|auto branch download]] should be allowed. By default this boolean field is set to 'false''. Can be set in the General Settings -> Enable auto branch download (UWP & Xamarin).
 +
|| 🟢
 +
|| 🟢
 +
|| 🟢
 +
|| 🟢
 
|-
 
|-
−
|''AuthenticationService'' || Denotes the path on the Authentication Server to the Authentication Service File, e.g. the path might be '''YourFolder/YourApp/USAM/USAM.svc'''. In this case the User System Authentication Manager (USAM) is used.
+
|''GeoDistanceSorting''  
 +
|| Denotes whether the Children of an Object should be displayed in a ranking of geographic distance to the Parent Object. By default this boolean field is set to ''true''. Can be set in the General Settings -> Order by geo distance (UWP) & AR Settings -> Order by geo distance (Xamarin).
 +
|| 🟢
 +
|| 🟢
 +
|| 🟢
 +
|| 🟢
 
|-
 
|-
−
|''AuthenticationServiceConfig'' || WSHttpBinding (the default value) or BasicHttpBinding. It should be set according to the [[Configuration_Files/Services.config|webservice configuration]].
+
|''NextLevelClassificationPreload''  
 +
|| When set to false, provides the possibility to override the effect of [[SYSCLS_PRELOAD_CHILDREN]], namely to prevent the preload. See the link for more details.
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
|''ConnectionTimeOut'' || Denotes the time in seconds when the Connection will be interrupted because of a Timeout. By default '''''300''''' is retrieving a Timeout after 5 minutes.
+
| ''PriorityThreshold''
 +
|| Any property with a priority number greater than this integer setting value is regarded as a high priority property and is highlighted when being displayed. Can be set in the General Settings -> Priority Treshold Properties (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
|''ContentPort'' || Denotes the Port used on the Content Server. Default values might be: 443; 777; 888; Often it is the same port as for the one for the Authentication Server.
+
| ''UpdateExpirySeconds''
 +
|| Determines how long (in seconds) freshly updated content becomes outdated and will be updated again when the user browses to it. Can be set in the General Settings -> Update Expiry (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
|''ContentProtocol'' || Denotes which Transfer Protocol for the Content might be used. By default '''https''' is used.
+
| ''PdfRenderer''
 +
|| The renderer used to display PDF documents in the app.{{Version/WinXSince|4.6}} Can be set in the General Settings -> PDF Renderer (UWP).
 +
|| 🟢
 +
|| 🟠
 +
|| 🟠
 +
|| 🟠
 
|-
 
|-
−
|''ContentServer'' || Denotes the Content Server, e.g. '''your.content-server.net''' could be used. Could be the same server as the Authentication Server.
+
|}
 +
 
 +
 
 +
 
 +
== Push==
 +
These internal push settings control the behaviors and activities of pushed data. For general information see [[Push Service (Client)|{{UBIK}} Push Service]].
 +
{| class="wikitable" | width = "100%"
 
|-
 
|-
−
|''ContentService'' || Denotes the path on the Content Server to the Content Service File, e.g. the path might be '''YourFolder/YourApp/CONTENT/UBIKContent.svc'''. Make sure that the path points to the '''UBIKContent.svc''' file.
+
! style="width:28%; text-align: left" | Name
 +
!! style="width:44%; text-align: left" | Purpose
 +
!! style="width:7%; text-align: center" | WinX
 +
!! style="width:7%; text-align: center" | Xamarin<br/>iOS
 +
!! style="width:7%; text-align: center" | Xamarin<br/>UWP
 +
!! style="width:7%; text-align: center" | Xamarin<br/>Android
 
|-
 
|-
−
| ''ContentServiceConfig''|| WSHttpBinding (the default value) or BasicHttpBinding. It should be set according to the [[Configuration_Files/Services.config|webservice configuration]].
+
|''ActivateNativePush''  
 +
|| This boolean field denotes whether the user should be informed about [[Native_Push_(Client)|native pushes]] configured for the current profile or not. By default it is set to ''true''. Can be set in the General Settings -> Activate native push (Xamarin.Android and Xamarin.iOS). {{Version/XamarinSince|4.8}} Note: The other push settings that don't contain the word "Native" do not affect the native push feature.
 +
|| 🟠
 +
|| 🟢
 +
|| 🟠
 +
|| 🟢
 
|-
 
|-
−
|''Context'' || Denotes the name of the Context, e.g. '''CXT_YourApp_001'''. This context is specified inside UBIK and all the different Metadefintions are loaded from it.
+
|''ActivatePush''  
 +
|| This boolean field denotes whether new resp. changed data should be pushed to other clients, which might be running the Application at the same time, or not. Can be set in the Push Settings -> Push active (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
|''SignalingServer'' || Denotes the Server for Remote Support.
+
|''PushPollingIntervalSeconds''  
 +
|| Denotes the interval in seconds for the client to retrieve newly pushed data from the server. Can be set in the Push Settings -> Push Polling Interval(UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
|''SyncMode'' || Denotes the Synchronization Mode of the Application. Possible Values are: Online, Offline, Auto; by default the SyncMode is set to '''Online'''.
+
|''PushPort''  
 +
|| Denotes the Port Number to use when connecting to the Push Server (optional), might be set to the same Port number as the Content Port Number. Can be set in the Push Settings (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 +
|-
 +
|''PushProtocol''
 +
|| Denotes which Transfer Protocol for the Push might be used. By default ''https'' is used. Can be set in the Push Settings -> Push Protocol (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 +
|-
 +
|''PushServer''
 +
|| Denotes the Push Server, e.g. ''your.push-server.net'' could be used. Could be the same server as the Content Server. Can be set in the Push Settings -> Push Server (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 +
|-
 +
|''PushService''
 +
|| Denotes the path on the Push Server to the Push Service File, e.g. the path might be ''YourFolder/YourApp/PUSH/UBIKPush.svc''. Make sure that the path points to the ''UBIKPush.svc'' file. Can be set in the Push Settings -> Push Service Path (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 +
|-
 +
|''ShowPushMessage''
 +
|| This boolean field denotes whether the User is informed about an occurring Push, or not. By default it is set to ''false''. Can be set in the Push Settings -> Notify on Push (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
 
|}
 
|}
Line 187: Line 471:
  
  
−
== Content ==
+
== Scan==
−
These internal content settings control the behaviors and activities of the content data.
+
These internal scan settings control the behaviors and activities of scanned data.  
−
{| class="wikitable" | width = "75%"
+
{| class="wikitable" | width = "100%"
 
|-
 
|-
−
! Name!! Purpose
+
! style="width:28%; text-align: left" | Name
 +
!! style="width:44%; text-align: left" | Purpose
 +
!! style="width:7%; text-align: center" | WinX
 +
!! style="width:7%; text-align: center" | Xamarin<br/>iOS
 +
!! style="width:7%; text-align: center" | Xamarin<br/>UWP
 +
!! style="width:7%; text-align: center" | Xamarin<br/>Android
 
|-
 
|-
−
|''AutoSaveMode'' || If this boolean field is set '''''true''''' changed Objects will be saved automatically.
+
|''CurrentBarcodeFormats''  
 +
|| Refers to a Microsoft definition for QR Codes, denoted in [http://schemas.microsoft.com/2003/10/Serialization/Arrays]. Can be set in the Camera Settings -> 2D Markers (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
|''ChildPageChildrenPortion'' || Denotes the Portion of the visible Content Page Area that is split between the Children of an Object and its Properties. Usually the value is between '''''0''''' and '''''100'''. By default it is normally set to '''''67''''', i.e. taking two thirds of the Content Page Area to display Children of a given Object.
+
|''CurrentOCRProfileIndex''  
 +
|| Specifies a certain OCR Profile. Yet, in the client in the camera settings you can also specify the OCR Profile.
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
|''ChildPagePropertyPortion'' || Denotes the Portion of the visible Content Page Area that is split between the Properties of an Object and its Children . Usually the value is between '''''0''''' and '''''100'''. By default it is normally set to '''''33''''', i. e. taking one third of the Content Page Area to display Properties of a given Object.
+
|''PostProcessRegex''
 +
|| If this field is set to ''true'', you can specify how a text based Code has to look like in the client settings. Can be set in the Camera Settings -> Post process Regex (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
|''DetailsPageChildrenPortion'' || Denotes the Portion of the visible Details Page Area that is split between the Children of an Object and its Properties. Usually the value is between '''''0''''' and '''''100'''. By default it is normally set to '''''67''''', i.e. taking two thirds of the Details Page Area to display Children of a given Object.
+
|''ScanARMarker''  
 +
|| This boolean field denotes whether an [[AR-Marker|ARMarker]] can be scanned and will be recognized.  
 +
(*) Can be set via related toggle buttons in Scan & POI View.
 +
|| 🟢*
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
|''DetailsPagePropertyPortion'' || Denotes the Portion of the visible Details Page Area that is split between the Properties of an Object and its Children . Usually the value is between '''''0''''' and '''''100'''. By default it is normally set to '''''33''''', i. e. taking one third of the Details Page Area to display Properties of a given Object.
+
|''ScanCodes''  
 +
|| This boolean field denotes whether 2D-Codes, e.g. Barcode, QRCode, etc. can be scanned and will be recognized.
 +
(*) Can be set via related toggle buttons in Scan & POI View.
 +
|| 🟢*
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
|''DocumentInternalMode'' || Denotes whether a Document is truly displayed only inside of the Application, then the boolean field should be set to '''''true'''''. If there should be a preview of the Document available inside the Application only and the Document is to be opened by an external Application, the boolean field should be set to '''''false'''''. By default the field is set to '''''false'''''.
+
|''ScanOCR''  
 +
|| This boolean field denotes whether an [[OCR|OCRMarker]] can be scanned and will be recognized.
 +
(*) Can be set via related toggle buttons in Scan & POI View.
 +
|| 🟢*
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
|''DocumentPageChildrenPortion'' || Denotes the Portion of the visible Document Page Area that is split between a Document lying beneath an Object and its Properties. Usually the value is between '''''0''''' and '''''100'''. By default it is normally set to '''''80''''', i.e. taking  80% of the Document Page Area to display a Document connected to a given Object.
+
|''UnlockByScanTimeOut''  
 +
|| This numeric field denotes whether a normally locked object can be unlocked for changes for a certain amount of time (in seconds).
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
|''DocumentPagePropertyPortion'' || Denotes the Portion of the visible Document Page Area that is split between the Properties of an Object and a Document belonging to it . Usually the value is between '''''0''''' and '''''100'''. By default it is normally set to '''''20''''', i. e. taking 20% of the Document Page Area to display Properties of a Document belonging to a given Object.
+
|''CodesTryInverted''  
 +
|| This boolean field denotes whether the client should try to scan color inverted 2D codes. The default value is "false". Can be set in the Camera Settings -> Try color inverted 2D codes (UWP) & AR Settings -> Try color inverted 2D codes (Xamarin).
 +
|| 🟢
 +
|| 🟢
 +
|| 🟢
 +
|| 🟢
 
|-
 
|-
−
|''DocumentPagePropertyWidth'' || Denotes the maximum width (in pixels) that Properties of a Document can take when a Document belonging to an Object is displayed. By default the value is '''''300 px'''''.  
+
|}
 +
 
 +
 
 +
 
 +
== Session==
 +
These internal session settings control the behaviors and activities of a session.  
 +
{| class="wikitable" | width = "100%"
 
|-
 
|-
−
|''EnableSyncLogging'' || Denotes whether a logging of different events, e.g. loading an object, changing a Property on an Object, etc. should take place. By default this boolean field is set to '''''true'''''.
+
! style="width:28%; text-align: left" | Name
 +
!! style="width:44%; text-align: left" | Purpose
 +
!! style="width:7%; text-align: center" | WinX
 +
!! style="width:7%; text-align: center" | Xamarin<br/>iOS
 +
!! style="width:7%; text-align: center" | Xamarin<br/>UWP
 +
!! style="width:7%; text-align: center" | Xamarin<br/>Android
 
|-
 
|-
−
|''GeoDistanceSorting'' || Denotes whether the Children of an Object should be displayed in a ranking of geographic distance to the Parent Object. By default this boolean field is set ti '''''true'''''.
+
|''AlternativeViewMode''  
 +
|| By default this boolean field is set to ''false''. If set ''true'', it denotes that there is more than one View mode available.
 +
|| ⚪
 +
|| ⚪
 +
|| ⚪
 +
|| ⚪
 
|-
 
|-
−
|''NextLevelClassificationPreload'' || '''To be filled out.'''
+
|''ZoomedInMode''  
 +
|| If this boolean flag is set true, the Children of an Object are shown as Tiles. Otherwise they are shown as List items.
 +
|| ⚪
 +
|| ⚪
 +
|| ⚪
 +
|| ⚪
 
|-
 
|-
−
| ''PriorityThreshold''|| Any property with a priority number greater than this integer setting value is regarded as a high priority property and is highlighted when being displayed
+
|}
 +
 
 +
 
 +
 
 +
== Augmented Reality ==
 +
 
 +
== Maps ==
 +
These settings control the behaviors of the [[Map View|map]] throughout the app.
 +
{| class="wikitable" | width = "100%"
 
|-
 
|-
−
| ''Update Expiry''|| Determines how long (in seconds) freshly updated content becomes outdated and will be updated again when the user browses to it.
+
! style="width:28%; text-align: left" | Name
 +
!! style="width:44%; text-align: left" | Purpose
 +
!! style="width:7%; text-align: center" | WinX
 +
!! style="width:7%; text-align: center" | Xamarin<br/>iOS
 +
!! style="width:7%; text-align: center" | Xamarin<br/>UWP
 +
!! style="width:7%; text-align: center" | Xamarin<br/>Android
 
|-
 
|-
−
| ''[[Content_Logging#Log_setting|Content Logging'']]|| Determines whether certain content related activities should be recorded as log files.
+
| ''MapType''
 +
|| Determines which [[Map_View_(Xamarin)#Base_Map|base map]] image will be used in the map. Can be set in the Maps Settings -> Map Type (UWP) & AR Settings -> Map Type (Xamarin).
 +
|| 🟢
 +
|| 🟢
 +
|| 🟢
 +
|| 🟢
 +
|-
 +
| ''DefaultZoomLevel''
 +
|| Controls how closely zoomed in the map should be whenever it is shown. Can be set in the Maps Settings -> Default Zoom Level (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
 
|}
 
|}
  
−
[[Category:Client|Settings]]
+
== Video ==
−
 
+
{| class="wikitable" | width = "100%"
−
== Push==
+
−
These internal push settings control the behaviors and activities of pushed data. For general information see [[Push Service (Client)|{{UBIK}} Push Service]].
+
−
{| class="wikitable" | width = "75%"
+
 
|-
 
|-
−
! Name!! Purpose
+
! style="width:28%; text-align: left" | Name
 +
!! style="width:44%; text-align: left" | Purpose
 +
!! style="width:7%; text-align: center" | WinX
 +
!! style="width:7%; text-align: center" | Xamarin<br/>iOS
 +
!! style="width:7%; text-align: center" | Xamarin<br/>UWP
 +
!! style="width:7%; text-align: center" | Xamarin<br/>Android
 
|-
 
|-
−
|''ActivatePush'' || This boolean field denotes whether new resp. changed data should be pushed to other clients, which might be running the Application at the same time, or not.  
+
| ''SelectedCameraId''
 +
|| Specifies which camera to use in the app. Can be set in the Camera Settings -> Device (UWP) & AR Settings -> Camera (Xamarin).
 +
|| 🟢
 +
|| 🟢
 +
|| 🟢
 +
|| 🟢
 
|-
 
|-
−
|''PushPollingIntervalSeconds'' || Denotes the interval in seconds for the client to retrieve newly pushed data from the server.
+
| ''SelectedCameraConfigurationIndex''
 +
|| Specifies which camera resolution to use in the app. Can be set in the Camera Settings -> Resolution (UWP) & AR Settings -> Camera resolution (Xamarin).
 +
|| 🟢
 +
|| 🟢
 +
|| 🟢
 +
|| 🟢
 
|-
 
|-
−
|''PushPort'' || Denotes the Port Number to use when connecting to the Push Server (optional), might be set to the same Port number as the Content Port Number.
+
| ''Zoom {{Version/XamarinSince|4.4}} (Android only, device dependent)''
 +
|| Controls how closely zoomed in the camera view should be whenever it is shown. The higher the number, the closer the view appears. Can be set in the AR Settings (Xamarin).
 +
|| 🟠
 +
|| 🟠
 +
|| 🟠
 +
|| 🟢
 
|-
 
|-
−
|''PushProtocol'' || Denotes which Transfer Protocol for the Push might be used. By default '''https''' is used.
+
|}
 +
{{Hint|
 +
* The camera preview window (UWP only) in the settings is hidden when the camera is currently in use in e.g. the POI view or the scan view. However, a user can still change the relevant settings and see immediate results.
 +
* Setting up a high Camera Resolution could affect the performance.}}
 +
 
 +
 
 +
 
 +
== Location ==
 +
{| class="wikitable" | width = "100%"
 
|-
 
|-
−
|''PushServer'' || Denotes the Push Server, e.g. '''your.push-server.net''' could be used. Could be the same server as the Content Server.
+
! style="width:28%; text-align: left" | Name
 +
!! style="width:44%; text-align: left" | Purpose
 +
!! style="width:7%; text-align: center" | WinX
 +
!! style="width:7%; text-align: center" | Xamarin<br/>iOS
 +
!! style="width:7%; text-align: center" | Xamarin<br/>UWP
 +
!! style="width:7%; text-align: center" | Xamarin<br/>Android
 
|-
 
|-
−
|''PushService'' || Denotes the path on the Push Server to the Push Service File, e.g. the path might be '''YourFolder/YourApp/PUSH/UBIKPush.svc'''. Make sure that the path points to the '''UBIKPush.svc''' file.
+
| ''CalibrationHeading''
 +
|| Specifies the heading that is used when manually calibrating the orientation sensor.
 +
Can be set in the Location Settings -> Heading Offset (UWP).
 +
|| 🟢
 +
|| 🟡
 +
|| 🟡
 +
|| 🟡
 
|-
 
|-
−
|''ShowPushMessage'' || This boolean field denotes whether the User is informed about an occurring Push, or not. By default it is set to '''''false'''''.
+
| ''LocationModeEnums''
 +
|| Specifies the Location Mode.
 +
Can be set in the Location Settings -> Location Mode (UWP) & AR Settings -> Positioning Mode (Xamarin).
 +
|| 🟢
 +
|| 🟢
 +
|| 🟢
 +
|| 🟢
 +
|-
 +
| ''UsePoseFusion''
 +
|| Specifies whether PoseFusion is used or not.
 +
Can be set in the Location Settings -> Enable PoseFusion (UWP) & AR Settings -> Use Pose Fusion (Xamarin).
 +
|| 🟢
 +
|| 🟢
 +
|| 🟢
 +
|| 🟢
 
|-
 
|-
 
|}
 
|}
Line 251: Line 679:
  
  
−
== Scan==
+
=Android=
−
These internal scan settings control the behaviors and activities of scanned data.  
+
 
 +
Settings list provides a list of all the settings that control the client environment, giving the user the possibility to display and configure these settings. The settings are ordered according to theme, the part of environment it's responsible for controlling. Within each theme the settings are sorted alphabetically. Mandatory settings are indicated with a {{key press|*}}  next to the name.
 +
 
 +
 
 +
== Available settings ==
 +
All users have at least access to all settings statet in [[#List of settings|List of settings]]. Additional settings, namely the [[#AR settings|AR settings]] or [[#Demo settings|Demo settings]] are only available if the regarding plugin is part of the application built. {{Tip/Version|Since version 2.5.0 the former system of global settings and user-specific settings has been replaced by user-specific settings only.}}
 +
 
 +
=== List of settings ===
 +
 
 +
The basic stock of settings includes:
 +
 
 
{| class="wikitable" | width = "75%"
 
{| class="wikitable" | width = "75%"
 
|-
 
|-
 
! Name!! Purpose
 
! Name!! Purpose
 
|-
 
|-
−
|''CurrentBarcodeFormats'' || Refers to a Microsoft definition for QR Codes, denoted in [http://schemas.microsoft.com/2003/10/Serialization/Arrays]
+
| ''AuthServerName''|| The name of the server to connect to for user authentication
 
|-
 
|-
−
|''CurrentOCRProfileIndex'' || Specifies a certain OCR Profile. Yet, in the client in the camera settings you can also specify the OCR Profile.
+
| ''AuthPortNumber''|| The port number to use when connecting to the authentication server (optional)
 
|-
 
|-
−
|''PostProcessRegex'' || If this field is set to ''true'', you can specify how a text based Code has to look like in the client settings.
+
| ''AuthProtocol''|| The protocol to use for authentication over the Internet (e.g.: HTTPS). {{Version/AndroidSince|2.4.2}}
 
|-
 
|-
−
|''ScanARMarker'' || This boolean field denotes whether an ARMarker can be scanned and will be recognized.
+
| ''UBIKAuthContentService''|| The name of the UBIK authentication service
 
|-
 
|-
−
|''ScanCodes'' || This boolean field denotes whether 2D-Codes, e.g. Barcode, QRCode, etc. can be scanned and will be recognized.
+
| ''MemoryUsage''|| Whether {{UBIK}} should [[Memory Usage (Android)|lazy load]] or [[Memory Usage (Android)|eager load]] all the content. {{Version/AndroidSince|2.4.0}}
 
|-
 
|-
−
|''ScanOCR'' || This boolean field denotes whether an OCRMarker can be scanned and will be recognized.
+
| ''Protocol''|| The protocol to use for data communication over the Internet (e.g.: HTTPS)
 
|-
 
|-
−
|''UnlockByScanTimeOut'' || This numeric field denotes whether a normally locked object can be unlocked for changes for a certain amount of time (in seconds).
+
| ''PortNumber''|| The port number to use when connecting to the content server (optional)
 
|-
 
|-
−
|}
+
| ''PriorityThreshold''|| Any property with a priority number greater than this integer setting value is regarded as a high priority property and is highlighted when being displayed
−
 
+
−
[[Category:Client|Settings]]
+
−
 
+
−
== Session==
+
−
These internal session settings control the behaviors and activities of a session.
+
−
{| class="wikitable" | width = "75%"
+
 
|-
 
|-
−
! Name!! Purpose
+
| ''UpdateExpirySeconds''|| The number of seconds one has to wait before the same update will be considered necessary. If an update of certain content has just ended successfully and is requested again within the amount of time configured in this setting, the client simply dismisses the new request. However, this setting does not affect [[Forced Updates in Manual Synchronization Mode]].
 
|-
 
|-
−
|''AlternativeViewMode'' || '''To be filled out.'''
+
| ''SyncMode''|| The possible values are '''Automatic''', '''Manual Commit''' and '''Offline'''. For more details, please refer to [[Sync Mode]].
 
|-
 
|-
−
|''ComboBoxSelectionIndex'' || '''To be filled out.'''
+
| ''ShowSystemProperties''|| If set to true, all properties will be displayed; otherwise, only the ones that are marked as [[METACLASSSCOPE#Visibility|visible]].
 
|-
 
|-
−
|''ZoomedInMode'' || '''To be filled out.'''
+
| ''UBIKContextName''|| The {{UBIK}} [[CONTEXT]] name
 +
|-
 +
| ''UBIKApplicationName''|| The {{UBIK}} [[APPLICATION]] name
 +
|-
 +
| ''UBIKContentService''|| The name of the {{UBIK}} content service
 +
|-
 +
| ''ServerName''|| The name of the server to connect to for fetching content
 +
|-
 +
| ''ExpectSingleSearchResult''|| If checked, single search results will be displayed in the ContentBrowser immediately instead of being shown in the result list. Available since {{Version/Android|2.5.0}}
 
|-
 
|-
 
|}
 
|}
  
  
 +
=== AR settings ===
 +
The AR plugin has additional settings:
  
−
== Final Settings ==
 
−
These final settings control the behaviors and activities of a profile.
 
 
{| class="wikitable" | width = "75%"
 
{| class="wikitable" | width = "75%"
 
|-
 
|-
 
! Name!! Purpose
 
! Name!! Purpose
 
|-
 
|-
−
|''IsFavorite'' || This boolean field denotes whether the Profile will be shown as a favourite on top of a list when there are also other Profiles in the Application client available.
+
| ''CompassOffsetDegrees'' || The offset in degrees to change the magnetic north and therefore the orientation of the device (global setting).
 
|-
 
|-
−
|''LastUsed'' || Contains a Timestamp when this profile was used the last time.  
+
| ''Pose Estimation Systems''|| The different  pose estimation systems considered in the [[Location Manager]] can be activated or deactivated with this setting.
 
|-
 
|-
−
|''MultiUserMode'' || This boolean  field denotes whether Multi User Mode is allowed in the Application or not. By default the value is set to '''''false''''', i. e. only one user can use the Application to check and also change values from the underlying Database.
+
| ''SpatialiteDbPath''|| The path to the sqlite database containing the routing graph. It will be looked for on the public internal storage (Google calls that the "Primary External Storage"), which is NOT the SD-card.
 
|-
 
|-
−
|''Name'' || This field denotes the name of the Profile. Note: If there is no special folder named in the '''''Customizing''''' field, then this name here will also be taken to retrieve the XAMLs from the according Folder with the same name.
+
| ''StandardMapZoomLevel''|| Specifies the zoom level, which should be applied when using the zoom features of the [[Map_View]].
 
|-
 
|-
−
|''Project'' || This field can name a special project. It might be common to have the carry the same name as the '''''Name''''' field. Carrying the value ''i:nil='''true''''' means that ...
+
| ''DefaultMapZoomLocation''|| Specifies the position, which should be zoomed to when opening the [[Map_View]] after login.
 
|-
 
|-
−
|''ShowHiddenSettings'' || By default this boolean field is set to '''''false''''', i.e. no hidden settings are shown.
+
| ''ContentDistanceFilterThreshold''|| The threshold in meters up to which billboards are displayed in Augmented Reality activities; also influences the scaling of billboards depending on their distance. {{Version/AndroidSince|2.5.4}}
 +
|-
 +
| ''NFC Scan Result Type''|| Specifies the type of information, which should be extracted from scanned [[RFID tags]]. {{Version/AndroidSince|3.0.0}}
 
|-
 
|-
 
|}
 
|}
Line 313: Line 755:
  
  
−
== Augmented Reality ==
+
=== Demo settings ===
 +
 
 +
Additionally, the demo application and its unique user specific settings are listed as follows
  
−
== Maps ==
 
−
These settings control the behaviors of the [[Map View|map]] throughout the app.
 
 
{| class="wikitable" | width = "75%"
 
{| class="wikitable" | width = "75%"
 
|-
 
|-
 
! Name!! Purpose
 
! Name!! Purpose
 
|-
 
|-
−
| ''Map Type''|| Determines which base map image will be used in the map.
+
| ''NumberPropertyEditor''|| Whether to use the normal keyboard or the [[UBIK Number Pickers]] for editing numeric properties
 
|-
 
|-
−
| ''Default Zoom Level''|| Controls how closely zoomed in the map should be whenever it is shown.
+
| ''CurrentAltitude''|| The (mock) altitude in meters to use in Augmented Reality activities, for non-manual locations (e.g. GPS, since the altutide for this is too inaccurate)
 
|-
 
|-
−
|}
+
| ''AltitudeOffset''|| The offset in meters to add to the current altitude in Augmented Reality activities (used for configuration of the device height)
−
 
+
−
== Video ==
+
−
{| class="wikitable" | width = "75%"
+
 
|-
 
|-
−
! Name!! Purpose
+
| ''ContentDistanceFilterThreshold''|| The threshold in meters up to which billboards are displayed in Augmented Reality activities
 
|-
 
|-
−
| ''Camera Device''|| Specifies which camera to use in the app.
+
| ''SupportIntentTarget''|| The actual Uri / Activity class / app package to be opened as an Android intent when the support action is triggered. {{Version/AndroidSince|2.5.2}}
 
|-
 
|-
−
| ''Camera Resolution''|| Specifies which camera resolution to use in the app.
+
| ''SupportIntentType''|| The type of the target (URI/APP_PACKAGE/ACTIVITY_CLASS) to be opened as an Android intent when the support action is triggered. {{Version/AndroidSince|2.5.2}}
 
|-
 
|-
 
|}
 
|}
−
{{Hint|The camera preview window in the settings is hidden when the camera is currently in use in e.g. the POI view or the scan view. However, a user can still change the relevant settings and see the immediate results.}}
 
  
−
== Location ==
+
 
−
{| class="wikitable" | width = "75%"
+
 
−
|-
+
== Characteristics of settings ==
−
! Name!! Purpose
+
 
−
|-
+
Settings have the following characteristics and behavior within the application:
−
| ''Calibration Heading''|| Specifies the heading that is used when manually calibrating the orientation sensor.
+
* Available and editable before and after the login.
−
|-
+
* Changes done before login are applied to the next user who attempts to login.
−
|}
+
** This goes for applying presets as well.
 +
** After applying a preset, changes of settings are also applied.
 +
** The settings defined are not just used by the user as new settings configuration, but are merged with the settings the user already has, and are overriding them.
 +
* Changes after login are saved for the user currently logged in. After logout and new login, they are restored, merged with the settings changed before login if there are some and finally they get applied to the user.
 +
* If a completely new user attempts to login without defining settings before or loading a preset, the default values of the settings as defined for the respective app are used.
 +
 
 +
 
 +
 
 +
== PreSet actions ==
 +
 
 +
=== Load PreSets ===
 +
 
 +
The {{key press|Load PreSet}} button can be used to [[HowTo:Load Presets]] onto the settings.
 +
 
 +
=== Save PreSets ===
 +
 
 +
The {{key press|Save PreSet}} button that is only available after login, can be used to [[HowTo:Save Settings as Presets]].
 +
 
  
 
<headertabs/>
 
<headertabs/>
  
 
[[Category:Client|Settings]]
 
[[Category:Client|Settings]]

Latest revision as of 10:24, 29 October 2024

[edit]

UWP/WinX/Xamarin

There are several categories of settings, each providing a group of configurable options for (a) specific feature(s).

Table Legend
Symbol Meaning
🟢 Supported and accessible in the UI
🟡 Supported and accessible through Profile xml
🟠 Not supported
⚪ Obsolete











General

This initial section in the Profile description contains some general settings.

Name Purpose WinX Xamarin
iOS 		Xamarin
UWP 		Xamarin
Android
AutoBranchSync Denotes whether the automatic branch download below an object will be synchronized automatically or not. It is set to "false" by default. This is now obsolete, see General Settings -> EnableAutoBranchDownload instead.

(*) Refers to EnableAutoBranchDownload. The Auto Branch Download can be set in the General Settings (UWP & Xamarin).

🟢* 🟢* 🟢* 🟢*
AutoBranchSyncPeriod Denotes the period for automatic branch synchronization in minutes. Its value is set to "0" by default, when the AutoBranchSync is set to false. Otherwise it should take an other figure. This is now obsolete, see General Settings -> EnableAutoBranchDownload instead.

(*) Refers to EnableAutoBranchDownload. The Auto Branch Download can be set in the General Settings (UWP & Xamarin).

🟢* 🟢* 🟢* 🟢*
AutoLogoutTime Configures the number of minutes of user inactivity before the app automatically logs out. Its value is set to "0" by default, which means the app will never actively log out automatically. 🟡 🟡 🟡 🟡
BranchDownloadSubLevels Determines how a branch download is performed. If not configured (equals to 0 by default), an entire branch is downloaded in one attempt. If set to 1 for example, the 1st level children of the selected root is first analyzed, then sub branch downloads are performed for each of the children. Basically the higher the number, the more "fragmented" the branch download becomes. This usually increases the overall download time, but can be helpful for scenarios like really large branches or unstable networks since it has a better chance of finishing smaller individual downloads. 🟡 🟡 🟡 🟡
Customizing Denote your specific folder for XAMLs that depict how the Content is displayed, here. If, by default, the value is set to i:nil=true, then the specific XAML folder is denoted by the name of the Profile at the bottom of the Profile Description. 🟡 🟡 🟡 🟡
UICompatibilityLevel Determines which UI versions the client app should try to be compatible with. In major version updates, UI redesigns can happen and sometimes old UI components might even be completely removed. For example, the app bars are removed since (level 400) because their features are embedded into other parts of the new UI. For those who want to stick with the previous UI for a while, this setting just needs to set to a level earlier, e.g. 380. 🟡 🟡 🟡 🟡
ExpertMode This boolean field denotes whether the Metadefinitions are updated whenever the Profile of the App is loaded anew or not. By default the value is set to false, i.e. the Metadefinitions are only updated when the Application is initialized the first time, or when all data has been purged. 🟡 🟡 🟡 🟡
ShowUnreleasedFeatures This boolean field denotes whether some unofficially released features/options should be enabled/shown. For example, the developer settings in the Xamarin app is hidden by default and only shown when this value is set to true. 🟡 🟡 🟡 🟡
SendCrashReports Determines whether the device sends crash reports to the App Center or not. Please note that the diagnostic data is still saved locally and that all users on the device share the same switch. This means if one user enables crash reports, all users on this device will also send crash reports.

Can be set in the General Settings -> Send crash reports (UWP & Xamarin).

🟢 🟢 🟢 🟢
IsFavorite This boolean field denotes whether the Profile will be shown as a favourite on top of a list when there are also other Profiles in the Application client available. 🟢 🟡 🟡 🟡
LastUsed Contains a Timestamp when this profile was used the last time. 🟡 🟡 🟡 🟡
Name This field denotes the name of the Profile. It also determines the name of the subfolder containing XAML customizing files, if the value of the Customizing field is set to i:nil=true, as well as the name of the subfolder containing database files, if the value of the Project field is set to i:nil=true. Can be set in the General Settings (UWP). 🟢 🟡 🟡 🟡
Customizing This field determines the name of the subfolder containing XAML customizing files. It might be common to have to carry the same name as the Name field. If it is unspecified (i:nil=true), the value of Name will be used as subfolder name. 🟡 🟡 🟡 🟡
Project This field can name a special project. It determines the name of the subfolder containing database files. It might be common to have to carry the same name as the Name field. If it is unspecified (i:nil=true), the value of Name will be used as subfolder name. Can be set in the General Settings (UWP). 🟢 🟡 🟡 🟡
IC Attention.pngThe UICompatibilityLevel setting tells the client app to be compatible to the specified versions of the UI if possible. This doesn't mean all existing UI customizings are still supported in newer versions of the app. In fact, any feature where this setting has an effect will explicitly mention it. Otherwise, you should always check the "XAML Notes" tab of each version's release note page.


Connection

This section contains properties to denote the internal connection settings of the App.

Name Purpose WinX Xamarin
iOS 		Xamarin
UWP 		Xamarin
Android
Application Denotes the name of the Application that will be run, e.g. one could use YourApp as the name for an Application. Can be set in the Connection Settings (UWP). 🟢 🟡 🟡 🟡
AuthenticationPort Denotes the Port used on the Authentication Server. Default values might be: 443; 777; 888; Can be set in the Connection Settings (UWP). 🟢 🟡 🟡 🟡
AuthenticationProtocol Denotes which Transfer Protocol for Authentication might be used. By default https is used. Can be set in the Connection Settings (UWP). 🟢 🟡 🟡 🟡
AuthenticationServer Denotes the Authentication Server, e.g. your.auth-server.net could be used. Can be set in the Connection Settings (UWP). 🟢 🟡 🟡 🟡
AuthenticationService Denotes the path on the Authentication Server to the Authentication Service File, e.g. the path might be YourFolder/YourApp/USAM/USAM.svc. In this case the User System Authentication Manager (USAM) is used. Can be set in the Connection Settings (UWP). 🟢 🟡 🟡 🟡
AuthenticationServiceConfig WSHttpBinding (the default value) or BasicHttpBinding. It should be set according to the webservice configuration. Can be set in the Connection Settings -> Content Service Config (UWP). 🟢 🟡 🟡 🟡
ConnectionTimeOut Denotes the time in seconds when a web service call is dropped by the app. It's necessary so that the app doesn't wait indefinitely in events such as connection lost. The default value is 300 seconds. If you know your individual web service calls will take longer, the value should be increased accordingly. Can be set in the Connection Settings -> Time-Out of data connection (UWP). 🟢 🟡 🟡 🟡
ContentPort Denotes the Port used on the Content Server. Default values might be: 443; 777; 888; Often it is the same port as for the one for the Authentication Server. 🟢 🟡 🟡 🟡
ContentProtocol Denotes which Transfer Protocol for the Content might be used. By default https is used. Can be set in the Connection Settings (UWP). 🟢 🟡 🟡 🟡
ContentServer Denotes the Content Server, e.g. your.content-server.net could be used. Could be the same server as the Authentication Server. Can be set in the Connection Settings (UWP). 🟢 🟡 🟡 🟡
ContentService Denotes the path on the Content Server to the Content Service File, e.g. the path might be YourFolder/YourApp/CONTENT/UBIKContent.svc. Make sure that the path points to the UBIKContent.svc file. Can be set in the Connection Settings (UWP). 🟢 🟡 🟡 🟡
ContentServiceConfig WSHttpBinding (the default value) or BasicHttpBinding. It should be set according to the webservice configuration. Can be set in the Connection Settings (UWP). 🟢 🟡 🟡 🟡
Context Denotes the name of the Context, e.g. CXT_YourApp_001. This context is specified inside UBIK and all the different Metadefintions are loaded from it. Can be set in the Connection Settings (UWP). 🟢 🟡 🟡 🟡
SignalingServer Denotes the Server for Remote Support. 🟡 🟠 🟠 🟠
SyncMode Denotes the Synchronization Mode of the Application. Possible Values are: Manual(Online), Offline, Auto; by default the SyncMode is set to Manual. For Version 4.2 and up, the selected Sync Mode gets saved into the current Profile. 🟢 🟢 🟢 🟢


Content

These internal content settings control the behaviors and activities of the content data.

Name Purpose WinX Xamarin
iOS 		Xamarin
UWP 		Xamarin
Android
AutoSaveMode If this boolean field is set true changed Objects will be saved automatically when users leave the relevant pages. Otherwise, the User will see a save button and be asked to save the changes when leaving the relevant pages. Can be set in the General Settings -> Enable auto save mode (UWP).

(*) Supported but not configurable on Xamarin.

🟢 🟡* 🟡* 🟡*
ChildPageChildrenPortion Denotes the Portion of the visible Content Page Area that is split between the Children of an Object and its Properties. Usually the value is between 0 and 100. By default it is normally set to 67, i.e. taking two thirds of the Content Page Area to display Children of a given Object. ⚪ ⚪ ⚪ ⚪
ChildPagePropertyPortion Denotes the Portion of the visible Content Page Area that is split between the Properties of an Object and its Children . Usually the value is between 0 and 100. By default it is normally set to 33, i. e. taking one third of the Content Page Area to display Properties of a given Object. ⚪ ⚪ ⚪ ⚪
DetailsPageChildrenPortion Denotes the Portion of the visible Details Page Area that is split between the Children of an Object and its Properties. Usually the value is between 0 and 100. By default it is normally set to 67, i.e. taking two thirds of the Details Page Area to display Children of a given Object. ⚪ ⚪ ⚪ ⚪
DetailsPagePropertyPortion Denotes the Portion of the visible Details Page Area that is split between the Properties of an Object and its Children . Usually the value is between 0 and 100. By default it is normally set to 33, i. e. taking one third of the Details Page Area to display Properties of a given Object. ⚪ ⚪ ⚪ ⚪
DocumentInternalMode Denotes whether a Document is truly displayed only inside of the Application, then the boolean field should be set to true. If there should be a preview of the Document available inside the Application only and the Document is to be opened by an external Application, the boolean field should be set to false. By default the field is set to false. ⚪ 🟠 🟠 🟠
DocumentPageChildrenPortion Denotes the Portion of the visible Document Page Area that is split between a Document lying beneath an Object and its Properties. Usually the value is between 0 and 100. By default it is normally set to 80, i.e. taking 80% of the Document Page Area to display a Document connected to a given Object. ⚪ ⚪ ⚪ ⚪
DocumentPagePropertyPortion Denotes the Portion of the visible Document Page Area that is split between the Properties of an Object and a Document belonging to it . Usually the value is between 0 and 100. By default it is normally set to 20, i. e. taking 20% of the Document Page Area to display Properties of a Document belonging to a given Object. ⚪ ⚪ ⚪ ⚪
DocumentPagePropertyWidth Denotes the maximum width (in pixels) that Properties of a Document can take when a Document belonging to an Object is displayed. By default the value is 300 px. 🟡 🟡 🟡 🟡
EnableSyncLogging Determines whether certain content-related activities should be recorded as log files. Denotes whether a logging of different events, e.g. loading an object, changing a Property on an Object, etc. should take place. By default, this boolean field is set to true. Can be set in the General Settings -> Content logging (UWP). 🟢 🟡 🟡 🟡
EnableAutoBranchDownload Denotes whether auto branch download should be allowed. By default this boolean field is set to 'false. Can be set in the General Settings -> Enable auto branch download (UWP & Xamarin). 🟢 🟢 🟢 🟢
GeoDistanceSorting Denotes whether the Children of an Object should be displayed in a ranking of geographic distance to the Parent Object. By default this boolean field is set to true. Can be set in the General Settings -> Order by geo distance (UWP) & AR Settings -> Order by geo distance (Xamarin). 🟢 🟢 🟢 🟢
NextLevelClassificationPreload When set to false, provides the possibility to override the effect of SYSCLS PRELOAD CHILDREN, namely to prevent the preload. See the link for more details. 🟡 🟡 🟡 🟡
PriorityThreshold Any property with a priority number greater than this integer setting value is regarded as a high priority property and is highlighted when being displayed. Can be set in the General Settings -> Priority Treshold Properties (UWP). 🟢 🟡 🟡 🟡
UpdateExpirySeconds Determines how long (in seconds) freshly updated content becomes outdated and will be updated again when the user browses to it. Can be set in the General Settings -> Update Expiry (UWP). 🟢 🟡 🟡 🟡
PdfRenderer The renderer used to display PDF documents in the app. Can be set in the General Settings -> PDF Renderer (UWP). 🟢 🟠 🟠 🟠


Push

These internal push settings control the behaviors and activities of pushed data. For general information see UBIK® Push Service.

Name Purpose WinX Xamarin
iOS 		Xamarin
UWP 		Xamarin
Android
ActivateNativePush This boolean field denotes whether the user should be informed about native pushes configured for the current profile or not. By default it is set to true. Can be set in the General Settings -> Activate native push (Xamarin.Android and Xamarin.iOS). Note: The other push settings that don't contain the word "Native" do not affect the native push feature. 🟠 🟢 🟠 🟢
ActivatePush This boolean field denotes whether new resp. changed data should be pushed to other clients, which might be running the Application at the same time, or not. Can be set in the Push Settings -> Push active (UWP). 🟢 🟡 🟡 🟡
PushPollingIntervalSeconds Denotes the interval in seconds for the client to retrieve newly pushed data from the server. Can be set in the Push Settings -> Push Polling Interval(UWP). 🟢 🟡 🟡 🟡
PushPort Denotes the Port Number to use when connecting to the Push Server (optional), might be set to the same Port number as the Content Port Number. Can be set in the Push Settings (UWP). 🟢 🟡 🟡 🟡
PushProtocol Denotes which Transfer Protocol for the Push might be used. By default https is used. Can be set in the Push Settings -> Push Protocol (UWP). 🟢 🟡 🟡 🟡
PushServer Denotes the Push Server, e.g. your.push-server.net could be used. Could be the same server as the Content Server. Can be set in the Push Settings -> Push Server (UWP). 🟢 🟡 🟡 🟡
PushService Denotes the path on the Push Server to the Push Service File, e.g. the path might be YourFolder/YourApp/PUSH/UBIKPush.svc. Make sure that the path points to the UBIKPush.svc file. Can be set in the Push Settings -> Push Service Path (UWP). 🟢 🟡 🟡 🟡
ShowPushMessage This boolean field denotes whether the User is informed about an occurring Push, or not. By default it is set to false. Can be set in the Push Settings -> Notify on Push (UWP). 🟢 🟡 🟡 🟡


Scan

These internal scan settings control the behaviors and activities of scanned data.

Name Purpose WinX Xamarin
iOS 		Xamarin
UWP 		Xamarin
Android
CurrentBarcodeFormats Refers to a Microsoft definition for QR Codes, denoted in [1]. Can be set in the Camera Settings -> 2D Markers (UWP). 🟢 🟡 🟡 🟡
CurrentOCRProfileIndex Specifies a certain OCR Profile. Yet, in the client in the camera settings you can also specify the OCR Profile. 🟢 🟡 🟡 🟡
PostProcessRegex If this field is set to true, you can specify how a text based Code has to look like in the client settings. Can be set in the Camera Settings -> Post process Regex (UWP). 🟢 🟡 🟡 🟡
ScanARMarker This boolean field denotes whether an ARMarker can be scanned and will be recognized.

(*) Can be set via related toggle buttons in Scan & POI View.

🟢* 🟡 🟡 🟡
ScanCodes This boolean field denotes whether 2D-Codes, e.g. Barcode, QRCode, etc. can be scanned and will be recognized.

(*) Can be set via related toggle buttons in Scan & POI View.

🟢* 🟡 🟡 🟡
ScanOCR This boolean field denotes whether an OCRMarker can be scanned and will be recognized.

(*) Can be set via related toggle buttons in Scan & POI View.

🟢* 🟡 🟡 🟡
UnlockByScanTimeOut This numeric field denotes whether a normally locked object can be unlocked for changes for a certain amount of time (in seconds). 🟡 🟡 🟡 🟡
CodesTryInverted This boolean field denotes whether the client should try to scan color inverted 2D codes. The default value is "false". Can be set in the Camera Settings -> Try color inverted 2D codes (UWP) & AR Settings -> Try color inverted 2D codes (Xamarin). 🟢 🟢 🟢 🟢


Session

These internal session settings control the behaviors and activities of a session.

Name Purpose WinX Xamarin
iOS 		Xamarin
UWP 		Xamarin
Android
AlternativeViewMode By default this boolean field is set to false. If set true, it denotes that there is more than one View mode available. ⚪ ⚪ ⚪ ⚪
ZoomedInMode If this boolean flag is set true, the Children of an Object are shown as Tiles. Otherwise they are shown as List items. ⚪ ⚪ ⚪ ⚪


Augmented Reality

Maps

These settings control the behaviors of the map throughout the app.

Name Purpose WinX Xamarin
iOS 		Xamarin
UWP 		Xamarin
Android
MapType Determines which base map image will be used in the map. Can be set in the Maps Settings -> Map Type (UWP) & AR Settings -> Map Type (Xamarin). 🟢 🟢 🟢 🟢
DefaultZoomLevel Controls how closely zoomed in the map should be whenever it is shown. Can be set in the Maps Settings -> Default Zoom Level (UWP). 🟢 🟡 🟡 🟡

Video

Name Purpose WinX Xamarin
iOS 		Xamarin
UWP 		Xamarin
Android
SelectedCameraId Specifies which camera to use in the app. Can be set in the Camera Settings -> Device (UWP) & AR Settings -> Camera (Xamarin). 🟢 🟢 🟢 🟢
SelectedCameraConfigurationIndex Specifies which camera resolution to use in the app. Can be set in the Camera Settings -> Resolution (UWP) & AR Settings -> Camera resolution (Xamarin). 🟢 🟢 🟢 🟢
Zoom (Android only, device dependent) Controls how closely zoomed in the camera view should be whenever it is shown. The higher the number, the closer the view appears. Can be set in the AR Settings (Xamarin). 🟠 🟠 🟠 🟢
IC Hint square.png
  • The camera preview window (UWP only) in the settings is hidden when the camera is currently in use in e.g. the POI view or the scan view. However, a user can still change the relevant settings and see immediate results.
  • Setting up a high Camera Resolution could affect the performance.


Location

Name Purpose WinX Xamarin
iOS 		Xamarin
UWP 		Xamarin
Android
CalibrationHeading Specifies the heading that is used when manually calibrating the orientation sensor.

Can be set in the Location Settings -> Heading Offset (UWP).

🟢 🟡 🟡 🟡
LocationModeEnums Specifies the Location Mode.

Can be set in the Location Settings -> Location Mode (UWP) & AR Settings -> Positioning Mode (Xamarin).

🟢 🟢 🟢 🟢
UsePoseFusion Specifies whether PoseFusion is used or not.

Can be set in the Location Settings -> Enable PoseFusion (UWP) & AR Settings -> Use Pose Fusion (Xamarin).

🟢 🟢 🟢 🟢


Android

Settings list provides a list of all the settings that control the client environment, giving the user the possibility to display and configure these settings. The settings are ordered according to theme, the part of environment it's responsible for controlling. Within each theme the settings are sorted alphabetically. Mandatory settings are indicated with a * next to the name.


Available settings

All users have at least access to all settings statet in List of settings. Additional settings, namely the AR settings or Demo settings are only available if the regarding plugin is part of the application built.

List of settings

The basic stock of settings includes:

Name Purpose
AuthServerName The name of the server to connect to for user authentication
AuthPortNumber The port number to use when connecting to the authentication server (optional)
AuthProtocol The protocol to use for authentication over the Internet (e.g.: HTTPS).
UBIKAuthContentService The name of the UBIK authentication service
MemoryUsage Whether UBIK® should lazy load or eager load all the content.
Protocol The protocol to use for data communication over the Internet (e.g.: HTTPS)
PortNumber The port number to use when connecting to the content server (optional)
PriorityThreshold Any property with a priority number greater than this integer setting value is regarded as a high priority property and is highlighted when being displayed
UpdateExpirySeconds The number of seconds one has to wait before the same update will be considered necessary. If an update of certain content has just ended successfully and is requested again within the amount of time configured in this setting, the client simply dismisses the new request. However, this setting does not affect Forced Updates in Manual Synchronization Mode.
SyncMode The possible values are Automatic, Manual Commit and Offline. For more details, please refer to Sync Mode.
ShowSystemProperties If set to true, all properties will be displayed; otherwise, only the ones that are marked as visible.
UBIKContextName The UBIK® CONTEXT name
UBIKApplicationName The UBIK® APPLICATION name
UBIKContentService The name of the UBIK® content service
ServerName The name of the server to connect to for fetching content
ExpectSingleSearchResult If checked, single search results will be displayed in the ContentBrowser immediately instead of being shown in the result list. Available since Version 2.5.0 - Android


AR settings

The AR plugin has additional settings:

Name Purpose
CompassOffsetDegrees The offset in degrees to change the magnetic north and therefore the orientation of the device (global setting).
Pose Estimation Systems The different pose estimation systems considered in the Location Manager can be activated or deactivated with this setting.
SpatialiteDbPath The path to the sqlite database containing the routing graph. It will be looked for on the public internal storage (Google calls that the "Primary External Storage"), which is NOT the SD-card.
StandardMapZoomLevel Specifies the zoom level, which should be applied when using the zoom features of the Map View.
DefaultMapZoomLocation Specifies the position, which should be zoomed to when opening the Map View after login.
ContentDistanceFilterThreshold The threshold in meters up to which billboards are displayed in Augmented Reality activities; also influences the scaling of billboards depending on their distance.
NFC Scan Result Type Specifies the type of information, which should be extracted from scanned RFID tags.


Demo settings

Additionally, the demo application and its unique user specific settings are listed as follows

Name Purpose
NumberPropertyEditor Whether to use the normal keyboard or the UBIK Number Pickers for editing numeric properties
CurrentAltitude The (mock) altitude in meters to use in Augmented Reality activities, for non-manual locations (e.g. GPS, since the altutide for this is too inaccurate)
AltitudeOffset The offset in meters to add to the current altitude in Augmented Reality activities (used for configuration of the device height)
ContentDistanceFilterThreshold The threshold in meters up to which billboards are displayed in Augmented Reality activities
SupportIntentTarget The actual Uri / Activity class / app package to be opened as an Android intent when the support action is triggered.
SupportIntentType The type of the target (URI/APP_PACKAGE/ACTIVITY_CLASS) to be opened as an Android intent when the support action is triggered.


Characteristics of settings

Settings have the following characteristics and behavior within the application:

  • Available and editable before and after the login.
  • Changes done before login are applied to the next user who attempts to login.
    • This goes for applying presets as well.
    • After applying a preset, changes of settings are also applied.
    • The settings defined are not just used by the user as new settings configuration, but are merged with the settings the user already has, and are overriding them.
  • Changes after login are saved for the user currently logged in. After logout and new login, they are restored, merged with the settings changed before login if there are some and finally they get applied to the user.
  • If a completely new user attempts to login without defining settings before or loading a preset, the default values of the settings as defined for the respective app are used.


PreSet actions

Load PreSets

The Load PreSet button can be used to Load Presets onto the settings.

Save PreSets

The Save PreSet button that is only available after login, can be used to Save Settings as Presets.


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