This reference provides detailed technical documentation for creating new solutions, including the New Solution Wizard, templates, and the Solution Creator automation tool.

Related Topics:


New Solution Wizard

Accessing the Wizard

MethodActionResult
Solution CenterClick New buttonWizard opens
KeyboardCtrl+NWizard opens
File MenuFile → New SolutionWizard opens

Wizard Step 1: Product Features

Product Family Selection

FamilyDescriptionTarget UseLicense Limits
UnlimitedFull platform capabilitiesEnterprise systemsNo limits
FactoryStudioSCADA/MES/HMI applicationsIndustrial automationBy points
EdgeMachineMachine-level HMIOEM equipmentBy points
EdgeConnectData gatewayIoT connectivityBy connections

Product Model Options

ModelCommunication PointsTypical Application
150Up to 150Small machines
300Up to 300Production cells
500Up to 500Small processes
1500Up to 1,500Medium systems
5000Up to 5,000Large systems
UnlimitedNo limitEnterprise

Feature Comparison

FeatureUnlimitedFactoryStudioEdgeMachineEdgeConnect
TagsUnlimitedBy modelBy modelLimited
DisplaysUnlimitedUnlimitedLimitedNone
ScriptsYesYesLimitedBasic
HistorianYesYesOptionalData only
ReportsYesYesNoNo
RedundancyYesYesNoNo

Wizard Step 2: Platform

Platform Selection

PlatformOperating SystemsRequirementsComponents
WindowsWindows 10/11, Server 2016+.NET Framework 4.8Full features
Multi-PlatformWindows, Linux, Docker.NET 8 RuntimeCross-platform subset

Platform-Specific Features

FeatureWindowsMulti-Platform
Windows Authentication??
Active Directory??
Canary Historian??
OSIsoft PI??
OPC Classic??
.NET 8 Scripts??
Linux Deployment??
Docker Support??

Wizard Step 3: Solution Details

Configuration Fields

FieldDescriptionRequirementsDefault
Solution NameUnique identifierAlphanumeric, no spacesRequired
LocationSave directoryWrite permissionsDocuments\Solutions
Create FolderSeparate directoryRecommendedChecked
TemplateStarting configurationSelect from listHeaderLayout
DescriptionSolution purposeOptionalEmpty

Naming Conventions

ValidInvalidReason
TankFarm2024Tank Farm 2024No spaces
Plant_MonitorPlant-MonitorUnderscore preferred
LineA_v2Line#ANo special characters
OEE_System123SystemMust start with letter

Solution Templates

Built-in Templates

TemplateDescriptionIncludesBest For
BlankEmpty solutionBasic structure onlyCustom projects
HeaderLayoutStandard navigationHeader, menu, pagesMost applications
ISA101High-performance HMIISA graphics standardsProcess control
TabLayoutTabbed interfaceTab navigationMulti-area systems
MobileFirstResponsive designTouch-optimizedMobile/tablet
OEE_DashboardProduction metricsKPI calculations, reportsManufacturing
Tank_FarmStorage monitoringLevel displays, trendsLiquid storage
Building_AutomationBMS templateHVAC, lighting, accessFacilities

Template Contents

Each template includes:

ComponentBlankHeaderLayoutISA101OEE
Main Display????
Navigation????
Sample Tags????
Scripts????
Reports????
Symbols?BasicISAProduction

Custom Templates

Creating Templates

  1. Design Solution - Build complete solution
  2. Save As Template - File → Save as Template
  3. Store Location - Documents\FrameworX\Templates
  4. Available Next Time - Appears in wizard

Template Location

TypePathEditable
System TemplatesProgram Files\FrameworX\TemplatesNo
User TemplatesDocuments\FrameworX\TemplatesYes
Shared TemplatesNetwork\SharedTemplatesBy permission

Template Management

ActionMethodResult
AddCopy .dbsln to Templates folderAvailable in wizard
RemoveDelete from Templates folderNot shown in wizard
UpdateReplace .dbsln fileUses new version
ShareCopy to network locationTeam access

Solution Creator Tool

Overview

Automated solution creation from CSV files and command line parameters.

Location: <install_path>\fx-10\SolutionCreator.exe

User Interface

FieldDescriptionRequiredDefault
Solution NameNew solution identifierYesNone
Output LocationSave directoryYesCurrent
New FolderCreate subdirectoryNoChecked
ProductLicense family/modelYesFactoryStudio
PlatformWindows/Multi-platformYesWindows
Merge CSV FilesImport dataNoUnchecked
TemplateBase templateNoBlank

CSV Import

Supported Files

File names must match exactly:

File NameContentRequired
UnsTags.csvTag definitionsNo
DevicesChannels.csvCommunication channelsNo
DevicesNodes.csvDevice nodesNo
DevicesPoints.csvDevice pointsNo
DevicesAccessTypes.csvAccess type definitionsNo
UnsTagProviders.csvExternal tag providersNo

CSV Format

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

Alternative Naming

Files can include solution prefix:

  • Solution2_UnsTags.csv
  • Solution2_DevicesChannels.csv

Batch Automation

Command Line Syntax

batch

SolutionCreator.exe /parameter:value [/parameter:value...]

Parameters

ParameterDescriptionExample
/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 File Example

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
)

Post-Creation

After Wizard Completion

ActionAutomaticManual Required
Solution created?
Designer opens?
License check?
Template applied?
Initial save
?
Configure modules
?

Next Steps

  1. Configure Tags - Define data model
  2. Setup Devices - Connect to equipment
  3. Create Displays - Design user interface
  4. Add Logic - Scripts and calculations
  5. Test - Verify functionality
  6. Deploy - Move to production

Troubleshooting

Creation Issues

ProblemCauseSolution
Wizard won't startNo licenseUse evaluation mode
Can't select templateTemplates folder emptyReinstall or add templates
Name rejectedInvalid charactersUse alphanumeric only
Location deniedNo permissionsChoose different folder
Template missingFile deletedRestore from backup

CSV Import Issues

ProblemCauseSolution
Files not recognizedWrong namesMatch exact names
Import failsFormat errorCheck CSV structure
Partial importMissing columnsVerify headers
Encoding issuesUTF-8 requiredSave as UTF-8

See Also



In this section: