Configuration Properties / tim.properties

Configuration Properties / tim.properties


This page explains the properties that can be applied to all or a specific tenant.

All the configuration properties are defined in a file that is called tim.properties and can be uploaded to the resources folder in the super tenant.

Only administration users in the super tenant are allowed to change this file.


Header about Product Version Information

version=vDevTrunk revision=rXXX.cYYY timestamp=17.03.2016 8:00

Property Key

Default Value

Allowed Values

Description

Property Key

Default Value

Allowed Values

Description

version

it’s always the release version which is set by the build

String

This parameter tells which version is currently in the system. This information can be found on the login page.

This property should not be changed and is defined by TIM Solutions for each release TIM BPM.

revision

coming from git.properties now, cannot changed

String

This parameter provides the information of the technical and unique identification of the installed version.

This property should not be changed and is defined by TIM Solutions for each release TIM BPM.
Revision information is shown on the login page at the tooltip.

versionClaim

empty

String

This parameter is used to highlight different systems so that the users can better distinguish between for example development, staging, UAT, and production systems. It is shown on login page.

timestamp

Coming from git.properties now, cannot be changed

String → Datetime

This parameter shows when the installed version was developed.

This entry should not be changed unless the user is instructed by a technician to do so.


General Settings

Property Key

Default Value

Allowed Values

Description

Property Key

Default Value

Allowed Values

Description

adhoc-node-duration

2400

Integer

Process flow does not interrupt when an ad-hoc task created. This property is used for an urgent need and it has 24 hours duration which corresponds to three business days with the default value.

Format: hhmm

basic-auth-token-name

X-CSRF-Token

String

This property is used to set the default name for the token which used in TSD and REST manager.

blacklist-characters

\x01,\x02,\x03,\x04,\x05,\x0B

String → comma-separated list of character codes

This property is used to list of special chars which are removed and replaced with blank in forms. The list can be expanded with more chars.

blog-article-inheritance optional

null

String → comma-separated list

  • read,write

  • read

  • write

  • null or false

This property determines if the notes from the main process should be seen in its subprocesses. If the parameter is set to read the notes are visible. With write, notes from the subprocess are attached to its mainprocess, but not to the subprocess.

Default value is not set here, so any change can be done here for desired result.

default-duration-urgent

100

Integer

This parameter is used to lower every duration in every single node of a process instance to one hour if a process owner opens an urgent process instance.

default-token-valid-duration

1440

Integer

This parameter determines 24 hours time limit for one-time access tokens (link for access has a token) for non-product users.

log-response

false

Boolean

This parameter is used to locking the response from HTTP REST Manager (https://tim-doc.atlassian.net/wiki/spaces/eng/pages/228396040) for debugging issues. The whole response will be received from the rest endpoint when this is set to true.

max-task-link-count-in-mail

50

Integer

When a user is deleted, their tasks will be assigned to their successor or representative. This parameter set the limit for these tasks which can be assigned to 50 at most in the email notification. The other tasks can be seen by the user by checking.

my-instances-mainprocess-only

false

Boolean

This parameter determines which processes will be shown in started instances list.

If it is set to true, it will show only main processes in started instances.

pick-list-max-users

300

Integer

This parameter determines the maximum number of available users displayed in the group assignment of SIX Administration.

The default configuration for maximum allowed users is in the picklist.

section-lock-timeout

30

Integer

HTML forms have section log information for each section of users when they logged in. This parameter determines the timeout value for section log information.

No old section log will remain after the timeout value.

softlink-nodeinstance-check

true

Boolean

This parameter is used to check for softlinks which are already started so they won't start again in the situation of a process needs to be redone.

userimport-limit

250

Integer

This parameter sets the limitation of how many users can be imported into the product by csv-file. This number can be increased if more users are to be imported.


Environment Settings

Server Configuration (Root URL)

Property Key

Default Value

Allowed Values

Description

Property Key

Default Value

Allowed Values

Description

server-root-url

empty

String

This property determines the URL for server redirect behind load balancer.

cloud-environment

false

Boolean /
String → aws

This parameter is used to set licensed cloud service if company uses cloud. Possible values are aws or false. azure is not supported yet.

If company uses cloud then default value false should be changed.

 

Cache Handling Settings

Property Key

Default Value

Allowed Values

Description

Property Key

Default Value

Allowed Values

Description

no-cache

false

Boolean

This parameter determines if the browser cache information will automatically deleted for every login.

If nothing is stated, the cache will not be emptied.

enable-login-cache-flushing

true

Boolean

This parameter is used to delete the login cache every time the user logs in. It is created to prevent troubles during big migrations.

If there is a specific case to not delete the login cache (for a technical user who does the migration etc.), it should be false.

 

Login Provider

Property Key

Specificity

Default Value

Allowed Values

Description

Property Key

Specificity

Default Value

Allowed Values

Description

login-provider

 

This property is commented out. Can be set to:

com.dooris.security.providers.HttpBasicLoginProvider

Namespace

Any server can be pointed if it is asking for a HTTP basic login. This parameter determines the server which will be taken as a reference to decide if the user can login or not.

http-basic-login-provider-host

  • http-basic-login-provider-host-<tenantname>

This property is commented out. Can be set to:

https://postman-echo.com/basic-auth

URL

This parameter determines the login provider's host name.

http-basic-login-provider-skip-tenant

  • http-basic-login-provider-skip-tenant-<tenantname>

true

Boolean

tenantName/ is not sent when entering the login information by default true value of this property, if the tenant information wanted to be skipped.

ldap-single-transaction-size

 

250

Integer

This parameter determines the number of users taken per transaction for https://tim-doc.atlassian.net/wiki/spaces/eng/pages/227871731 timers to calculate the necessary number of users wanted to perform in one single transaction. If there are more than 250 users, the transaction chunks will be divided into blocks of up to 250 users.

saml-old-tim-client

 

true

it will be false someday but now its true

Boolean

This property determines which front end client will be used for SAML users, when they log in. The value true means that the legacy front end (“roots“) will be used. If it is set to false the current front end client implementation (“SIX“) will be used.

Password complexity

A password policy can be set for the whole system. Users will get a notification on login or on password change, if their password does not meet the criteria. This feature was introduced with version 9.0.3.

Property Key

Default Value

Allowed Values

Description

Property Key

Default Value

Allowed Values

Description

password-policy-minimum-characters

8

Integer

Specifies the minimum number of characters of user passwords.

password-policy-maximum-characters

0

Integer

Specifies the maximum number of characters of user passwords.

password-policy-uppercase-characters

0

Integer

Specifies the minimum number of upper case characters of user passwords.

password-policy-lowercase-characters

0

Integer

Specifies the minimum number of lower case characters of user passwords.

password-policy-number-characters

0

Integer

Specifies the exact number of characters of user passwords.

password-policy-special-characters

0

Integer

Specifies the minimum number of special characters of user passwords.


Database Settings

Property Key

Default Value

Allowed Values

Description

Property Key

Default Value

Allowed Values

Description

stringvalue-max-mysql

4000

Integer

These properties determine the limit for process variable´s key values in the stringvalue column in the database.

stringvalue-max-mssql

50000

Integer

stringvalue-max-oracle

4000

Integer

stringvalue-max-default

4000

Integer

fail-on-database-check

false

Boolean

This parameter determines to check if there is a database connection fail for AliveCheckServlet. If the database wanted to be checked, this parameter can be set to true and AliveCheckServlet will be failed, too.

mysql-collation

empty

String → MySQL :: Supported Character Sets and Collations
Example: utf8_bin

This property is used to set a custom mySQL collation if the customer is using one.


File Handling

Resource Files

Property Key

Default Value

Allowed Values

Description

Property Key

Default Value

Allowed Values

Description

resource-size-treshold

20480

Integer

This parameter determines the threshold for resource files when uploading them to resource folder. This threshold defines which files are kept in memory only or which are kept in the local temporary folder.

→ in Bytes

resource-size-max

10

Integer

This parameter determines the maximum size of resource documents when uploading. If the file is bigger than the defined value the user is not allowed to upload the resource file and a warning will be shown.

→ in MB

zip-max-files

250

Integer

This parameter determines the maximum amount of ZIP entries that are contained within the package to upload to the resource folder. If more files are contained in the package than the defined value the user is not allowed to upload the resource file and a warning will be shown.

csv-encodings

UTF-8;ISO-8859-1;Windows-1251

String

This parameter determines the content encoding for uploaded CSV files for use.
The defined encoding formats will be shown in the dropdown list for CSV imports, e.g. for the bulk https://tim-doc.atlassian.net/wiki/spaces/eng/pages/228493440:

zip-encodings

Cp437;UTF-8;ISO-8859-1

String

This parameter determines the ZIP encoding for upload to resource folder.

performance-log-threshold

500

Integer

This parameter defines the threshold for performance logging in ms. Only requests that take longer than the given time are logged. This helps to see faster requests which still take longer as they should (like small resource files).

 

Documents

Property Key

Specificity

Default Value

Allowed Values

Description

Property Key

Specificity

Default Value

Allowed Values

Description

document-size-treshold

 

20480

Integer

This parameter determines the threshold that defines which files are kept in memory only or which are kept in a local temporary folder when uploading product document files.

→ in Bytes

document-size-max

 

10

Integer

This parameter determines the maximum size per file when uploading it in the Documents tab of the product. Each file you want to upload must be lower than 10 MB or there will be an error pop up notification.

→ in MB

upload-size-max

 

50

Integer

This parameter determines the maximum upload size when more than one file is uploaded at once. For example, with the default value of 50 MB, six documents with the size of 10 MB each cannot be uploaded at once.

→ in MB

tenant-max-storage-size

 

-1

Integer

This parameter determines the maximum storage size per tenant.

→ in MB
-1 means there is no limit for the storage size per tenant.

timPdfConverter

 

aspose

aspose

This parameter determines the default vendor for PDF conversion with the default value aspose.

docconverter-rollback

 

true

Boolean

This parameter determines whether the conversion process should be rolled back when it runs into a timeout.

If you set this to false, the document conversion can fail but the process will go on.