DiscoverBasicConfig
Kill switch
A kill switch is a mechanism to disable the Connect library remotely on end users devices. To enable the kill switch setting, you must provide the URL for the application. The kill switch settings verify if the URL is reachable or not.
| Settings ID | Value | Description |
|---|---|---|
| KillSwitchEnabled | true/false | Set the value to true to check the kill switch target page before starting. If you set the value to false, the framework starts immediately. |
| KillSwitchUrl | URL | Provide the URL to check for the kill switch. When the kill switch is enabled, the framework checks the URL you provide here. It requires a successful response from the check to initialize. |
| KillSwitchMaxNumberOfTries | Integer | Set the number of times the framework should check for the kill switch URL before giving up. This value should be set to at least 1. |
| KillSwitchTimeInterval | Seconds | Set the time the framework should wait before rechecking the kill switch URL if it is not responding. |
| UseWhiteList | yes/no | Set to yes if you want the framework to check the whitelist of phone IDs when kill switch is enabled. When set to yes, the framework requires a phone ID to assign. When set to no, the framework defaults to use random sampling. |
| WhiteListParam | Current whitelist server-ID | Provide the whitelist ID that corresponds to the phone ID assigned. |
| KillSwitchTimeout | Seconds | Set the timeout value for the HTTP request that checks for the kill switch. |
Post settings
The post settings help manage the data posted from the framework to the server. Configure the post settings in the DCXCoreBasicConfig and the DiscoverBasicConfig files.
| Settings ID | Value | Description |
|---|---|---|
| PostMessageUrl | URL | Provide the URL for posting data to your server. Note: To enable secure transport between the logging framework and the target page, configure the URL with, https://. |
| Connection | Integer, 0-3 | Set the logging level of connection events of type connection to
be sent to the server that produces type 3 data. 0 does not send log
data.
|
| PrintScreen | Integer, 0-3 | Set the logging level of a screen shot to be sent to the server.
0 does not send log data.
|
| MaxStringsLength | Integer | Set the maximum string length to be sent to the target page per value in log statements. This prevents long strings from taking up storage and bandwidth. Note: This value must at least be 1. |
Masking
Masks the values
| Settings ID | Value | Description |
|---|---|---|
| HasMasking | Boolean | Set the value to true to allow masking. |
| HasCustomMask | TRUE | Protected text is replaced with a fixed string (xxxxx). |
| MaskIdList | Array of string | The IDs (android:id) of Views that require privacy
protection. All XPath IDs must be converted to regular expressions . For example, To match all the controls having an ID of four characters, set the regular expression as ^9[0-9][0-9][0-9]$ ". |
Cookie settings
| Settings ID | Value | Description |
|---|---|---|
| CookieUrl | String | Provide the cookie URL. Example: http://m.staussandplesser.com. |
| CookieParam | String | Provide the cookie parameter used for the sessionization of the application. Example: TLTSID or JSESSIONID. |
| CookiePath | String | Provide the path of the cookie. Example: / |
| CookieDomain | String | Provide the domain of the cookie. Example: .straussandplesser.com. |
| CookieExpires | true/false | To let the cookie expire, set the value to true. |
| CookieSecure | true/false | To add a secure parameter to the cookie, set the value to true . Use this setting only in HTTPS post URLs. |
| CookieExpiresFormat | Valid date formats: ASCTIME, RFC1036, or RFC1123 | Set a valid date format to indicate the cookie expiration format. |
| SessionTimeout | Minutes | Set the timeout value for the session. When set, the expiration of the cookie is the current time and the session timeout value. |
| SessionTimeoutKillSwitch | true/false | To call the kill switch to create a new session ID, set the value to true. The default setting is false. |
Image settings
| Settings ID | Value | Description |
|---|---|---|
| ScreenshotFormat | PNG/JPG | Provide the format of the screenshot. |
| PercentOfScreenshotsSize | Integer, 1-100 | Set what percentage of the original screenshot pixel dimensions is submitted. |
| PercentToCompressImage | Integer, 1-100 | Set the percentage to compress an image. Use this setting JPG images only. PNG images ignores this setting and set the default value to 100. |
| ScreenShotPixelDensity | Integer, 0,1.5,2,3,3.5,4 | Set a pixel density for the screenshot. The screenshot is taken at the specified density, irrespective of a device's pixel density. At 1.5 as the pixel density, captured image size will be 12 KB to 20 KB, and the replay fidelity is optimum. When pixel density is set to a value higher than 1.5, fidelity is better, but the file size is larger. When pixel density is set to 1 or lower, images size may be smaller but the quality will be blurred. Valid values are 0 and higher. Default is 1.5. |
Capture native layout
| Settings ID | Value | Description |
|---|---|---|
| LogViewLayoutOnScreenTransition | true/false | Set to true, to log the screen layout. When set to false, the screen layout is not logged and produces type 10 data. |
| GetImageDataOnScreenLayout | true/false | Set to true for prototyping to view base64 data sent to the server. The prototyping helps display images correctly during replay. Extract the image data later. Then set it up on the server, and switch to no for production of the application to be released. |
Gesture enabled
| Settings ID | Value | Description |
|---|---|---|
| SetGestureDetector | true/false | Set to true to log gestures. When set to false, gestures are not logged and produce type 11 data. |
| CaptureNativeGesturesOnWebview | true/false | Set to true to log the gestures in a webview. When set to no, the gestures are not logged and produce type 11 data. The default is set to false. It is better to have the gesture data for the webview from the UI Capture library. The UI Capture library has better information on the webview. |
Auto-geolocation
| Settings ID | Value | Description |
|---|---|---|
| LogLocationEnabled | true/false | Set to true to log the location. When set to false, the location is not logged and doesn't produce type 13 data. |
| LogLocationTries | Integer | Set the number of times to try to get the location. Set it at least to 1. |
| LogLocationTimeout | Seconds | Set the amount of time to wait before trying to get a location if it was unable to be obtained the first time. |
| DisableAutoInstrumentation | yes/no | It will enable or disable auto Instrumentation. |
Application key
The application key identifies and sessionizes mobile applications with Discover services.
Use a unique Application Key for each mobile application. Use it to capture the same data from more than one application. In such cases, use the same application key for all the applications. Group the data captured from the various application as a single entity.
Contact the administrator for the value of the application key for the SaaS service. The on-premises service may use cookies for sessionization. If cookies are used, then use TLTSID as the cookie name.