Config file (appsettings_global.json)

Eugene Kuchynski — Mon, 16 May 2022 06:38:52 GMT

Current Revision posted to Wiki by Eugene Kuchynski on 5/16/2022 6:38:52 AM

Introduction

TBM stores some information about application settings in a file which is created after first launch of the application, and which is named appsettings_global.json. Depending on version, this file can be found at:

Team/Enterprise version - in the application installation folder
Essential - [InstallFolder]\resources\bin (default is \Documents\SDL Trados Business Manager 6\resources\bin).

It is not recommended to make edits in this file. However, in certain cases it is mandatory to do that. One of examples is described in this article (changing AllowedIPAddresses parameter in this file allows to block access to the application from all computers except listed IP-addresses).

List of parameters in the config file

DatabaseVersion

This parameter stores a list of tenants and version numbers. When a new update is released, sometimes it is needed to update information in the database. From the value in this section, TBM "knows" last database version to which application has been updated. Upon next launch, application will read a value, and if this value is lower than latest version, corresponding database update code will be launched.

For example, if you use Essential version, and try to delete database file and launch the application, you will get an error message, because application won't be able to establish connection with deleted database. Thus, to make the application working correctly, you have to open this file in any text editor, change database version for the TBM value to 0, save file and re-launch the application. In the result, a new database will be created.

ConnectionStringLocal

Applicable only for Essential version. Stores a path to a database file in case you use non-default path. It can be changed from the application UI (Settings page).

LanguageLocal

Stores selected UI language value (null value for automatic selection).

CultureLocal

Stores name of a culture selected to format dates and numbers (null value for automatic selection).

AllowedIPAddresses

List of IP-addresses allowed to access the application. Applicable only for Team/Enterprise versions.

LockSettings

Determines if it is allowed to open /Config page to configure database connection settings. It should be set to false. Applicable only for Team/Enterprise versions.

DesktopLastUrl

Stores last page opened in Essential version, to restore it upon next application launch.

DesktopLastBackup

Information about last backup date. Applicable only for Essential version.

DesktopPort

Allows to select non-default port for Essential version, if default port is busy on a user's machine.

RoleMerging

Specifies behavior of the security system when combining multiple roles for a user. See Working with roles article for details. Default value is empty or all (Granted in all roles). Optional value is any (Granted in any role).

ConnectionStrings

List of connection strings. Key value correspond to tenant name, and value contains connection string. Applicable only for Enterprise version. For team version, always has only one row (for TBM tenant, which is a fixed name).