Overview
A Solution represents a complete application built using the platform. It stores all configuration data in a .dbsln file, including tags, alarms, device settings, graphical displays, scripts, and more.
When creating a new solution, the system generates a new .dbsln file with initial metadata like name and description. The remaining configuration is performed using the Designer tool
Solution management cover the routines you use to manage solutions within the Solution Manager. This includes creating new solutions, making edits, viewing details, running them for execution, upgrading to newer versions, and utilizing solution templates. These workflows simplify developing, deploying, and managing industrial applications.
For a complete overview on the Solution Manager user interface, see Solutions Manager.
On this page:
| Table of Contents | ||||||
|---|---|---|---|---|---|---|
|
Creating a New
SolutionsSolution
To create a new Solution:
On the Solutiona new solution, in the Solutions Manager, click the New...
.Select a target platform where your Solution will be installed and click Next.
Click Create New Solution to finish.
Wizard Step 1: Target Platform selection
When creating a new Solution, you will need to select a target platform.
A Target Platform is where you intend to deploy your Solution for execution in production. Here are the options, with guidance for selection:
Windows: Use this option if Windows Authentication is required or if Canary Historian or any other product or library that requires Windows will be used in the same computer.
Multi-Platform: This solution will execute in any device compatible with .NET Framework 4.8.
Wizard Step 2: Selecting the FrameworX Product
Tatsoft's FrameworX technology powers 3 products option:
button at the top of the solution list to start the New Solution Wizard.
Wizard Step 1 - Product Features
Define the Product Series for your solution by selecting the product family and the product model.
The software platform technology powers four product options:
- Unlimited: Unlimited tags, unlimited users, unlimited communication points, and all platform features.
- FactoryStudio: Scalable models based on the number of
- communication points, enabling SCADA, MES,
- Advanced HMI, and a wide range of industrial applications.
- EdgeMachine:
- Scalable models
- based on the number of communication points, with
- a subset of features typically
- required for HMI on machines and embedded devices.
- EdgeConnect:
- Scalable models based on the
- data connections
For details about product families and licensing models, see the Product Series page.
You can keep the selection of product as FrameworX, when creating Solutions for Unlimited communication points, and Unlimited users.
According the selecting or the product, the various options of communications are presented.
| Info | ||
|---|---|---|
| ||
FrameworX configuration Solution Configuration tools are available free or chargedof charge, but you require a license is required to put deploy your Solution solution in a production on the fieldenvironment. The Product Family and Model (number of points) selected when create creating a new Solution, solution should reflect the intended license you plan to be acquired acquire for production installation. You still can change those settings after creating the Solutionsolution, at in the Solution Designer tool , under Solution Settings. |
Wizard Step
3: Customizing Solution Name and other options2 - Platform
Platform |
|---|
New Solution Wizard
Description |
|---|
Name
Enter a name for the Solution.
Description
(Optional) Enter a description of the Solution.
Location and new folder check box
| Note |
|---|
Remote access is configured by a Solution's folder. You can select where the Solution is created. Be sure to place local Solutions in their own folder. Do not add them to the same folder that has Solutions with remote access. |
Depending on your license, this setting may give you options to build applications for a specific product model. The product model is connected with the number of real-time communication points you are allowed on that Solution.
Sets how many tags will be stored on Canary Historian
Selects a Solution template, which a pre-created Solution with some displays and functionality. See Solution Templates for more information. This is a optional step, you may also start with a blank solution.
About the Folder Structure for Solutions
FrameworX Solutions are created in a way that is possible to have multiple Solutions in one folder.
Each Solution file, TPROJ, has all the configuration of the Solution, and some files that are dynamically created, such as retentive tag databases, or user UI settings, they carry the name of the Solution.
Therefore when create multiple simple Solutions, typically for tests and demos, it is easier to keep in the same folder. But, when created larger applications, or Solution for formal field deployment it's a good procedure to do in a new folder.r
Canary Historian:
FrameworX applications bring the benefit to allow, at no extra cost, the usage up to 500 historian points, using the Canary Historian tools. You can upgrade to a higher tag counting.
When using that feature, even for the built-in 500 points, it's necessary to add the Canary license. See Canary Integration for more information.
The View button opens a ready-only version of the Solution configuration, which is very useful if you just want to put the Solution in execution or check its configuration.
The Edit button enables modifications in the Solution. You may need to use the Logon button in the toolbar before editing if the Security Solutions were enabled to that Solution.
Many Solutions can be opened at the same time. When a second instance of the same Solution is opened, the second instance will open as read-only.
To enable concurrent users, your Solution server must be licensed for multiple engineers. See Licensing and activating for more information.
Steps to open am existing Solution.
Start Solution.exe: Run the Solutions application, using the Solution.exe command line, or desktop icon.
Select Local or Remote computers: By default, the system will show the Solutions from the last location, or from your local computer on the first. You can modify the list of Solution, going the Solution Server page.
For remote computers, you can use the Web UI: If the remote computer has Web Server enabled, and you are in Windows computer, you can start see the Solutions of remote computer with the URL: <<<<<<<<<<I
Select the desired Solution at the List: you can use the search box or modify the options for visualization. When using Tables, you can sort by columns clicking in the tiles, or right click to switch column visibility.
| Info | ||
|---|---|---|
| ||
If the Solution file is locked, or there is another local instance of the Solution open, the Solution will open in Read-Only View mode. In that mode is still possible to Run or Export configuration, but no to edit. |
Running Solutions
You can run a Solution by:
- Using the Run button in Solution Management.
- Starting the execution manually after you open the Solution for editing (Execute → Startup → Run Startup).
| Info |
|---|
| For more information, see Runtime. |
Upgrading Solutions
Solutions retain information about the platform's version used to create the Solution.
Opening a Solution with a previous version without upgrading it will require a platform's equivalent version installed.
Also, you can upgrade the Solution to the latest version using the Upgrade Version command button.
When Upgrading:
- A copy of the Solution is executed, creating a new file named: <Solution-name>-<preivous-vesion>.tproj.
- A new empty Solution is created named <Solution-name>.tproj.
- The Previous Solution is imported to the new Solution.
After upgrading, it is recommended to open the new Solution and build it (Execute → Build and Publish → Build... operation), so the system checks all its scripts.
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. |
Wizard Step 3 - Solution Name and template
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.
| Anchor | ||||
|---|---|---|---|---|
|
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
Solution templates can be a great way to speed up the development process by providing pre-configured settings and modules. Templates can be customized to fit your specific needs, and can be a useful starting point for building your application. When selecting a template, consider the functionality you need and the type of application you are building. Examples of different templates available include web applications, mobile apps, and desktop applications.
Pre-built Solution templates get you started faster by building the solutions you need. Some Solution templates are available when you install the software, such as Blank, Default, TrendChart, TrendChart with Alarm Pages and Alarm Footer, Redundancy Solutions, and Asset Viewer.
Template
Blank
Default
TrendChart
TrendChart and Alarm
TrendChart and Alarm Footer
Redundancy
Log on dialog
Several themes
Header page navigation using Industrial Icons
Empty main page
Layout with Header and Main page
Server Information page using the Dashboard display
System information template and Scripts
System Information Data Historian configuration
UI data template
TrendChart display
TrendChart data templates
Alarm Online display
Alarm Historical display
Alarm data template
Alarm Footer display
Redundancy Information display
Select and run a template to check the displays available on each template, and explore its settings. By that, you can check if one of the templates meet your needs and speed up your Solution development.
In addition, you can add or create more templates on your own.
Adding New Templates
The templates presented available when creating a new Solution solution are standard Solution solution files located in the product installation folder in user's Documents folder under Templates.
If you receive To use a new template received from your a vendor or integratorsintegrator, simply copy it to that Solution.To add a new template, create a Solution and save it in the Template folder on the installation directory, such as the following sample path: "C:\Program Files\...\Product\Version\Templates"
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.
Solution Creator Tool
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 page.
In this section:
| Page Tree | ||
|---|---|---|
|
Designing a New Solution
The platform uses multi-user and multi-project organization to edit and run multiple projects simultaneously. All modules are combined in a simple unified user interface: the Solution Designer.
Change project settings using the Solution Designer, an integrated and user-friendly environment that performs all setup and test tasks, from tag definition and communications to drawing user interface displays.
| Info | ||
|---|---|---|
| ||
Check Solution Designer for tips about common configurations and overall information about its settings. |
In this section...
| Page Tree | ||||
|---|---|---|---|---|
|