This reference provides comprehensive technical documentation for the Solution Center interface, the primary entry point for managing FrameworX solutions.
Related Topics:
- Solution Center (Concept) - Understanding the workspace
- Managing Solutions (How-to) - Step-by-step procedures
- Solution Lifecycle - Development workflow
Interface Overview
Main Window Layout
FrameworX Solution Center  | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
Navigation Panel
| Selected Solution: <solution name>
| |||||||||
| Tatsoft | << (panel collapse) | Status Bar - Connected: Local | |||||||||
Access Methods
| Method | Entry Point | Features Available |
|---|---|---|
| Desktop Application | FrameworX.exe | Full functionality |
| Web Browser | http://server:10108/solutions | Limited editing* |
| Remote Desktop | Via Solution Server | Based on permissions |
*Note: Web access has different features available - documentation pending for advanced web-specific settings.
Action Buttons
Located above the solution list:
| Button | Function | Availability | Shortcut |
|---|---|---|---|
| New | Create new solution | Always | Ctrl+N |
| Edit | Open in Designer | Solution selected | Ctrl+E |
| View | Open read-only | Solution selected | Ctrl+R |
| Run | Start runtime | Solution selected | F5 |
| Manage | Advanced options | Solution selected | Ctrl+M |
| Refresh | Reload list | Always | F5 |
Quick Actions
- Double-click solution: Opens in Designer
- Right-click solution: Context menu with all actions
Solution List
Display Modes
| View Mode | Description | Best Use Case |
|---|---|---|
| Card View | Thumbnail previews with solution name | Visual identification |
| List View | Compact text list with status icons | Many solutions |
| Table View | Detailed grid with all properties | Comparing solutions |
Solution Item Properties
| Property | Description | Visual Indicator |
|---|---|---|
| Name | Solution identifier | Text label |
| Preview | MainPage display thumbnail | Card image |
| Status | Running/Stopped/Editing | Icon overlay |
| Modified | Last change timestamp | Table column |
| Size | Database file size | Table column |
| Version | Solution version | Properties panel |
Status Indicators
| Status | Description |
|---|---|
| Running | Solution executing |
| Editing | Open in Designer |
| Read-only | Published version |
| Legacy | FactoryStudio project |
Navigation Panel
Sections
| Section | Purpose | Details Page |
|---|---|---|
| Server | Solution location settings | Server Information |
| License | License status and activation | Licensing and Activation |
| Product | Version and components | This page |
Product Information
| Field | Description | Example |
|---|---|---|
| Version | Software version | 10.2.0 |
| Build | Build number | 10.2.0.1234 |
| Platform | Operating system | Windows 11 |
| Drivers | Installed protocols | 75 drivers |
Solution Files
File Types
| Extension | Type | Description | Can Edit |
|---|---|---|---|
| .dbsln | Solution | Active configuration | Yes |
| .dbback | Backup | Archived solution | Import only |
| .dbrun | Published | Production version | No |
| .tproj | Legacy | Version 9.x format | Upgrade only |
File Locations
| Type | Default Path | Configurable |
|---|---|---|
| Solutions | Documents\FrameworX\Solutions | Yes |
| Templates | Documents\FrameworX\Templates | Yes |
| Backups | Documents\FrameworX\Backups | Yes |
| Temp Files | %TEMP%\FrameworX | No |
File Operations (To Do: Modify to explain to do at the file direction
| Operation | Description |
|---|---|
| Open | Load existing solution |
| Import | Restore from backup |
| Export | Create backup |
| Clone | Duplicate solution |
| Delete | Remove solution |
Search and Filter
Search Box
Located top-right of solution list:
| Search Type | Syntax | Example |
|---|---|---|
| Name | Text string | "Tank" |
| Status | :running :stopped | :running |
| Modified | >date <date | >2024-01-01 |
| Size | >size <size | >10MB |
Keyboard Shortcuts
Global
| Shortcut | Action |
|---|---|
| Ctrl+N | New solution |
| Ctrl+O | Open solution |
| F5 | Refresh list |
| F1 | Help |
| Alt+F4 | Exit |
With Solution Selected
| Shortcut | Action |
|---|---|
| Enter | Edit solution |
| Ctrl+E | Edit solution |
| Ctrl+R | View read-only |
| Ctrl+Enter | Run solution |
| Delete | Remove from list |
Common Tasks Reference
| Task | Steps | Notes |
|---|---|---|
| Create solution | New → Select template → Configure | See Creating Solutions |
| Open for editing | Select → Edit | Requires dev license |
| Start runtime | Select → Run or Manage | See Managing Solutions |
| Connect remote | Server → Enter IP | See Server Information |
| Check license | License panel | See Licensing |
Troubleshooting
Solution List Issues
| Problem | Cause | Solution |
|---|---|---|
| Empty list | Wrong folder | Check Server settings |
| Missing solution | Not in search path | Add folder path |
| Can't see preview | No MainPage display | Normal for some solutions |
| Refresh not working | File locked | Close Designer/Runtime |
Access Issues
| Problem | Cause | Solution |
|---|---|---|
| Can't edit | No dev license | Check license type |
| Can't run | No runtime license | Verify license |
| Remote fails | TWebServices stopped | Start service |
| Web access denied | Access key required | Add ?accesskey=xxx |
See Also
Child Pages:
- Creating Solutions - New solution wizard and templates
- Managing Solutions - Runtime and diagnostic tools
- Server Information - Local and remote configuration
- Licensing and Activation - License management
Related Topics:
- Designer (Reference) - Configuration workspace
- Runtime (Reference) - Execution environment
- Multi-User Collaboration - Team development
Introduction to the Solutions Manager
The platform is designed for creating real-time data applications, structured into solutions. A solution includes configurations for various functional modules, such as tag definitions, alarms, communication, and displays.
The Solutions Manager is the central hub for organizing and managing your solutions. It enables you to create, open, and edit solutions from your computer or remote devices, facilitating efficient workflow and productivity.
On this page:
| Table of Contents | ||||||
|---|---|---|---|---|---|---|
|
Key Concepts and Terms
Solution File / Solution Name
The configuration of an application (solution) is saved is a file with extension .dbSln. All modules settings are stored in that file. The solution name matches the name of the configuration file.
Project File
In order to facilitate distinction from legacy product versions, the Project File refers to files with the extension .tProj, a legacy configuration.
The Solutions Manager interface is the main hub for managing and organizing your solutions.
Some very unique and powerful features include:
The platform creates a file for each solution. All configurations, including tag definitions, display drawings, images, and report templates, are stored in a single file—an encrypted SQL database with the extension
.dbsln— for easy management.You can open multiple solutions simultaneously or allow multiple engineers to work on each solution.
You can access solution files located on your computer or on remote devices with the Platform Services enabled. When accessing remote devices, you can use a pure HTML5 interface without needing any local installation.
To enable multiple users to work concurrently on the same solution, follow the procedure described in the section Multi-User Collaboration.
Navigating the User Interface
The User Interface is composed by the following sections:
- The right side contains help-only information; you can close that section if you wish.
- The middle box, called the Solution List, displays a list of solutions on your computer or on a previously set remote computer.
- The left side provides summary information and navigation for additional content. It includes:
- Server Information Page: Select folders, view, and manage connected servers (or local computers).
- Licensing And Activation: See and modify the license on the connected server (or local computer).
- Product Information: Displays the current version and list of installed drivers.
Selecting a Solution
The main area in the Solution Manager is where you can select a solution and execute commands on the selected solution or create a new solution.
The middle box, called the Solution List, shows a list of solutions on your computer or on a previously set remote computer. Click "Refresh" to update the solutions list in case external applications or users modify the contents of the folders.
Each item in the solution list represents a complete configuration for an application, with each image corresponding to an independent solution. The image used for the solution preview is the content of the display named "MainPage" in that solution.
In the top right corner, you can select List, Cards, or Table view.
List View
Card View
Table View
Working with Solutions
The buttons on the top of Solutions List allow to manage the select solution or create a new one.
New: go to Creating a New Solution
Edit: Open the Designer software, to configure the selected solution
View: Open the Designer software, in Read-Only mode, which is useful if you simply want to check its configuration.
Run: Starts the execution of the selected solution. It will start in Production mode using guest credentials. For more options on starting, you can use the Manage Button.
Manage: navigates to the Managing Solutions page, allowing to perform various actions with the selected solution.
Solution Configuration File
The configuration for the entire solution, is stored in single file with the extension .dbsln. That file is an encrypted embedded SQL database, with the configuration tables of the various modules, like Tags, Alarms, Scripts and Displays.
You can move, rename, duplicate, back up, and restore the solution files, working directly in the computer folders, just as you would with any other file. When moving files directly in the computer folders, you need to press the "Refresh" button to update the list content.
Other files extension for Solutions are created, when using the Publish feature, as described in the chapter Runtime Build and Publish.
| Warning | ||
|---|---|---|
| ||
Be extremely careful when renaming solution files (or solution names). There are macros and properties with the solution name that may have been used to create database files, configuration files, or other application-specific implementations. When renaming a solution that is already in production, it is necessary to address any specific configurations or external connections that might have been created using that specific name. If you want to Delete a Solution, you just need to Delete the <solutionName>.dbsln file that count as the solution. The folder named <solutionName>-Designer contains users settings and temporary files and it can be deleted anytime. When the solution runs, it may create databases files, text files, that are application-specific implementation, and those files should be traced and deleted, similarly when you are renaming solutions. |
Upgrade from Legacy Projects
When a file with the extension .tProj is found, it appears in the Solution List with the prefix "Project." Only projects from versions 9.1 and 9.2 can be upgraded directly. For older project files, you must first use the 9.1 or 9.2 product to upgrade them to those versions.
When a legacy project is selected, the "Upgrade Version" command button is enabled.
| Info | ||
|---|---|---|
| ||
In order to Edit a legacy project, you need to use the tools for the specific version of that Project. The Solutions Manager will only handle upgrades for that project to the current solution features. |
For further details on the Upgrade process to the page Migrating Legacy Projects.
Accessing Solutions Files
By default, the system will display solutions from your local computer first. You can modify the list of visible solutions by going to the Solution Server page. At that page, you can select to show the solution files from the Local Computer for from a Computer running the TWebServices communication service.
When using Collaborative Engineering, allowing other uses to access the same solution, use the Solution Server connection. The Direct Access to the Solution locks the file to a single user.
For Solution Server access: The target server must have the TWebServices running. You can connect using the desktop version of the Solutions Manager, or the Web UI using a URL.
Requirements
The Solutions Manager can access configuration files from other computers and devices through two methods: connecting to a Remote Server via Server Information or using a URL to open an interface.
Both methods require that the connected server has TWebServices running and that the necessary firewall ports are open. On Windows computers, you can set up TWebServices by opening a local instance of the Solutions Manager on the target server and configuring TWebServices on the Server Information page. For Linux and other operating systems, you need to configure TWebServices to run on startup using the OS's tools. By default, TWebServices uses port 10108.
When multiple users open the same solution from the Server, it allows Multi-User Collaboration on the solution development.
Connecting to a Solution Server
On the Server Information page, simply enter the IP address or domain name of the server you want to connect to and press the Connect button.
→ Read more about the Server Information page.
Using the Solution Manager Web UI
It is possible to access solutions on a remote server without installing the product on your local computer.
Just open browser and use the url: http://<Server IP or Name>:10108/solutions. Example: http://192.169.1.1:10108/solutions
The requirements are that the remote device has TWebServices running. If the device has a security AccessKey defined, the URL shall be:
http://<ServerIPorName>:10108/solutions?accesskey=<key>
Using the Designer in Click-Once Mode
When you are using the Solutions Manager WebUI and open a solution for editing, it is not necessary to have the Designer pre-installed on your computer. The system will use ClickOnce technology (if supported by the browser) to open a Designer window, retrieving the necessary files from the remote computer. Most common browsers allow ClickOnce; check the browser's technical information to confirm ClickOnce compatibility.In this section:
| Page Tree | ||||
|---|---|---|---|---|
|
...