Skip to main content
Version: 15.0

Configure the ADONIS Web Client

In order to configure the ADONIS web client, settings for the login process and general settings have to be adapted.

Settings for the Login Process

In order to adapt the settings for the login process:

  • Open the folder <ADONIS installation>/conf” and edit the file adoxx_web_conf.js.

The following section lists the parameters that have an impact on the login process in the web client and their meaning:

  • ADOXX_JS_LOGLEVEL:

    The log level used in ADONIS. By default, only errors are logged, but other log levels can be set. Possible values are AIT_LOGLEVEL_ERROR, AIT_LOGLEVEL_WARN, AIT_LOGLEVEL_INFO, AIT_LOGLEVEL_DEBUG and AIT_LOGLEVEL_PROFILE.

  • ADOXX_WEB_CLIENT_SHOW_LANG_SELECTION:

    Specifies whether the user should be able to switch the language for the web client on the login page. If this is set to true, a drop-down menu containing the available languages is displayed on the login page of the web client. Possible values are true or false.

  • ADOXX_WEB_CLIENT_LANGUAGE:

    The language id of the standard language the web client should be started with. Depending on the product configuration, possible values are e.g. “en” for English or “de” for German.

  • ADOXX_WEB_RESTRICT_WEB_SERVER_SESSIONS:

    If this is set to true, every user can be logged in only once to the web client. When a user logs in again, any old web sessions are closed. This has the effect that artefacts (objects, models, groups) that were locked in the old session are unlocked again without saving. Possible values are true or false.

  • ADOXX_WEB_FILE_POINTER_PROTOCOLS:

    This setting lists the protocols that should be recognised by the ADONIS web client. By default, the protocols HTTP, FTP and HTTPS are recognised. To add a protocol, the protocol name has to be added to the field. Files that are referenced by protocols not listed here are assumed to be using the protocol “file:///”.

  • ADOXX_WEB_LOGIN_PAGE_IDM:

    This is only relevant if an identity manager is used to login to the web client. This setting specifies the login page for this working mode. The value entered in this setting is the URL of the page, to which the web client forwards in case of session timeouts or when the logout button in the web client is clicked.

  • ADOXX_WEB_TRACK_LOGINS:

    This property is used to control the behaviour of logging in the ADONIS web client. By default this is set to true, which means that the web client will log the login name for each user that logs in to the web client. If this is set to false, the logins will still be tracked, but the users’ names will not be contained in the logs.

  • ADOXX_WEB_CHUNK_LIMIT:

    This setting defines the maximum package size when calling web methods from the application server. The default value is "0" which means the size of packages is not limited.

  • ADOXX_WEB_USE_JSM:

    This setting specifies how the application server handles the internal JavaScript resources. The value should only be changed for debugging.

General Settings

Within the ADONIS web client there is a configuration file which has an impact on general settings on the web server side. In order to adapt this file:

  • Open the folder <Tomcat installation>/webapps“ and open the file ADONIS15_0.war with a file archiver. Edit the file adoxx_web.properties which can be found inside. Save the changes afterwards.

The most important configuration parameters are listed below. Usually, it should not be necessary to change the other parameters:

  • aservers

    The URL at which the ADONIS application server can be reached. The URL consists of the name of the application server (can be freely defined) and the domain name or IP address (a port should NOT be included). You only need to change this parameter if the application server and the web server are running on different machines.

Example

If you are running the application server locally, and the name of the application server is "AS1", the parameter should look like this:

aservers = AS1:localhost

  • aworkers

    aworker process started by the application server. The parameter consists of the name of the application server (as defined in the parameter aservers) and the port (as specified in the file server.conf). You only need to change this parameter if the port is already used by other services in your environment, or to set up a load balancing configuration.

Example

If the application server name is "AS1" and you are using the default port, the parameter should look like this:

aworkers = AS1:41500

  • copy_db_files

    When starting the web server it tries to connect to the application server and copies some plugin data and icons of the ADONIS database into the "webapps" directory of the web server. In some scenarios this may not work because there is no write permissions to that directory. Therefore this behaviour can be switched off by setting this parameter to false and copying the required data manually into the webapps folder (by default it is set to true).

  • search.result.max.size

    This parameter specifies the maximum search result limit in the web client.

  • translation.maximum.artefacts

    This parameter specifies the number of models and objects that can be translated at once in the web client.

  • report.parallel.execution

    This parameter specifies the number of reports that can be created in parallel in the web client.

  • security.src.frame-ancestors

    Specifies for which pages embedding ADONIS as an iFrame is allowed. The parameter 'self' allows you to embed ADONIS from pages with the same origin as the web server. In addition, one or more URLs of websites may be specified. Separate the parameters with a space.

Example

If you want to allow embedding ADONIS as an iFrame from the same origin and https://example.com, you can use:

security.src.frame-ancestors = 'self' https://example.com

  • supportinformation.disable

    Specifies whether the support package is available for download within the ADONIS web client (see "Appendix B: Troubleshooting"). Possible values are "true" or "false".

  • use.cases.allow.unique.column.state

    Specifies whether the Explorer maintains its expanded or collapsed state when switiching between workplace areas, such as "Find" or "Analyse," or switching between components, such as different editors. If set to "true", each area or component will have its own independent Explorer state. If set to "false", the Explorer state will remain consistent across all areas and components.

  • explorer.class.filter.expand.all

    Specifies whether all elements of a particular type are displayed when filtering the Explorer by type, or if only the elements within the currently open groups will be shown. If set to "true", all elements of the selected type will be displayed, and any groups containing these elements will be expanded. Please note that this may result in longer loading times, particularly for larger databases. If set to "false", only the elements of the selected type within already expanded groups will be displayed, improving loading times.