Configuring the User Interface

#### Search Results

Search

# Configuring the User Interface

In addition to the aforementioned, the following properties are also part of the application.properties file.

However, these properties are related to the user interface and the Angular© web application:

Property name | Description | Required | Default and Optional Values
--- | --- | --- | ---
`com.softwareag.natural.chimera.fields.input.trim` | Defines if and how to trim the field's content when the screen is loaded. The `trimChar` property contains the value to trim. | No | Optional values: none (default) Left Right both
`com.softwareag.natural.chimera.fields.input.trimChar` | The character to remove from the field's content. Note When defining a space character, set the value to "\ " (backslash and space). | Yes, if the trim property is set. |
`com.softwareag.natural.client.config.selectOnFocus` | Define if focusing on an input field will select the full content of the field. | No | false
`com.softwareag.natural.client.config.themesList` | Define the list of themes available in the client UI. The themes define the look and feel of the application. There is an option to create a new CSS theme file and add it to the list. | No | This is the default theme list: emulator.css theme_dark. css theme_light.css
`com.softwareag.natural.client.config.insert-mode` | When configured to true, the web application will be set to insert mode (override mode), and any key stroke will override the content of the next key in the input field. The client can also press the insert key in the keyboard and toggle the override mode. | No | false (default) true
`com.softwareag.natural.client.config.tab-on-field-full` | If set to true, when the content of an input field is full, the focus will jump to the next input field. | No | false (default) true
`com.softwareag.natural.client.config.tab-navigation-options` | Define whether tabbing will navigate in input and output fields or only in input fields. | No | Inputs (default) all
`com.softwareag.natural.client.config.arrow-navigation-options` | Define whether arrows will navigate in input and output fields or only in input fields. | No | Inputs (default) all
`com.softwareag.natural.client.config.chars-to-remove-in-copy` | When copying the content of a selected output field, the browser might add some escape characters in the copied content. This property defines the characters to remove from the copied content. The default value is `\n` to handle the content added by Chrome. If you need to define more than one character, use a comma to split between characters. Example: `\n,\r` | No | \n (default)

The following table of properties is also related to the user interface and the handling of HTTP errors.

You can use the properties to configure the following:

- Define which HTTP errors cause the application to resend a failed request.

- Define how many attempts are made for a resend.

- Manage the amount of time between resends.

Property name | Description | Required | Default and Optional Values
--- | --- | --- | ---
`com.softwareag.natural.client.config.http-errors.recoverable.enabled` | Define if resending requests for recoverable HTTP errors is enabled. | No | true
`com.softwareag.natural.client.config.http-errors.recoverable.max-attempts` | Define the number of times that the application resends a failed request. | No | 2
`com.softwareag.natural.client.config.http-errors.recoverable.codes` | Define a list of HTTP error codes that cause the web application to resend the request. | No | 502
`com.softwareag.natural.client.config.http-errors.recoverable.first-timeout` | Define the amount of time in milliseconds that the client waits before sending the request again for the first time. | No | 500
`com.softwareag.natural.client.config.http-errors.recoverable.timeout-compute-mode` | Define how to compute the timeout for subsequent HTTP requests. | No | FIXED (default value) – use the value from the `first-timeout` property. MULTIPLE – multiply the last request's timeout amount by the number defined in the `multiplier` property to get the new timeout. ARRAY – use the array from the `timeout-array` property to determine the timeout for each attempt.
`com.softwareag.natural.client.config.http-errors.recoverable.multiplier` | Define the multiplier for compute mode MULTIPLE. | No | 2 – each request multiplies the previous request's timeout amount by 2.
`com.softwareag.natural.client.config.http-errors.recoverable.timeout-array` | Define the timeout array for compute mode ARRAY. | No | {500} – in this case all requests have a timout of 500 milliseconds.

The following table of properties is related to intermediate screens.

Intermediate screens show when the application is performing a task, for example processing data. The user does not expect to insert any data during intermediate screens. When the user gets to an intermediate screen, the web application should try to check if the server has a new screen. The following properties define how to configure the behavior of such requests.

Property name | Description | Required | Default and Optional Values
--- | --- | --- | ---
`com.softwareag.natural.client.config.intermediate-screen.enabled` | Define if resending requests for intermediate screens is enabled. | No | true
`com.softwareag.natural.client.config.intermediate-screen.max-attempts` | Define the number of times that the application resends a request for an intermediate screen. | No | 2
`com.softwareag.natural.client.config.intermediate-screen.first-timeout` | Define the amount of time in milliseconds that the client waits before sending the request again for the first time. | No | 500
`com.softwareag.natural.client.config.intermediate-screen.timeout-compute-mode` | Define how to compute the timeout for subsequent intermediate screen requests. | No | FIXED (default value) – use the value from the `first-timeout` property. MULTIPLE – multiply the last request's timeout amount by the number defined in the `multiplier` property to get the new timeout. ARRAY – use the array from the `timeout-array` property to determine the timeout for each attempt.
`com.softwareag.natural.client.config.intermediate-screen.multiplier` | Define the multiplier for compute mode MULTIPLE. | No | 2 – each request multiplies the previous request's timeout amount by 2.
`com.softwareag.natural.client.config.intermediate-screen.timeout-array` | Define the timeout array for compute mode ARRAY. | No | {500} – in this case all requests have a timout of 500 milliseconds.