The evaluation allows unlimited use to create and edit multiple solutions, with unlimited tags and unlimited configuration time. The Runtime (the execution of your solution) is enabled for two hours of resettable time, for information on licensing for production contact us.
The FrameworX Designer requires Windows 10 or newer, the solutions you are creating are multi-platform and can execute in multiple operating systems. 3| Anchor | ||||
|---|---|---|---|---|
|
In order to install, just click on the MSIX file, which installs in just a couple of seconds, install FrameworX as a Windows App.
| Tip |
|---|
When the application is running, you can right-click on its icon at Windows TaskBar, and select Pin To Taskbar, so you have a shortcut to access it. Otherwise when you want to execute, type FrameworX in the Windows Search box. |
Solutions Management User Interface
When you open the software, the first User Interface is the Solutions Management tool, which will list the Solutions in your computer and allow to create, edit or run the solutions. When the software was first installed, it will show the Demo solutions that are installed in you Documents folder.
You can go ahead and use the New button to create your solution or first explore the installed demos.
| title | Click here to expand about Exploring Demos... |
|---|
To open a Demo Solution, just select from the list and click "Run" to simply deploy it or "Edit" to take a look at how we created it. You can also double click the solution to load it.
In order to know what each demo is featuring , check the page Demo Projects Overview
When you open a Solution, you'll find the following Welcome Window.
Navigate to Runtime, and press START button to execute the Solution.
The first time you Open and Run solutions after a new installation, Windows Firewall may request you authorize its use. Just press OK if the following dialog is shown.
<< Image Windows Firewall confirmation >>
To install FrameworX:
1.Run the Installer: Click on the FrameworX-Setup.exe file. The installation will complete in just a few minutes, adding FrameworX to \Program Files (x86)\Tatsoft\ folder.
2.Accessing the Application:
•After installation, right-click the FrameworX icon in the Desktop. When running, at the Windows TaskBar, you can select “Pin to Taskbar” for easy access.
•Alternatively, type “FrameworX” in the Windows search box to locate and launch the application.
When the application is first time launched, it may request to update the Microsoft Visual Studio Redistributable package, simple authorize to proceed.
3. Firewall Authorization:
Upon first editing or running solutions post-installation, Windows Firewall may prompt for authorization. Simply click “OK” to proceed.
| Info | ||
|---|---|---|
| ||
If you have a previous installation using the MSIX installer, please uninstall it first. Due to restrictions with running .NET 8 applications, the MSIX option is no longer supported. If you have a previous installation using the Setup.exe installer, you can install the new version without uninstalling the old one. However, the installation will be slightly faster if the previous version is removed first. |
| Tip | ||
|---|---|---|
| ||
For more information about installation folders refer to the Managing Installations section. |
| Expand | ||
|---|---|---|
| ||
.NET 8 is required to create solutions to other operating platforms like Linux, and to edit displays to show on web browsers. If you receive a warning that .NET 8 is not available on your computer, you still will be able to work with Windows-only solutions and displays. To install the .NET 8, follow the link in the installer message, or you can find the .NET 8 Desktop Runtime installer from Microsoft here: https://dotnet.microsoft.com/en-us/download/dotnet/8.0. Be sure to pick the version that matches your CPU architecture, which is likely x64. (And don't pick the "SDK" or ".NET Runtime" or other versions - just the ".NET 8 Desktop Runtime") |
| Anchor | ||||
|---|---|---|---|---|
|
Upon launching FrameworX, the first interface you’ll encounter is the SolutionsManager. This tool allows you to:
•Manage Solutions: View, create, edit, or run solutions stored on your computer.
•Explore the Demo: Access the Demo Solution installed with the product, located in your Documents folder. You can also download additional demos and examples from Solution Examples.
Select the Demo solution, and click on RUN to execute it, or Edit to access its configuration.
Creating a New Solution
If you want to create your own solution, simply click "New" in the Solution ManagerSolutionsManager, and following follow the Wizard steps.
wizard steps.
| Expand | ||
|---|---|---|
| ||
The first step is to select the Product that the solution is intended to use. To facilitate In order to facility multiple scenarios in a cost-effective way, FrameworX has its product line organize in Family and Models, more information about it on Platform Overview > Product Series.
organized into families and models. More information can be found in Product Family.
Once you've selected the productThen, you'll move , you must choose what kind of solution you'll build, Windows or Multi-Platform.
Finally, you can add a title and a description and choose a location on your computer to install this solution (we install it inside the Documents folder, by default). You can choose a template for your solution here as well, but for . For this example, we won't select anythingyou can select "HeaderLayout". When you're ready, simply click "Create New Solution".
|
Once loading is complete, you'll see our Home Page, that contains all of the basic information for this solution.
| Expand | ||
|---|---|---|
| ||
n the homepage you can change the Theme you'll be using: we offer five different options (Light, Dark, Indigo, Blue and Live). By default, Light will be selected. On the right side of the screen, you'll find the common steps to start exploring our platform, from DataExplorer to Runtime. We'll explore those basic features in this quick tutorial. I By default, our Solution Explorer Navigation is filtered by All Modules and Features. If you wish to work with a simplified version of the platform, simply change the filter in the first box.
|
Designer, Editing the Solution
When a new solution is created, or you open an existing one, the Designer user interface is presented. The Designer in a an integrated enviromelnu that allow you to configure you solution, draw display, creating script code, queries, reports, execute your solution and monitor your real-time data..
<<< Add Image >>>
There are various ways to work with the Designer, you can configure the Modules in order that is suitable to you. In this first Getting Started, we will do these steps:
- Use the Data Explorer to find data in a MQTT Broker and create automatically Tags and Connections.
- Go to Unified Namespace to create Asset Folders and Tags
- Go to Devices to create mapping of Tags to address in field Devices.
- Create a Display showing the data we acquired.
- Create an Alarm Item and add a Alarm component to the Display
Data Explorer Tools
The DataExplorer tools allow you to easily perform data mining and monitoring from various data sources, including MQTT Brokers, OPC-UA, PLCs and SQL databases. Here, let's see how you can connect to our MQTT Simulator to browse its data.
Go to Data Explorer → MQTT Tools to start. You can connect to your own broker, if you wish, but our system has a native SpartkplugB MQTT Built-In Broker that you can use.
Out platform also offers a MQTT Publisher Simulator, that has customizable data being published. Simply click both of the green "start" buttons to start the Broker and Simulator.
Once you've done so, click Connect to see and browse the generated data.
We'll be using this simulated data to make it easier to build a simple solution. Select DeviceD1, from the list of simulated data, and click Map to Solution. This will create a new Data Model with the device properties. In this example, we named the new Data Template SolarPanel. In the Module option, we'll leave the first option selected, which represents the more typical behavior of mapping tags to external devices, but we can also do dynamic connections with the External TagProviders functionality.
Unified Namespace and Tags
In the Unified Namespace section, you'll be able to define the data models you'll use in the solution. When building a new solution, a good practice is start by creating Data Templates. In this case, the SolarPanel data template will have already been created, since we exported it from the MQTT Simulator. You can also create your data templates manually or import from csv or other libraries.
Once you have your Data Model, the next step would be to create tags and map it to a Device. This was already done automatically, but once again, you can do it manually if you wish. Here, you'll find the tag DeviceD1 has already been created, with the type "DataModel1", that contains all of the properties of the device from the MQTT Simulator.
To create a New Tag, simply click the "New Item" option in the Tags menu.
Field Communication: Mapping Data to Devices
The next step is creating the connection with the field. For this, we offer over 50+ native communication protocols installed by default with the product.
The use of those communication protocols is a straight forward process:
- Create a Channel, which is an instance of the Protocol with optional configuration settings
- Create a Node within that Channel, which specifies the location of that Device in your network, using the PrimaryStation Field
- Map a Tag in your application to an Address in the Device Node.
The Export Wizard we used on the DataExplorer did those 3 steps automatically to you.
| Expand | ||
|---|---|---|
| ||
In this case, since we mapped the MQTT Simulator to the solution, creating a Channel using the MQTT SparkPlugB protocol
Node Configuration: < > Points Configuration < > |
As an Exercise you can create one more Tag and its mapping
| title | Click here to see how to create and map a Tag... |
|---|
Simply click to create a new Tag1 in the upper menu of the Points section and create a new Tag1 as a "SolarPanel" type.
Once you do that, add it to Points table and map it to a specific Address. You can either type or browse the available data. A important thing to consider is that you only need to map at the device level, as the system will automatically read all of the properties associated with that device.
| Tip |
|---|
On Asset Tree, in the Unified Namespace module, you can change the hierarchy of the tags, by creating or importing folders and dragging and dropping tags as necessary. By default, new tags are added to BaseTags. |
Creating a Simple Display with Symbols
Let's start by exploring the Draw Environment. To access, go to Displays → Draw, or simply click the Draw button at the top menu.
This will open the main Draw Environment. By default, the first page created will be the MainPage, where your main content should go.
On the left side of the screen, you'll find all of the components you can use to build your display. They're categorized by different types of graphical components, such as icons, charts, navigation and symbols (incluindo high-performance graphics). You can also search for something specific in our library using the search input.
To add a component to your display, simply click and drag to the drawing environment. In this example, we'll grab a simple button from the Symbol library. If you double click the symbol, you'll open a popup box where you can map the component's properties to your tags. In this case, the button only has one property (IsPressed), which will map to the device status. To find a specific tag, you can either type "Tag." and it'll show you the options or click the three dots next to the input to navigate on your Asset Tree.
That is all you have to do! The value of Tag is now connected to drive the visual of the Select Symbol.
Optional exercices:
| Expand | ||
|---|---|---|
| ||
Another way of creating your UI is by dragging tags directly into the display. On the right side of the screen, you'll find all of your tags - if you drag them into the display, it'll automatically create a text output, but you can also map them to specific symbols to create those automatically. To do that, select the tag (or the whole Device) you'd like to map and click Map to Symbol. You'll then be able to select symbols you've created to display your data. Once that's done, if you drag the tag into the Display, it'll automatically create a symbol. In this example, I already added a CircularGauge to my library to showcase the device temperature.
|
| title | Click Here if you want how you modify and customize Symbols.... |
|---|
Another unique feature of our platform is the ability to customize any symbol with a great number of dynamic properties. Those include custom Actions, Scripts, Visibility, Rotation, and more.
For this example, add a simple rectangle to the display and double click it to look at the available properties. For this example, I created a simple expression to change the fill color depending on the value with a simulation tag in the expression.
You can create a new symbol combining those two components and save it into your Symbol Library. To do that, first break apart the button symbol and then select all parts and select "Create New Symbols with Select Elements". This gives you more flexibility to use our library as a base to create custom symbols that fit your industrial application.
As you make changes, make sure to save your display by clicking on the button on top of the page.
Create a Real-Time Alarm
To test out the Alarming functionalities in the platform, let's create an alarm.
On Alarms → Items, simply type on the first line of the table to create a new Alarm. Type "DeviceD1." and you'll see the available properties associated with that Device - for this example, establish a condition, limit, select a group (there will be a few available as default) and a message to showcase when that limit is reached.
In the Draw Environment, search for AlarmWindow and drag it into the display.
Running your Solution
It's time to run your solution by clicking on the Runtime module (or selecting the shortcut on the top of the page). In this page, you'll find information regarding the solution, including redundancy settings and command lines and URL for the clients.
To run your solution, simply click "Run Startup".
| Warning |
|---|
The first time you Open and Run solutions after a new installation, Windows Firewall may request you authorize its use. Just press OK if the following dialog is shown. << Image Windows Firewall confirmation >> |
Runtime Startup page
| Tip |
|---|
Click on the HTML5 Client URL to see your solution running also as a Web Client! |
Licensing And Registration
To get the full capabilities of our platform and start building your real solutions, you'll need a License. The information about your license and the links to activate it can be found in the Solution Manager page. There you may choose between online and offline activation. You can learn more Licensing and Activation here. If you don't have a license yet, feel free to reach out at sales@tatsoft.com.
|
After the solution is created, it opens the Designer homepage, the main UI for editing your solutions.
| Info | ||
|---|---|---|
| ||
→ Go to Solution Configuration tutorial, for a step-by-step guide on adding content to your first solution. |
Licensing And Registration
To deploy your solution into production and run it without time limitations, a valid license is required.
- License Information: Access details about your license and activation links via the Solutions Manager. Both online and offline activation methods are available. For comprehensive guidance, see Licensing and Activation.
- Acquiring a License: If you haven’t obtained a license yet, please reach out to us.
| Tip | ||
|---|---|---|
| ||
Click on the "Your License" title, at the left side, to navigate to the Page License Information page |
Next Steps, Exploring More Features
With these foundational steps completed, you’re ready to delve deeper into FrameworX:
- •Solution Design: Learn how to start designing your solution in Solution Configuration.
- •Platform Features: Explore the Platform Overview to familiarize yourself with the platform’s capabilities.
- •Tutorials: Engage with our Tutorials for comprehensive exercises.
- •User Guide: Consult the User Guide for detailed information on each module.
- •Training: Access free videos and training courses by signing in at the Training Site.
- •Solution Examples: Review Solution Examples that showcase various aspects and functionalities of the platform.
- •Community Engagement: Join our community forum to exchange ideas and seek assistance.
Exploring More Features
With these steps, you've learned the basic on working with FrameworX and you're ready to continue your journey.
Once you're ready, we recommend you:
- Look the Platform Overview to learn about the overall features of the Platform.
- Explore the Tutorials for more comprehensive exercises to learn the platform.
- Explore the User Guide, that goes into detail on each module.
- Sign in at the Training Site to access free videos and trainman courses/
- Take a look at our Solution Examples, that showcase different aspects and functionalities of the platform. Joint our community forum and exchange ideias!
You can also schedule an introductory meeting with one of our onboarding specialists here.
The children pages In this Section have detailed Information on Installation, Managing Solutions, and Licensing.
Feedback
Please provide us with feedback on our software and documentation. Share your ideas for new features or specific training topics on our website.
We look forward to engaging with you and making progress together.
In this section: In this Section
| Page Tree | ||||
|---|---|---|---|---|
|