Configuration file (.ini)

The Windows and Web user interfaces need a configuration file (settings.ini) to be able to connect to the Software Factory or Intelligent Application Manager.

The connection parameters in the configuration file determine which Software Factory or Intelligent Application Database database is used to load the application model.

Connection parameters

Parameter	Description	Options
MetaSource	Meta model source	SF IAM
RDBMS	Relational database management system of the end product	SQLServer iSeries (IBM i) Oracle
Server	Name or IP address of the end product server, including the instance name
Database	Database or schema name of the SF or IAM
Authentication	Authentication to use when connecting to the IAM. To specify a different authentication type for an application database, set the Authentication extended property of the runtime configuration in the SF or the application in IAM.	MSWindows - Integrated security for SQL Server RDBMS - Database username and password Kerberos - Integrated security for IBM i and SQL Server
Model (optional, SF only)	To start a specific model
Branch (optional, SF only)	To start a specific branch	Default: latest branch
Configuration (optional)	The runtime or global configuration to use	Name of the runtime configuration. Default: default configuration
Language (optional)	Language to use for the login form and splash screen	en, nl (ISO 639-1) en-GB, nl-NL (ISO 639-1/ISO 3166) eng, nld (ISO 639-2) Default: system language
ExecutionMode (optional)	Set to Developer to enable debug options. An application that does not have the status Production can only be launched in Developer mode.	Enduser Developer
User (optional)	Default username

When no Model, Branch and Configuration are specified, the Windows and Web user interfaces will load all active runtime configurations.

Examples

IAM

MetaSource     = IAM
RDBMS          = iSeries
Server         = db2.thinkwisesoftware.com
Database       = IAM_PROD
Authentication = Kerberos

SF

MetaSource     = SF
RDBMS          = SQLServer
Server         = sqlserver.thinkwisesoftware.com\sql2019
Database       = SF_DEV
Authentication = MSWindows
Model          = MyModel
Branch         = 1.20
Configuration  = test_environment
ExecutionMode  = Developer

Or, to load all active runtime configurations for the current user:

MetaSource     = SF
RDBMS          = SQLServer
Server         = sqlserver.thinkwisesoftware.com\sql2019
Database       = SF_DEV
Authentication = MSWindows
ExecutionMode  = Developer

Windows GUI + Indicium

Metasource               = IAM
Server                   = http://localhost:5000/iam/
Rdbms                    = indicium

or:

Metasource               = IAM
Server                   = http://localhost:5000/iam/
ExecutionMode            = developer   
Language                 = ENG
Rdbms                    = indicium

Other parameters

Parameter	Description	Options
AllowResetPassword	Users with RDBMS login are allowed to reset their password. A link "Forgot password" is shown in the login page. After clicking, a new page is shown where the user can fill in the new password and a code is sent by email.	Yes No
AlternativeUserName
ApplicationIcon	Icon in the Windows task bar. . Absolute path on disk. Use UNC path when it is on a network.
ApplicationLoginBackground	Web GUI Background image for the login page. - When deploying on Azure, use a path relative to the App_LocalResources map, which is in the web server folder where the Web GUI is deployed. - When deploying on-premise, use either this relative path, an absolute path, or a UNC path when it is on a network location.	images/background.png or //server/images/background.png
ApplicationLoginBlocked	Block users to log in to the application and show a message to the user on the login page.	Yes No
ApplicationLoginLogo	Web GUI Logo on the login page, shown at 190 x 95 pixels. - When deploying on Azure, use a path relative to the App_LocalResources map, which is in the web server folder where the Web GUI is deployed. - When deploying on-premise, use either this relative path, an absolute path, or a UNC path when it is on a network location.	images/icon.png or //server/images/icon.png
ApplicationTitle	Title on the login page. The value from the ini file will be used temporary until the application title from IAM overrides it after a successful login.
AutoFillPassword	Allow automatically filling in login passwords for users who have their passwords saved in their browsers.	Yes No
BrowserIcon	Web GUI Icon in browser tab header. - When deploying on Azure, use a path relative to the App_LocalResources map, which is in the web server folder where the Web GUI is deployed. - When deploying on-premise, use either this relative path, an absolute path, or a UNC path when it is on a network location.	images/icon.png or //server/images/icon.png
CSVLogging	Write query logging to csv file. Requires ExecutionMode Developer and subdirectory Logs to exist in the GUI folder.	Yes No
LoginCaptchaNoise	Enable Captcha field on the login page to fill in before you can login.	None - No captcha Low - Case insensitive, low noise level, three chars and no chars and numbers that look alike. Medium - Low with medium noise level and four chars High - Medium with high noise level and five chars Extreme - Case sensitive, maximal noise level, five chars and all chars and numbers
LoginIamDomainUser	Enable/disable link on login page	Yes No
LogOffUrl	Url to go after logoff.
LogToFile	Write logging to file. Requires subdirectory 'Logs' to exist in the GUI folder.	Yes No
NoAsyncReportPreload	Don't preload Crystal Reports when starting (if this crashes the user interface)
ProgressbarColor	Set the color of the progressbar of the Splash screen of the Windows user interface.	RGB values, comma separated. Default: 40,170,225
ResetPasswordCaptchaNoise	Noise level for the Captcha field on the Reset password page.	See LoginCaptchaNoise parameter.
ShowLoginInfo	Database info on login page and splashscreen	Yes No
ShowPasswordStrengthIndicator	Configure whether the GUI shows password strength indicators when the user inserts a new password.	Yes No
ShowSplash	Show the splash screen	Yes No
SmtpEnableSSL	SMTP settings for password reset emails	Yes No
SmtpFrom	From email address
SmtpFromDisplayName	From display name
SmtpPassword	Password
SmtpPort	Port
SmtpServer	Server
SmtpUser	Username
TwilioAccountAuthToken
TwilioAccountSid
TwilioFromNumber
TwoFactorEmailMessageService
TwoFactorSmsMessageService
UseWindowsCulture	Windows GUI No (default): uses the Software Factory's settings. Yes: uses the region and language settings of the operating system (Windows) for displaying and editing values instead of the settings derived from the application language ID from the meta source. (Dates, times, numbers etc.)	Yes No
XFrameOptions	Configure the X-Frame-Options response header	deny sameorigin allow-from [site]