Configure global solution properties.

Reference → Solution →  Designer → Settings and Tools →  Settings | Categories | Import Tags | Import Plugin | Export | History

The Solution Settings page provides centralized configuration for solution-wide parameters including platform targeting, licensing, runtime options, and interpreter settings.

Access: Solution → Settings


Settings Sections

Solution Information

Read-only information about the current solution:

FieldDescriptionExample
NameSolution filenameMyProject
File SizeDatabase size45.2 MB
DescriptionUser-defined textProduction monitoring system
Solution PathFull file locationC:\Solutions\MyProject.dbsln
Tag CountLocal tags1,234
External TagsFrom TagProviders567
Help URLCustom documentationhttps://docs.company.com/

Target Platform and License

Core deployment configuration:

SettingOptionsImpact
Target PlatformWindows Only / MultiplatformFramework and OS support
Product FamilyFrameworX / FactoryStudio / EdgeMachine / EdgeConnectFeature set
Product Model150 / 300 / 500 / 1500 / 5000 / UnlimitedPoint limits

Solution Options

Runtime behavior settings:

OptionDescriptionDefault
Culture InfoLanguage/localeen-US
Allow Client TasksWPF client-side executionUnchecked
Diagnostics LocationLog file pathLocal

Retentive Database Settings

Click gear icon to configure:

FieldDescriptionOptions
ProviderDatabase typeSQLite, SQL Server, PostgreSQL
DatabaseDatabase nameSolution.dbRetentive
ServerIPRemote serverlocalhost or IP
PasswordAuthenticationOptional

Run Modules Inside Main Process

Performance optimization:

ModulePurposeDefault
Script TasksEnable scriptsChecked
First Device ChannelPrimary communicationChecked

Python Interpreter

Python integration paths:

Path TypeDescriptionExample
LocalClient machineC:\Python39
ServerServer machine/usr/bin/python3

Provider Support

Database Providers

ProviderDatabases SupportedUse Case
ODBCMultiple via DSNLegacy systems
OleDbMultiple via connectionWindows databases
SQLiteSQLite filesEmbedded/local
SQLClientSQL ServerEnterprise
PostgreSQLPostgreSQLOpen source
OracleClientOracleEnterprise Oracle

Configuration Guidelines

Platform Selection

Windows Only - Choose when using:

  • Windows Authentication
  • OPC Classic
  • Canary Historian
  • Windows-specific .NET libraries

Multiplatform - Choose when:

  • Deploying to Linux
  • Using Docker containers
  • Cross-platform requirement
  • Cloud deployment

License Configuration

Must match production license:

If License IsSet Family ToSet Model To
FrameworX-5000FrameworX5000
FactoryStudio-1500FactoryStudio1500
EdgeMachine-300EdgeMachine300

Culture Info Settings

CultureFormat ExampleUse For
en-US12/31/2024, $1,234.56US English
pt-BR31/12/2024, R$ 1.234,56Brazilian Portuguese
de-DE31.12.2024, 1.234,56 €German
ja-JP2024/12/31, ¥1,234Japanese

Best Practices Checklist 

Initial Setup

  • Set Target Platform before development
  • Configure Product Model to match license
  • Set Culture Info for target locale
  • Configure Python if using scripts

Retentive Database

  • Use SQLite for standalone
  • Use SQL Server for enterprise
  • Test connection before saving
  • Document connection string

Module Execution

  • Enable Script Tasks if using scripts
  • Enable Device Channel for communications
  • Consider performance impact
  • Monitor resource usage


Troubleshooting

IssueCauseSolution
Platform grayed outSolution has objectsRemove objects first
License mismatch warningWrong modelMatch to actual license
Python scripts failWrong pathVerify interpreter location
Database connection failsWrong credentialsTest connection

In this section...