=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 {{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%"
|-
! 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). {{Version/AndroidSince|2.4.2}}
|-
| ''UBIKAuthContentService''|| The name of the UBIK authentication service
|-
| ''MemoryUsage''|| Whether {{UBIK}} should [[Memory Usage (Android)|lazy load]] or [[Memory Usage (Android)|eager load]] all the content. {{Version/AndroidSince|2.4.0}}
|-
| ''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 [[METACLASSSCOPE#Visibility|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/Android|2.5.0}}
|-
|}

=== AR settings ===
The AR plugin has additional settings:

{| class="wikitable" | width = "75%"
|-
! 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. {{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}}
|-
|}

=== Demo settings ===

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

{| class="wikitable" | width = "75%"
|-
! 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. {{Version/AndroidSince|2.5.2}}
|-
| ''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}}
|-
|}

== 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 {{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
|-
| ''AutoBranchSync''|| Denotes whether the branch below an object will be synchronized automatically or not. It is set to "false" by default.
|-
| ''AutoBranchSyncPeriod''|| Denotes the period for automatic synchronization in seconds. Its value is set to "0" by default, when the ''AutoBranchSync'' is set to false. Otherwise it should take an other figure.
|-
| ''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.
|-
| ''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.
|-
| ''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.
|-
|}

== Connection ==
This section contains properties to denote the internal connection settings of the App.
{| class="wikitable" | width = "75%"
|-
! Name!! Purpose
|-
|''Application'' || Denotes the name of the Application that will be run, e.g. one could use '''YourApp''' as the name for an Application.
|-
|''AuthenticationPort'' || Denotes the Port used on the Authentication Server. Default values might be: '''''443; 777; 888;'''''
|-
|''AuthenticationProtocol'' || Denotes which Transfer Protocol for Authentication might be used. By default '''https''' is used.
|-
|''AuthenticationServer'' || Denotes the Authentication Server, e.g. '''your.auth-server.net''' could be used.
|-
|''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.
|-
|''AuthenticationServiceConfig'' || WSHttpBinding (the default value) or BasicHttpBinding. It should be set according to the [[Configuration_Files/Services.config|webservice configuration]].
|-
|''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.
|-
|''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.
|-
|''ContentServer'' || Denotes the Content Server, e.g. '''your.content-server.net''' could be used. Could be the same server as the Authentication Server.
|-
|''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.
|-
| ''ContentServiceConfig''|| WSHttpBinding (the default value) or BasicHttpBinding. It should be set according to the [[Configuration_Files/Services.config|webservice configuration]].
|-
|''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.
|-
|''SignalingServer'' || Denotes the Server for Remote Support.
|-
|''SyncMode'' || Denotes the Synchronization Mode of the Application. Possible Values are: Online, Offline, Auto; by default the SyncMode is set to '''Online'''.
|-
|}

== Content ==
These internal content settings control the behaviors and activities of the content data.
{| class="wikitable" | width = "75%"
|-
! Name!! Purpose
|-
|''AutoSaveMode'' || '''To be filled out.'''
|-
|''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'' || '''To be filled out.'''
|-
|''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'' || '''To be filled out.'''
|-
|''GeoDistanceSorting'' || '''To be filled out.'''
|-
|''NextLevelClassificationPreload'' || '''To be filled out.'''
|-
| ''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
|-
| ''Update Expiry''|| Determines how long (in seconds) freshly updated content becomes outdated and will be updated again when the user browses to it.
|-
| ''[[Content_Logging#Log_setting|Content Logging'']]|| Determines whether certain content related activities should be recorded as log files.
|-
|}

== 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
|-
|''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.
|-
|''PushPollingIntervalSeconds'' || Denotes the interval in seconds for the client to retrieve newly pushed data from the server.
|-
|''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.
|-
|''PushProtocol'' || Denotes which Transfer Protocol for the Push might be used. By default '''https''' is used.
|-
|''PushServer'' || Denotes the Push Server, e.g. '''your.push-server.net''' could be used. Could be the same server as the Content Server.
|-
|''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.
|-
|''ShowPushMessage'' || This boolean field denotes whether the User is informed about an occurring Push, or not. By default it is set to '''''false'''''.
|-
|}

== Scan==
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
|-
|
|-
|}

== Augmented Reality ==

== Maps ==
These settings control the behaviors of the [[Map View|map]] throughout the app.
{| class="wikitable" | width = "75%"
|-
! Name!! Purpose
|-
| ''Map Type''|| Determines which base map image will be used in the map.
|-
| ''Default Zoom Level''|| Controls how closely zoomed in the map should be whenever it is shown.
|-
|}

== Video ==
{| class="wikitable" | width = "75%"
|-
! Name!! Purpose
|-
| ''Camera Device''|| Specifies which camera to use in the app.
|-
| ''Camera Resolution''|| Specifies which camera resolution to use in the app.
|-
|}
{{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%"
|-
! Name!! Purpose
|-
| ''Calibration Heading''|| Specifies the heading that is used when manually calibrating the orientation sensor.
|-
|}

<headertabs/>

[[Category:Client|Settings]]

Settings

2019-09-30T12:50:21Z

2019-09-30T11:18:30Z

CMO: /* Connection */

Settings

2019-09-30T10:01:50Z

CMO: