This reference provides detailed technical documentation for creating new solutions, including the New Solution Wizard, templates, and the Solution Creator automation tool.
Related Topics:
Method | Action | Result |
---|---|---|
Solution Center | Click New button | Wizard opens |
Keyboard | Ctrl+N | Wizard opens |
File Menu | File → New Solution | Wizard opens |
Family | Description | Target Use | License Limits |
---|---|---|---|
Unlimited | Full platform capabilities | Enterprise systems | No limits |
FactoryStudio | SCADA/MES/HMI applications | Industrial automation | By points |
EdgeMachine | Machine-level HMI | OEM equipment | By points |
EdgeConnect | Data gateway | IoT connectivity | By connections |
Model | Communication Points | Typical Application |
---|---|---|
150 | Up to 150 | Small machines |
300 | Up to 300 | Production cells |
500 | Up to 500 | Small processes |
1500 | Up to 1,500 | Medium systems |
5000 | Up to 5,000 | Large systems |
Unlimited | No limit | Enterprise |
Feature | Unlimited | FactoryStudio | EdgeMachine | EdgeConnect |
---|---|---|---|---|
Tags | Unlimited | By model | By model | Limited |
Displays | Unlimited | Unlimited | Limited | None |
Scripts | Yes | Yes | Limited | Basic |
Historian | Yes | Yes | Optional | Data only |
Reports | Yes | Yes | No | No |
Redundancy | Yes | Yes | No | No |
Platform | Operating Systems | Requirements | Components |
---|---|---|---|
Windows | Windows 10/11, Server 2016+ | .NET Framework 4.8 | Full features |
Multi-Platform | Windows, Linux, Docker | .NET 8 Runtime | Cross-platform subset |
Feature | Windows | Multi-Platform |
---|---|---|
Windows Authentication | ? | ? |
Active Directory | ? | ? |
Canary Historian | ? | ? |
OSIsoft PI | ? | ? |
OPC Classic | ? | ? |
.NET 8 Scripts | ? | ? |
Linux Deployment | ? | ? |
Docker Support | ? | ? |
Field | Description | Requirements | Default |
---|---|---|---|
Solution Name | Unique identifier | Alphanumeric, no spaces | Required |
Location | Save directory | Write permissions | Documents\Solutions |
Create Folder | Separate directory | Recommended | Checked |
Template | Starting configuration | Select from list | HeaderLayout |
Description | Solution purpose | Optional | Empty |
Valid | Invalid | Reason |
---|---|---|
TankFarm2024 | Tank Farm 2024 | No spaces |
Plant_Monitor | Plant-Monitor | Underscore preferred |
LineA_v2 | Line#A | No special characters |
OEE_System | 123System | Must start with letter |
Template | Description | Includes | Best For |
---|---|---|---|
Blank | Empty solution | Basic structure only | Custom projects |
HeaderLayout | Standard navigation | Header, menu, pages | Most applications |
ISA101 | High-performance HMI | ISA graphics standards | Process control |
TabLayout | Tabbed interface | Tab navigation | Multi-area systems |
MobileFirst | Responsive design | Touch-optimized | Mobile/tablet |
OEE_Dashboard | Production metrics | KPI calculations, reports | Manufacturing |
Tank_Farm | Storage monitoring | Level displays, trends | Liquid storage |
Building_Automation | BMS template | HVAC, lighting, access | Facilities |
Each template includes:
Component | Blank | HeaderLayout | ISA101 | OEE |
---|---|---|---|---|
Main Display | ? | ? | ? | ? |
Navigation | ? | ? | ? | ? |
Sample Tags | ? | ? | ? | ? |
Scripts | ? | ? | ? | ? |
Reports | ? | ? | ? | ? |
Symbols | ? | Basic | ISA | Production |
Type | Path | Editable |
---|---|---|
System Templates | Program Files\FrameworX\Templates | No |
User Templates | Documents\FrameworX\Templates | Yes |
Shared Templates | Network\SharedTemplates | By permission |
Action | Method | Result |
---|---|---|
Add | Copy .dbsln to Templates folder | Available in wizard |
Remove | Delete from Templates folder | Not shown in wizard |
Update | Replace .dbsln file | Uses new version |
Share | Copy to network location | Team access |
Automated solution creation from CSV files and command line parameters.
Location: <install_path>\fx-10\SolutionCreator.exe
Field | Description | Required | Default |
---|---|---|---|
Solution Name | New solution identifier | Yes | None |
Output Location | Save directory | Yes | Current |
New Folder | Create subdirectory | No | Checked |
Product | License family/model | Yes | FactoryStudio |
Platform | Windows/Multi-platform | Yes | Windows |
Merge CSV Files | Import data | No | Unchecked |
Template | Base template | No | Blank |
File names must match exactly:
File Name | Content | Required |
---|---|---|
UnsTags.csv | Tag definitions | No |
DevicesChannels.csv | Communication channels | No |
DevicesNodes.csv | Device nodes | No |
DevicesPoints.csv | Device points | No |
DevicesAccessTypes.csv | Access type definitions | No |
UnsTagProviders.csv | External tag providers | No |
Standard format matching Designer export:
csv
Name,Type,Description,InitialValue,Min,Max
Tank1_Level,Double,"Tank 1 Level",0,0,100
Tank1_Temp,Double,"Tank 1 Temperature",20,0,150
Files can include solution prefix:
Solution2_UnsTags.csv
Solution2_DevicesChannels.csv
batch
SolutionCreator.exe /parameter:value [/parameter:value...]
Parameter | Description | Example |
---|---|---|
/solutionName: | Solution name | /solutionName:Plant1 |
/outputFileLocation: | Save path | /outputFileLocation:C:\Solutions |
/newFolder: | Create folder | /newFolder:true |
/platform: | Target platform | /platform:Multiplatform |
/productFamily: | License family | /productFamily:FactoryStudio |
/productModel: | Point limit | /productModel:1500 |
/MergeCsvFiles: | Import CSVs | /MergeCsvFiles:true |
/pathCSVFiles: | CSV folder | /pathCSVFiles:C:\Data |
/templateName: | Base template | /templateName:HeaderLayout |
/logfile: | Log output | /logfile:C:\Logs\create.log |
batch
@echo off
CD "C:\Program Files (x86)\Tatsoft\FrameworX\fx-10"
REM Create multiple edge solutions
FOR %%i IN (1 2 3 4 5) DO (
SolutionCreator.exe ^
/solutionName:Edge%%i ^
/outputFileLocation:C:\EdgeSolutions ^
/newFolder:true ^
/platform:Multiplatform ^
/productFamily:EdgeMachine ^
/productModel:300 ^
/MergeCsvFiles:true ^
/pathCSVFiles:C:\Templates\Edge%%i ^
/templateName:blank ^
/logfile:C:\Logs\Edge%%i.log
)
Action | Automatic | Manual Required |
---|---|---|
Solution created | ? | |
Designer opens | ? | |
License check | ? | |
Template applied | ? | |
Initial save | ? | |
Configure modules | ? |
Problem | Cause | Solution |
---|---|---|
Wizard won't start | No license | Use evaluation mode |
Can't select template | Templates folder empty | Reinstall or add templates |
Name rejected | Invalid characters | Use alphanumeric only |
Location denied | No permissions | Choose different folder |
Template missing | File deleted | Restore from backup |
Problem | Cause | Solution |
---|---|---|
Files not recognized | Wrong names | Match exact names |
Import fails | Format error | Check CSV structure |
Partial import | Missing columns | Verify headers |
Encoding issues | UTF-8 required | Save as UTF-8 |
This tool helps you quickly create solutions from spreadsheet files. The executable can be found in the following directory:
"<productPath>\fx-10\SolutionCreator.exe".
On this page:
Table of Contents | ||||||
---|---|---|---|---|---|---|
|
Property | Description |
---|---|
Solution Name | Choose the name of you solution. |
Output File Location | Choose in what path the solution will be created, if “New Folder” is checked it will create one folder to add your solution in. |
Product | Choose in what license the solution will be created. |
Platform | Define the target platform for your solution by selecting Windows or Multi-platform. |
Merge CSV Files | It enables to import the CSV files. If unchecked, it won't import anything from the files. |
Templates | Pre-built solution templates help you get started quickly. |
You can find additional details for most of the fields mentioned above in this page: Creating Solutions (Reference)
To import data from spreadsheets, enable "Merge CSV Files" and select the folder containing the files.
The spreadsheets must have exactly these names (not all are required, but existing ones must match):
The CSV file names and formats are equivalent when exporting tables in Designer. The CSV file name can optionally start with new solution name. Ex: Solution2_UnsTags.csv
You can download all spreadsheet templates above by exporting your existing solution or creating a new one. To export the spreadsheets, open your solution and click "Export Document" on the Top Main Toolbar. This will generate a .csv file that can be imported using this Solution Creator. You can find information about the Top Main Toolbar in: Designer (IDE Overview).
You have the option to don’t use the user interface to create the projects, follow how to use it:
1 - Create a .bat file with the content from step 2
2 - Content:
CD "<ProductPath>\fx-10" "<ProductPath>\fx-10\SolutionCreator.exe" /logfile:"<logPath>\outputLog.log" /outputFileLocation:"<outputPath>" /solutionName:<projectName> /newFolder:<bool> /platform:<platform> /productFamily:<productFamily> /productModel:<productModel> /MergeCsvFiles:<bool> /pathCSVFiles:"<spreadsheetsPath>" /templateName:<projectTemplate>
Example tested and working:
CD "C:\Program Files (x86)\Tatsoft\00 - v10\FrameworX\fx-10" "C:\Program Files (x86)\Tatsoft\00 - v10\FrameworX\fx-10\SolutionCreator.exe" /logfile:"C:\Users\eduar\Downloads\log1.log" /outputFileLocation:"C:\Users\eduar\Downloads" /solutionName:test1 /newFolder:true /platform:Multiplatform /productFamily:EdgeGateway /productModel:_1500_tags /MergeCsvFiles:true /pathCSVFiles:"C:\Users\eduar\Documents\03 - Tatsoft\05 - SolutionCreatorSpreadSheet\Folder1" /templateName:blank
where:
Parameter | Description |
---|---|
/logfile | Specifies the path where the execution log file will be saved. Errors and success will be shown there |
/outputFileLocation | Defines the directory where the generated solution files will be saved |
/solutionName | Sets the name of the solution being created |
/newFolder | Indicates whether a new folder should be created for the solution |
/platform | Specifies the target platform for the solution |
/productFamily | Defines the product family used in the solution |
/productModel | Specifies the product model used in the solution |
/MergeCsvFiles | Determines if the CSV will be imported |
/pathCSVFiles | Specifies the path to the CSV files used for creating the solution |
/templateName | Sets the template that will be used to create the solution |
In this section:
Page Tree | ||||
---|---|---|---|---|
|
...