Page Tree
Other Releases
Easy Heading Macro headingIndent 40 navigationTitle On this page selector h2,h3 wrapNavigationText true navigationExpandOption disable-expand-collapse
| Excerpt |
|---|
The applications you develop using FactoryStudio are organized into projects. The following section explains projects and describes how to create and manage them. |
Anchor 1 1
What is a Project?
| 1 | |
| 1 |
FactoryStudio is a powerful platform used to develop and deliver applications that manage real-time information. Applications built with FactoryStudio are organized into projects.
When creating applications or custom solutions, FactoryStudio's engineering tools are used to define the configuration of modules such as Tags, Alarms, Device mapping, graphical displays, scripts, etc.
Each custom solution is Custom solutions are defined as a project projects that stores store all of the an application's configuration information.
The All configuration items are saved in a single embedded SQL database. The file is encrypted for security, and it should be is opened and edited using with the Project Engineering Tools.
The A project's configuration is saved in a file with the extension "tproj". Using the Publish procedure that is described in the chapter “Run, Test, and Publish Projects”, you can create read-only versions of the project for runtime execution only. These version will have the extension "trun".
The system FactoryStudio allows many projects to be opened at the same time. If you already have an a project open project, just select another project in the Project Selection list and open it. When a second instance of the same project is opened, it the second instance will open as read-only.
In order to enable concurrent users you must have a , your project server must be licensed to for multiple engineers. On In the license License tab, in the Engineering Group Box , you have shows the maximum number of concurrent engineering users that can are allowed to access the selected server or the local computer.
The following sections explain more about projects and how to work with them.
Viewing Projects
When you start FactoryStudio, the main page shows a list of projects. The projects presented shown in the list are defined according to by the selected Project Server (defined at in the Server tab) and the selected search paths (defined with the Find Project button).
| Info |
|---|
If the list is does not showing show any projects, it is because the system was unable to locate the project files on the selected server and search paths. Use “Find Projects” to search for projects in on the local computer, use . Use the “Server” tab to connect to a new Project Server, or use . Use “Create Project” to create a new project. If any an error has occurred occurs while the project is loading projects, a log will be created in "C:\Users\Public\Documents\TLocalSettings\". |
Using the dropdown list you can For different ways to view the project list, use the drop-down menu to select 3-D View, Card View, or Table View for different views of your project list.
For a project's quick summary of information about a project, click the symbol in the lower-right corner to rotate . This rotates the selected project icon showing the Project Informationand exposes the summary of information on the back of the icon. See "Creating and Editing Projects" below for details about the project metadata information.
The projects
that show in thispresented in the main page list are all
the onesprojects found in the search paths
. These, and can be defined using the “Find Projects” command. See "Finding Projects" below.
Projects located on remote computers or on cloud servers can also be managed using the server configuration. See "Managing Remote Projects" below.
Projects retain information about the version of FactoryStudio that on which FactoryStudio version was used to create the project originally.
Unless you upgrade the your project to a newer version, the project will always opens using open with the original version with which it was created. For more information, see "Upgrading Projects" below.
| Note |
|---|
Use the Right-click on top of a project to either open it in Readread-only mode , or to Run run the project. |
Creating and Editing Projects
To create a project:
- Click New Project. The New Project page displayswill open.
Enter or select the any needed information, as needed.
- Press
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 FactoryStudio license, this setting may give you may have options here to build applications for a specific version of FactoryStudio. You You can change this setting later, if needed.
| ||
| Product Model | Depending on your FactoryStudio license, this setting may give you may have options here to build applications for a specific product model. The product model is connected with the number of real-time communication points you will be are allowed on that project. |
Project Settings
When you click “Open Project” you open the project configuration toolsProject configuration tools open when you click on "Open Project". The project configuration user interface and navigation is introduced in "Getting Started", Project Configuration Overview and discussed in detail in “Engineering Workspace”. Navigation in the user interface is also introduced in the "Getting Started" guide. Engineering Workspace. Every project file has metadata embedded metadata with the key project information. When using the engineering tools, that this information displays at in the Info-Project-Version page on the workspace tab.
The project Project settings that can be user defined, such as the target family and as well as the model and default options, can be defined at in the Info-Project-Settings page tab.
To view and change a project settingssetting, open the Project project with the configuration tools and:
- Go to Info > Project -> Settings.
You can view and change the project settings that you configured when you created the project.
Field | Description | ||
Product | Read-only name of the product used to create the project. | ||
ProjectPath | Read-only path to the project. | ||
Family | A basic description of the product families is
| ||
Model | The product model is connected with the maximum number of real-time communication points you will define and maximum allowed to use in are allowed on that project. | ||
Target Framework | Read-only. Shows the Microsoft .NET Framework version required for the project. | ||
Culture Info | Select the target language for the runtime application. This setting controls the formatting of dates, numbers, and other information to so that they conform to the selected language. You can change this setting later, if needed. | ||
Default Code | If available, select the language you want to use for writing custom scripts. You can change this setting later, if needed. | ||
Limit values to Min-Max | If checked, you will not be able to set tags outside the Min-Max range. | ||
Target Layout size (on Edit Displays Layouts) | Select the default resolution for new layouts in the project. This does not affect existing layouts. | ||
Default Size when creating new Pages | Select the default resolution for new pages in the project. This does not affect existing pages. | ||
Run modules inside runtime process | Runs the following modules on TServer module, if checked:
|
Finding Projects
When accessing your local computer, FactoryStudio looks for projects in the default folder and in any folder where you have created a project. If you copy
In order to FactoryStudio find a project
filethat was copied to
aanother folder,
FactoryStudio does not know to look in that folder for a project. You can add that folderyou must add it to the search path
, so FactoryStudio knows to look in the folder.
You can also remove folders from the search path, if you no longer need those folders for FactoryStudio projects or want to reduce the list of folders.
To find projects and manage remote access:
Click "Find Project.
The Find Project page displays with.." to display a list of
theexisting search paths.
(If the "Find Project..." button is not visible, check your server configuration).
- Enter or select the information, as needed.
Field | Description |
Current Project Server | Display-only. Lists where the current project is running. |
Include Sample Projects | Selected by default. Deselect to exclude sample projects from the list. |
Include Published Projects | Selected by default. Deselect to exclude published projects from the list. |
Find | Click to navigate to a project. The folder for the project you select is automatically added to the Search Paths list and all the Projects on that folder will be presented at added to the list. |
Search Paths |
|
3. Click Back to return to the main window.
This page also contains the settings to which allow users on remote computers to access the projects, as described in the next section.
| Info |
|---|
When adding a project , or a folder, all the projects in the selected folder are added to the Project List at in the main page. |
Managing Remote Access
Allowing Remote Access
Remote users can only see and access projects from on your local computer if you configure them for remote access. If you want to permit remote access to one or more projects, but not to other projects, be sure to place those projects in separate folders. When you configure remote access (either for project editing or the runtime), you configure it for an entire folder. All projects in a folder that is configured to permit remote access will be accessible to remote users.
The software installation includes a web server (TWebServer) that permits remote access between computers with FactoryStudio installed. No other configuration is needed.
If you are using the Microsoft IIS web server, see “Installing Installing services on IIS” in the "Getting Started" guideIIS.
To manage remote access to for your projects:
- Click Find Project.
- Select the folder in the Search Paths list where you want to view and modify the permissions.
select Select the information, as needed.
Field
Description
Allow Remote Access
Selected by default. De-select Deselect to deny remote access to the selected folder for editing FactoryStudio projects.
Allow Remote Run
Selected by default. De-select Deselect to deny remote access to the selected folder for running a FactoryStudio runtime.
Virtual Path
Enter to provide access to just only the selected folder. Anyone accessing your computer remotely through FactoryStudio can see all of the folders that are configured for remote access and that do not have a Virtual Path.
- Click Back to return to the main window.
Accessing Remote Projects
You can access and edit projects that are configured for remote access. Projects can be on any computer or server that you can access. If you subscribe to the a cloud service, you can access projects configured on it as well. The Find Project function is not available when accessing a remote computer.
You can also upload a project to a remote computer.
To access a project remotely:
- Click the Server tab. This tab lets you configure and access remote projects.
- Do one of the following:
To access a project on a remote computer | To access a project on the cloud service |
|
|
3. Click Connect
4. If you want to upload a project, click Upload Project.
5. Click the Projects tab.
The A list of projects will display. These are the projects that are available from on the computer you accessed displays. The projects available must be in folders that are configured for remote access.
If you did not enter a virtual path, you will not see all any projects in folders configured for remote access, but not with a configured virtual path. You will only see the projects in folders that have a virtual path configured. If configured for remote access. However, if you did enter a virtual path, you will see all projects in the folders configured with the virtual path you entered.
6. Double-click the project you want to open.
Running Projects
You can run a project in any of the following ways:
- From the FactoryStudio welcome window and project list, right-click the project and select Run Project.
- When configuring the project, go to Run > Startup and click Run Startup.
- The project can be run automatically using the auto-startup settings on the Server tab.
For more information, see “Running the Application” in the chapter " Run , and Test and Publish Projects".
Upgrading Projects
Projects retain information about the version of FactoryStudio that was used to create the project. Unless you upgrade the project to a newer version, the project always opens using the version it was created with.
If you now have a newer version of FactoryStudio, you can upgrade a your project to use the newer version.
To upgrade a project:
- Start FactoryStudio. The main page displays. Any will display and any existing projects will display in the lower part of the page.
- Select the project you want.
- For any project that displays a ProductVersion that is older than your current version, right-click and select Upgrade Project.
If this option is not available, the project is already on the same version as the current version of FactoryStudio.
The system keeps the original project and adds the original version number to the file name, so you can still open and run it with the product version with which the project was developed.
. The system creates a new project with the original project name, importing all the configurations to the latest product release.
Overview
Content Tools
Tasks