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.