| HTML |
|---|
<style>
.text-span-6 {
background-image: linear-gradient(99deg, rgba(170, 163, 239, .5), rgba(125, 203, 207, .5));
border-radius: 50px;
padding-left: 15px;
padding-right: 15px;
}
#title-text {
display: none;
}
.panelgradient {
background-image: linear-gradient(180deg, #d5def0, whitesmoke);
border-radius: 8px;
flex-direction: column;
justify-content: center;
align-items: center;
padding: 4rem;
display: flex;
position: relative;
}
</style>
<div class ="panelgradient">
<h1 style="text-align: center;">Solutions Manager</h1>
</div> |
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.
Introduction to Solution manager
Framework is a powerful platform for developing and delivering applications that handle real-time data. Applications created using this platform are structured into Solutions.
A Solution encompasses the configuration for different functional Modules, which can include Tag definitions, Alarms, Communication, Displays, and more.
The tool utilized for selecting and opening a Solution is known as Solutions Management.
By using the Solutions Management interface, you can easily organize your various FactoryStudio Solutions, from local your local computer or remote devices, to streamline your workflow and increase 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 with legacy product versions, Project File, refer to files with extension .tProj, a legacy configuration.
| Anchor | ||||
|---|---|---|---|---|
|
The Solutions Manager interface is the main hub for managing and organizing your FactoryStudio Solutions. From this interface, you can create new Solutions, edit existing ones, and and run Solutions located in your computer or remote ones.solutions.
Some very unique and powerful features about Solution management tools include:
This interface is product version agnostic. You can manage and open Solutions created with different product versions without upgrading the Solution in the field or switching the engineering tool in your computer.The platform creates a file for each
Solutionsolution. All
configurationconfigurations, including tag
definitiondefinitions,
displays drawingdisplay drawings, images, and report templates
is, are stored in a single
file — anfile—an encrypted SQL database with the extension
tproj — for.dbsln—for easy management.You can open multiple
Solutions at the same timesolutions simultaneously or allow multiple engineers to work on each
Solution.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
In order toenable multiple users to work concurrently on the same
Solutionsolution, follow the procedure described
atin the
sectionsection Multi-
user
Solution Management | ||
|---|---|---|
Field | Type | Description |
Your license | Dynamic text box | Displays the license information. |
License Management | Shortcut | Click to go to the License Management page. |
Find Solutions | Dynamic text box | Displays the Solution Server information. |
Solution Server | Shortcut | Click to go to the Solution Server settings page. |
Language | Combo box | Selects the user interface language. |
Solution List | View Selector | The Solution List allow the selection of a Solution to perform actions on it. |
Refresh | Icon | Refreshes the Solution list. |
Notifications | Icon | Opens the notifications box. |
Help | Text box | Shows useful tips. |
Search Solution | Search box | Searches Solution in the Solution List. |
New | Command button | Opens the New Solution wizard. See Creating New Solutions. |
Edit | Command button | Opens selected Solution for edition. See Editing or Viewing Solutions |
View | Command button | Opens selected Solution in read-only mode. See Editing or Viewing Solutions. |
Run | Command button | Starts selected Solution in startup production mode. See Running Solutions. |
| Info |
|---|
| See Runtime Environment for detailed information on executing Solution, including the ability to define testing and production profiles. |
Solution List
The middle box is called Solution List and shows a list of Solutions on your computer or on a remote computer set previously. Click Refresh to update the Solutions list.
Each item in the Solution selector is a complete Solution with the configuration for an application.
Each image below is an independent Solution. On the top right corner, you can select List, Cards or Table view.
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 Solution Manager page, allowing to perform various actions with the selected solution.
Solution Configuration File
The configuration for the entire solution
Your License
Your License presents information about the software license. There are flexible options for licensing according to each business' needs.
Clicking on the License Management shortcut will take you to the License Management page where you can manage your license and view your license details.
| Info |
|---|
| See Licensing and Activation for more information. |
Solution Server
The Solutions Server section displays information about the computer and folders upon the list of presented list Solutions is build.
Clicking Solution Server allows managing the Solution Server Service settings. There are two options for Solution Server: Localhost or Remote. If you select Remote, you will need to set it up.
| Info |
|---|
| See Server Information page more information. |
Help
Clicking the Help button (blue question mark icon) opens the Are you new here? dialog box which contains some suggestions to get started. It also contain links to our, documentation and forum pages.
Notifications
The bell icon located in the bottom right corner opens the Notifications box.
The Solution Configuration file
The configuration for the entire Solution, is stored in single file with the extension TPROJ.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, backup back up, and restore the Solution solution files, working directly on in the computer folders, just as you 'd do would with any other file. The When moving or adding TProj files directly on in the computer folders, you need to press the "Refresh" button , so to update the list will update the content of the folders.
Other files extension for Solutions are created, when using the Publish feature, as described in the chapter Runtime Build and Publish.
Creating New Solutions
To create a new Solution:
- On the Solution Management, click New....
Select a target platform where your Solution will be installed and click Next.
- Select a product family and a product model. Then, click Next.
- Put a name and a short description to the new Solution.
- Select a Solution template.
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:
FactoryStudio: scalable models based on the number the communication points, enabling SCADA, MES, AdvancedHMI and a wide range of industrial applications.
EdgeHMI: scalable models based on the number communication points, with the sub-set of FactoryStudio features typically require for HMI on machines and embedded devices.
EdgeGateway: scalable models based on the number of communication points, with the features to perform data collections on field, including various protocols, data logging and scripting.
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 tools are available free or charged, but you require a license to put your Solution in production on the field. The Product and Model (number of points) selected when create a new Solution, should reflect the intended license to be acquired for production installation. You still can change those settings after creating the Solution, at the Solution Designer tool, Solution Settings. |
Wizard Step 3: Customizing Solution Name and other options
New Solution Wizard
Field
Description
Name
Enter a name for the Solution.
Description
(Optional) Enter a description of the Solution.
| 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 cantatas the solution configuration. 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.
Access Solutions on Remote Computers
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 Remote Computer.
For Remote Computers: If the remote computer has the Web Server enabled and you are using a Windows computer, you can view the solutions on the remote computer via the URL.
Select the Desired Solution: You
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 Activation 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 Environment. |
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.
visualization options to find and select the solution you need.
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 Remote 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:
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 when creating a new Solution are standard Solution files located in the product installation folder in Templates.
If you receive a new template from your vendor or integrators, 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"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. |
| Page Tree | ||||
|---|---|---|---|---|
|
...