Introduction
Projects are the foundation of your automation solutions, encompassing all the necessary components such as tags, screens, scripts, alarms, and more. To help you manage and customize your projects effectively, our platform offers a range of settings and utilities designed to streamline your development experience.
Project settings provide control over essential aspects of your projects, such as communication configurations, user access, and alarm management. These settings allow you to tailor the platform to your specific requirements and ensure seamless integration with external systems.
Utilities further enhance your project management capabilities by offering tools such as the Tag Browser, Database Manager, Event Logger, and Security Manager. These utilities facilitate efficient organization, monitoring, and control of your projects while maintaining a secure and controlled environment.
Together, project settings and utilities in our platform empower you to create robust, scalable, and secure industrial automation solutions to meet the demands of your applications.
On this page:
Key Concepts and Terminology
Target Platform
The target platform refers to the operating system and hardware environment on which your project will be deployed and executed. Our platform supports various target platforms, including Windows, Linux, and real-time operating systems, ensuring flexibility and compatibility with a wide range of industrial automation systems.
By selecting the appropriate target platform, you can optimize your project's performance and ensure seamless integration with your existing infrastructure.
Target License
The platform uses a licensing model to provide different levels of functionality and scalability, depending on the needs of your project. The target license determines the features, modules, and tag limits available within a specific project.
We offer several licensing options, catering to various project sizes and complexity levels. By choosing the right target license for your project, you can ensure access to the necessary tools and features while optimizing costs.
Categories
One interesting feature in the software platform is the ability to use Categories to organize and group items on runtime, such as variables, alarms, and trends.
Plugins
Plugins are additional software components that can be integrated into the platform to extend its functionality and compatibility. These plugins can be developed by third-party vendors or even end-users. They enable you to add custom features, support for specific devices, or integration with other software systems.
Our platform provides an SDK (Software Development Kit) that allows developers to create their own plugins, ensuring maximum flexibility and adaptability to meet unique project requirements. By leveraging plugins, you can tailor the platform to fit your specific needs and create highly customized automation solutions.
Check Plugins for more information.
Understanding Project Settings and Utilities
Overview
Access the Project Settings through Project → Settings to tailor your projects to specific requirements and ensure seamless integration with external systems.
This section is organize in the the following topics:
Verify the Target Platform
You can verify the Target Platform, which is set when creating a new project, at Project → Settings. Information such as Product Family, Product Model and Canary Historian are also located at this environment and they are editable even after the project is created.
The Projects Management Tool documentation explains in details the procedure to create a new project, as well as how to select the target platform.
Customize Settings
By accessing Project → Settings, users can also access settings such as Diagnostics Logging Control, Python Interpreter Configuration, and Flexible Licensing Options.
Define Categories
Categories are used to organize and manage various elements of an industrial automation project in a structured and logical manner. By grouping similar components or items under specific categories, you can streamline your project development process and maintain a clean, organized workspace.
Categories can be applied to several elements, including:
- Tags: categories help you to group and organize tags based on their purpose, type, or function. This makes it easier to locate, manage, and monitor the tags during the project development and runtime.
- Alarms: categorizing alarms helps in differentiating alarm types, priorities, and sources, enabling efficient alarm management, filtering, and response.
- Screens: organizing screens into categories allows you to manage various user interfaces, such as operator screens, reports, and diagnostics, in a structured manner.
- Scripts: categorizing scripts helps to group related scripts or functions, facilitating easy navigation, editing, and maintenance.
Check Project Settings for detailed information about how to create categories and assign items to them.
Import Tag Definitions
The Import Tag Definitions feature enables you to efficiently import tag information from external sources, such as CSV or Excel files, allowing for quick and easy integration of pre-existing tag definitions into your project, streamlining the development process. Check the Import Tag Wizards for detailed information about this subject.
Manage Project Plugins
Add, remove, or configure plugins that extend the functionality of your project, allowing for seamless integration of custom modules and third-party tools to enhance your industrial automation solution.
Export the Project Configuration
Create a backup or share your project's settings, such as tags, screens, alarms, and more, facilitating collaboration, version control, and easy migration between different environments.
Access the Project History
View and track changes made to your project over time, providing insights into modifications, user actions, and version management, ensuring traceability and effective collaboration throughout the project's lifecycle.
Project Settings Configuration and Utilities Usage
The ProjectSettings navigation on Project Explorer has general settings that applies to the entire project, and Utilities to assist the creating and maintenance of the project. It includes:
General Settings
The Project Settings page (Project → Settings) has the configuration options that applies to the entire project.
You can view and change the project settings that you configured when you created the project.
Project information | |
|---|---|
Field | Description |
Description | A description for the project. |
Project Path | Read-only path to the project. |
Tag Count | How many tags the project has. |
Communication Points | How many communication points the project has. |
Target Platform and License | |
|---|---|
Field | Description |
Target Platform | Shows the target platform selected in the project creation procedure. |
Product Family | A basic description of the product families is Enterprise — Complete FactoryStudio functionality Edge HMI — Use for smaller applications and embedded systems. Express — Use only for test or demonstration purposes. IIoT Gateway — Create a project to work as an OPC server or Data Acquisition Gateway, providing data to other applications from the native protocol drivers. Changing the family settings may cause some configurations to be invalid. For example, some features are only available in the Enterprise version. |
Product Model | The product model is connected with the maximum number of real-time communication points you are allowed on that project. |
Project Options | |
|---|---|
Field | Description |
Culture Info | Select the target language for the runtime application. This setting controls the formatting of dates, numbers, and other information so they are in compliance with the selected language. It is possible to change this setting later. |
Allow Client Tasks (WPF only) | |
Enable Diagnostics Logging | |
Categories
The Categories feature within the Project Settings is a powerful tool that enables you to organize your project content effectively. By grouping related elements together, it improves project structure and navigability. For an in-depth understanding of this feature, please visit our Categories.
Using Import Wizards
Our Project Settings includes an Import Wizards feature, which simplifies the process of integrating external data or components into your project. These wizards can significantly enhance your project setup workflow. For a detailed walkthrough, please refer to our Import Tag Wizards.
Managing Plugins
In Project Settings, the Managing Plugins feature allows you to control and configure the additional functionalities provided by plugins. It's an essential tool for enhancing your project's capabilities and customizing its behavior. Learn more about plugin management in Plugins.
Exporting Project Contents
The ability to export project contents efficiently is a crucial part of Project Settings. This feature provides a convenient way to backup, share or migrate your project data and settings. For a comprehensive guide on how to export project contents, please see our Exporting Project Contents.
Utilizing the Project History
Project History is a significant feature within Project Settings, providing insights into your project's evolution. It allows for better tracking of changes, improved version control, and efficient error resolution. To master this feature, explore our Utilizing The Project History Guide.
Troubleshooting and Best Practices
Troubleshooting and Common #Issues
The Historian module may encounter some issues in its operation. Here are some common issues and their troubleshooting:
#Issue
Solution
Best Practices and #Recommendations
To ensure the smooth operation of the Historian module, follow these best practices:
#Best practice
Recommendations
In this section...