Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Use the guided tool to build new solutions.

Reference  Solution   Solution Center → Creating → Creator


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

Solution Creator (Reference): 

Automated solution creation from CSV files and command line

parameters

.

Location: <install_path>\

fx-10\

SolutionCreator.exe

Table of Contents
maxLevel2
minLevel2
indent10px
excludeSteps
stylenone


Solution Creator User Interface

FieldDescriptionRequiredDefault
Solution NameNew solution identifierYesNone
Output LocationSave directoryYesCurrent
New FolderCreate subdirectoryNoChecked
ProductLicense family/modelYes
FactoryStudio
FrameworX
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 points
NoDevicesAccessTypes.csvAccess type definitionsNoUnsTagProviders.csvExternal tag providers
No

CSV Format Example

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
    FrameworX
    /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:EdgeMachineEdgeHMI ^
            /productModel:300 ^
            /MergeCsvFiles:true ^
            /pathCSVFiles:C:\Templates\Edge%%i ^
            /templateName:blank ^
            /logfile:C:\Logs\Edge%%i.log
    )

    Post-Creation

    After Wizard Completion

    ActionAutomaticManual RequiredSolution 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 missing
    File 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

  • Solution Center (Reference) - Main interface
  • Managing Solutions (Reference) - Runtime management
  • Solution Templates Guide - Template details
  • Batch Automation Guide - Scripting solutions


  • In this section

    :

    ...

    Page Tree
    V10
    rootV10:@parentspaces