System Settings Overview (Settings.xml)
  • 24 Jun 2022
  • 5 Minutes to read
  • Dark
    Light

System Settings Overview (Settings.xml)

  • Dark
    Light

Overview

The Settings.xml file contains adjustable parameters pertaining to server administratiowithin an Installation

Such parameters include the ability to adjust the size of the System Logs, Email Server settings, and settings specific to the database that the platform is hosted on. The following document discusses how access and edits the Settings.xml file.


Locating and Adjusting Settings.xml

The file can be found by which can be found by navigating to the Decisions Server folder within the primary installation location (typically C:\Program Files\Decisions\Decisions Server).
Settings can be altered as desired by opening the file in a Text Editor and replacing the contents between each open tag and its respective close tag with the desired/applicable value.
 
Many of the settings use a Boolean value of true or false to indicate whether they are enabled or disabled, where as others require more specific configuration.


System Settings Chart

The following table represents a list of the available editable tags located within the Settings.xml file. 

For Versions 7.x+
As of Version 7, the SendErrorsTo tag is no longer implemented. Instead, by default Log Errors are sent to the ServerAdministratorEmail tag. 
Setting Function 
SkipTypeCheckOnInitialization(true/false) Skips JavaScro[t type check at runtime. 
ShowDraftModeApps(true/false) Toggles visibility of draft apps in the App Store
HideSystemValidationWarning(true/false) Hides System Validation Warnings on true value. 
DynamicLocalModuleLoading(true/false) Loads a library, as well as its functions, into memory. 
NoLockReads(true/false) Enables No Lock which allows SQL to read data without regard to locks and other blockers. 
LogFileMaxSize(Number in bytes, Default 10485760) Maximum size of a Log file before Decisions rolls over to a new file. The maximum size is maximum Int32 value i.e. 2,147,483,647 bytes aka 2.14 GB
LogMaxBackups(Number, Default 10) The maximum number of Log files to keep.
LogSqlStatementsTakingMoreThanSeconds(Number in seconds, Default 5) If an SQL statement exceeds this number of seconds, then it will be logged to the Log file to help find performance problems.
LogAPICallsTakingMoreThanSeconds(Number in Seconds, Default 5) If an API call exceeds this number of seconds, then it will be logged to the Log file to help find performance problems.
LogFlowStepsTakingMoreThanMilliseconds(Number in Milliseconds, Default 1000) If Flow execution exceeds this number of milliseconds to execute the step, then it will be logged to the Log file to help find performance problems.
LogFatal(true / false) Determines whether or not Fatal-level errors from the Decisions environment be recorded to the Decisions log file.
LogError(true / false) Determines whether or not Error-level errors from the Decisions environment be recorded to the Decisions log file. 
LogWarn(true / false) Determines whether or not Warn-level errors from the Decisions environment be recorded to the Decisions log file. 
LogDebug(true / false) Determines whether or not debugging information from the Decisions environment be recorded to the Decisions log file. 
DefaultAccountEmailAddress(String email, default admin@decisions.com ) Default account Email address.
AutoStartProfiler(true / false) Capture session by the profiler.
AutoProfileApiThresholdInSeconds(Number in Seconds, Default -1) Turns off the profiler when any API call takes more than this number of seconds.
AutoProfileTimespanInSeconds(Number in Seconds, Default 600) Time that the profiler runs before stops.
InitializationEndPointConfiguration settings for WCF Services hosted out of Decisions Service Host Manager.
MaxReceivedMessageSizeMax Received Message Size for a Single WCF Call.
MaxArrayLengthMax Size of an Array for a Single WCF Call.
MaxStringContentLenthMax length of string content, set to 1048576 (1 MB)
ReceiveTimeoutSeconds(Number in Seconds, Default 600) Timeout for single WCF Call.
SecurityMode(String value, Default None) Available options: None (No Security), Transport ( Used with SSL  ) , Message, TransportWithMessageCredential, TransportCredentialOnly.
DatabaseConnectString(Connection string encrypted) The connection string to Decisions database. May be changed. After changes will be automatically encrypted. Typically defined while Decisions Installation.
SecondaryDatabaseConnectString(Connection string encrypted) The secondary connection string to Decisions database. May be changed. After changes will be automatically encrypted.
DataBaseType(String, Default MSSQL) Available options: MSSQL, AzureSQL, SQLlocaldb. Defined while Decisions Installation and not recommended to be changed.
PortalBaseUrl(String, URL) URL to the Portal. Defined during Installation.
ServerAdministratorEmail(String email, Default support@decisions.com ) There is an action in Decisions called 'Send Logs to Support' and there's an action called 'Send Notification to Server Admin'  these actions are used by users to report problems and get help. The email in this setting is the target of these notifications. 
MailMail Settings for the Decisions application to send email notifications to users and workflow task assignees.
ServerName(String) Server Name.
ServerHeartBeatIntervalInSeconds(Number in seconds, Default 5) Heartbeat Interval.
SessionExpirationTimeInHours(Number in hours, Default 5) The expiration time for the Session.
SocketsAddress(String IP, Default 0.0.0.0) Address for Socket.
SocketsPort(Number) Port number for Socket.
SendWakeUpUsingOneWayCall(true / false)
UseTimeZoneTranslation(true / false) Should Time Zones be Translated.
UseClientFastCall(true / false) Client/Server fast call.
ShowUnhandledExceptionDialog(true / false) Enable or Disable showing Error window when Unhandled Exception caught.
ClientStorageQuota(Number)
ClientDomain(Url) Typically populates automatically after providing Smtp Settings; this defines the address of the System where an Email is sent from.
SplashScreenText(String, Default: Decisions OS is Loading...) Text that is being shown when Portal is loading or reloading.
ProductTitle(String) Product Title.
AllowedIPAddresses(String IP, Default 0.0.0.0) IP Addresses for machines allowed to access Decisions.
DeniedIPAddresses(String IP, Default 0.0.0.0) IP Addresses for machines not allowed to access Decisions.
UserIdCaseSensitive(true / false) Case sensitivity for User Name on login.
ControlInstanceEndpointsConfiguration settings for WCF Services hosted out of Decisions Service Host Manager.
AlterDBCommandTimeoutSeconds(Number in Seconds, Default 120) Timeout for modifying the database.
LogCheckFieldTypes(true / false) Should Field Types checking to be logged into the Log file.
DefaultDatabaseQueryTimeout(Number in Seconds, Default 60) The time before the database query fails.
DefaultInstanceName(String, Default: Primary) The default name for the installed Decisions' instance.
ApplicationNameCustom Application name that can be used by Cookies that are created.
EnableHTTPThe setting to use the default web traffic port for connections to the Decisions Server.
EnableHTTPSThe setting for the secure web traffic port for connections to the Decisions Server.
HttpsCertificationPathThe setting that controls the path to the certificate.
HttpsCertificationPasswordThe setting that holds the certificate password if configured.
EnableHttptoHttpsRedirectionThe setting that controls if http to https redirection is enabled.
LazyLoadingSetting that prioritizes specific services that are immediately needed and load other services on-demand to reduce initial overhead/system strain. Specific priority services can be toggled.
DisableAutoSSOSignInParameterThis setting disables the Login Page SSO Bypass URL; setting this parameter to false allows users to log into an SSO environment using ?AutoSSOSignIn=false in the URL. If the value is set to true, this parameter will not work; instead, users will be redirected to the SSO page to sign in. 
EnableStaleFlowsDataStore(true / false, Default: false) The setting enables or disables using DataStore for FlowStorage in a single node and clustered environment
UsePrototypeInstance
Setting that allows the use of a template instance. Mainly used for multitenant environments

For more information and questions regarding Settings.xml, see Decisions Forum: Settings.

Was this article helpful?