This page presents how to create and manage Projects.
What is a Project
This framework is a powerful platform used to develop and deliver applications that manage real-time information. Applications built with the platform are organized into Projects.
A Project holds the configuration for the various functional Modules, such as Tags definition, Alarms, Communication, Displays and others. We refer to the tool that assist to select Project and open for editing or execution as Project Manager.
This section explains how to create, edit and execute your Projects, using the Project Manager User Interface.
Welcome Page
The Welcome page is the first interface you see when you start our platform. This interface allows you to view the Projects in your computer — or remote computers —, create new ones, open projects for editing and run them.
Each item shown in the table view or card view is a complete Project with the configuration for an application.
Some very unique and powerful features about Tatsoft tools for project management include:
- This Welcome interface is product version agnostic. You can manage and open even projects created with different product versions without the need to upgrade the project in the field or to switch the engineering tool in your computer.
- Each project is a single file. All configuration, including tag definition, displays drawing, images and report templates is stored in a single file, an encrypted SQL database with extension .trpoj, for easy management.
- You can open multiple projects at the same time or allow multiple engineers to work on each project.
About your Software License
<<<<. basic explanation and link to the License Information page >>>>
Presents and manages information about the computer software license. Go to User Guide → Installation and Licensing → Managing Licenses for more information.
About the Project Server
<<<<. basic explanation, says where that list of projects comes from, and link to the License Information page >>>>
License Workspace
Presents and manages information about the computer software license. Go to User Guide → Installation and Licensing → Managing Licenses for more information.
Listing Projects
At Projects workspace, you have a list of the projects on your computer or on the remote computer selected at the Server tab.
Each image shown below is an independent Project. On the top right corner, you can select to use the Card View or the List View.
The image used for the Project preview is the contents of the Display named MainPage in that project. |
Refresh Icon (at the low right corner): updates the projects list
CardView Visualization
TableView Visualization
Command Buttons
New Project: opens a dialog to enable the creation of a new project
Edit Project: opens the selected project for edition
View (read-only): opens the selected project in read-only mode.
Upgrade Version: if Project was created with a previous version the Upgrade button is enable
Test Project: Starts the project execution using a Testing profile.
Run Project: Starts selected project in startup production mode.
For more information on Testing Profiles and startup, go to section Running Projects
Creating New Projects
To create a project:
- Click New Project. The New Project page will open.
Enter or select any needed information.
- Select the desired Project Template.
Click Create New Project.
Field | Description | |
Name | Enter a name for the project. | |
Description | (Optional) Enter a description of the project. | |
Location | Click the "..." button to select a folder or to create a new folder for the project.
| |
| Product Family | Depending on your license, this setting may give you options to build applications for a specific version of our platform. You can change this setting later, if needed.
| |
| Product Model | 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 project. |
Project Templates
Pre-built Project Templates get you started faster by building the solutions you need.There a few templates installed with the product, but more templates can be easily added to the system, or you can create your own as well.The following template are installed with the product. They are located at the folder <<<< >>>>>
- Blank Project
- Default Project
- TrendChart Project
- TrendChart with Alarm Pages Project
- TrendChart with Alarm Pages and Alarm Footer
- Redundancy Project
- Asset Viewer
The best way to check if the template is suitable to you, it is just to execute it. Run it and look the displays, or open its configuration in View, read-only mode, to further details.
This the basic descriptions, on the contents of each available template: <<<<. change the images to text ??? >>>>
Adding new Templates
The templates presented when creating a new project are standard Project Files located in the product installation folder at Templates.
If you receive a new template from you vendor or integrators, just copy to that project. You can create your own projects, and save them as a Template as well.
Open Projects for Editing or Viewing
The platform supports two ways to open projects. The View button opens a ready-only version of the Project configuration. That is always the best way to go, if you just want to put the project in execution, or check its configuration.
When opening using the Edit button, it will be possible to modify the project. You may need to use the Logon button in the toolbar before editing if the Security projections were enabled to that project.
Many projects can be opened at the same time. If you already have a project open, select another project in the Project Selection list and open it. When a second instance of the same project is opened, the second instance will open as read-only.
In order to enable concurrent users, your project server must be licensed for multiple engineers. In the License tab, the Engineering Group Box shows the maximum number of concurrent engineering users that are allowed to access the selected server or the local computer.
Upgrading Projects
Projects retain information about the FrameworX version used to create the Project.
When opening a Project with a previous version, the platform will try to find an installation of the previous version in the computer, and use it to edit the Project.
You can bring the Project to the latest version using the Upgrade Version command button.
When Upgrading:
- A copy of the Project is executed, creating a new files with name: <project-name>-<preivous-vesion>.tproj
- A new empty Project is created with the name <project-name>.tproj
- The Previous project is imported to the new Project
After upgrading a project, you should Open it and execute a Run → Build operation, so the system verify all scripts in the new project file.
Running Projects
You can run a project in any of the following ways:
- Use the Run Project command button, or the Test Project
- Setup an Auto-Start option at the Server tab
- Start the execution manually after you open the Project for editing
Both Test Project and Run Project, will start the project execution. The difference is the Test Project will use any testing configuration created in the Project, such as alternate database connections, and other tools that simplify the development and validation cycle of the Project.
For more information, see User Guide → Running Projects.