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.
- has the highest priority (critical).
- has a medium priority (important).
- has the lowest priority (information).
|
| PrintScreen |
Integer, 0-3 |
Set the logging level of a screen shot to be sent to the server.
0 does not send log data.
- has the highest priority (critical).
- has a medium priority (important).
- has the lowest priority (information).
|
| 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 (iOS: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 |
| SessionizationCookieName |
String |
Provide the cookie parameter used for the sessionization of the
application. For example, TLTSID or JSESSIONID. |
| 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. |
Screenshot
| 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. |
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 | yes/no | Set to yes to log the location. When set to no, the location is not logged and doesn't
produce type 13 data. |
| 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.
