Creating Solutions (Reference) : Technical documentation for creating and configuring new FrameworX solutions.
Table of Contents maxLevel 2 minLevel 2 indent 10px exclude Steps style none
A Solution
is a complete application built
in FrameworX, stored as a single .dbsln file
containing all configuration data including tags, alarms,
devices,
displays, scripts, and
other modules. Creating a new solution
generates this file with initial metadata
, which you then configure using Designer.
On this page:
Table of Contents | ||||||
---|---|---|---|---|---|---|
|
Children Display | ||||||
---|---|---|---|---|---|---|
|
To create a
newsolution
, in the Solutions Manager, click
theNew...
button at the top of the solution list to startin Solution Center to launch the New Solution Wizard.
WizardSelect the product family and
the product model.The software platform technology powers four product options:
model for your solution:
FactoryStudio: Scalable models based on the number of communication points, enablingProduct Family | Description | Use Case |
---|---|---|
Unlimited | All features, unlimited tags/users/points | Enterprise applications |
FrameworX | Scalable by communication points |
SCADA, MES, |
HMI applications | ||
EdgeHMI | Subset features by points | Machine HMI, embedded devices |
EdgeGateway | Based on data connections | Data gateway applications |
Note: Configuration tools are free. Production deployment requires appropriate license matching your selected model.
Platform | Description | Requirements |
---|---|---|
Windows | Windows-only features (Windows Auth, third-party libraries) | .NET Framework 4.8 |
Multi-Platform | Cross-platform (Linux, Docker) | .NET 8 on development and runtime machines |
Templates provide preconfigured components and settings for faster development.
Template | Description | Best For |
---|---|---|
HeaderLayout | Standard header navigation | Desktop applications |
TabLayout | Tabbed interface | Multi-screen applications |
MobileLayout | Responsive design | Mobile/tablet applications |
Blank | No pre-configuration | Custom designs |
Templates are standard .dbsln files stored in:
Documents\FrameworX\Templates\
To add templates:
After creation, solutions contain:
Component | Location | Purpose |
---|---|---|
Solution Settings | Solution → Settings | Product model, platform, metadata |
Unified Namespace | UNS module | Tag definitions and structure |
Devices | Devices module | Communication protocols |
Displays | Displays module | User interface screens |
Scripts | Scripts module | Business logic |
File Type | Extension | Description |
---|---|---|
Solution | .dbsln | Active configuration database |
Backup | .dbback | Archived solution |
Published | .dbrun | Read-only production version |
Legacy | .tproj | FactoryStudio 9.x format |
Type | Default Path |
---|---|
Solutions | Documents\FrameworX\Solutions |
Templates | Documents\FrameworX\Templates |
Backups | Documents\FrameworX\Backups |
For bulk solution creation (e.g., deploying to multiple edge devices), use the Solution Creator utility.
See Solution Creator (Reference) for details.
Issue | Cause | Solution |
---|---|---|
Template not appearing | Not in Templates folder | Copy .dbsln to correct location |
Can't create solution | No write permissions | Check folder permissions |
Platform option grayed out | Missing .NET 8 | Install .NET 8 Desktop Runtime |
Wizard fails | Corrupted template | Remove problematic template |
Page Tree | ||||
---|---|---|---|---|
|
For details about product families and licensing models, see the Product Series page.
Info | ||
---|---|---|
| ||
Solution Configuration tools are available free of charge, but a license is required to deploy your solution in a production environment. The Product Family and Model (number of points) selected when creating a new solution should reflect the intended license you plan to acquire for production installation. You still can change those settings after creating the solution, in the Designer tool under Solution Settings. |
Platform | Description |
---|---|
Windows | Select if your application requires Windows-only components such as Windows Authentication or third-party libraries like Canary Historian. |
Multi-Platform | Select for Linux or cross-platform environments. This option requires .NET 8 installed on the computer that will execute the solution and on the computer developing the application. |
Define the name and review the location for saving your solution file, select a solution template and press the Create New Solution button.
If you don’t select a template, the default HeaderLayout template will be applied automatically.
Solution templates help you start faster by providing preconfigured components, settings, and modules. These templates can be customized to suit your specific application needs.
Examples of templates include starter layouts for web-based, desktop, or mobile solutions. Some templates are included with the software, and you can also create or import your own.
Adding New Templates
The templates available when creating a new solution are standard solution files located in the user's Documents folder under Templates.
To use a template received from a vendor or integrator, simply copy the .dbsln file into the Templates folder located in your Documents directory. You can also customize existing templates by opening and modifying the solution files in that folder.
When you need to create multiple solutions—such as deploying hundreds of edge devices based on configuration files—the platform provides a utility to automate and streamline this process.
For details, see the Solution Creator (Reference) page.
In this section:
Page Tree | ||||
---|---|---|---|---|
|