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) Indicium Oracle Mock |
| 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 |
| Project (optional, SF only) | To start a specific project | |
| ProjectVersion (optional, SF only) | To start a specific project version. | Default: latest version |
| 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 Project, Project version 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
Project = MyProject
ProjectVersion = 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 | Background image for the login page. Absolute or relative path on disk. Use UNC path when it is on a network location. | //server/images/background.png or 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 | Logo on the login page Absolute or relative path on disk. Use UNC path when it is on a network location. Shown at 190x95px. | //server/images/icon.png or 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. | |
| BrowserIcon | Icon in browser tab header. Absolute or relative path on disk. Use UNC path when it is on a network location. | //server/images/icon.png or 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. Only when executionmode is 'Developer'. 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 GUINo (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] |