You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »



The Designer provides a unified configuration workspace for all FrameworX solution development. It delivers an integrated environment for design, development, testing, validation, and deployment across all functional modules, organized through the Four Pillars architecture that structures data flow from field connectivity to user visualization.

On this Page:

  • Designer Overview
  • Key Concepts
  • What It Does
  • Configuration Workflow
  • Runtime Behavior
  • Feature Highlights

Key Concepts

  • Solution File (.dbsln): Encrypted SQL database containing all module configurations and engineering logic
  • Modular Architecture: Compartmentalized design with independent modules ensuring isolated changes
  • Four Pillars Organization: Logical grouping of modules by function (Foundation, Industrial, Business, Visualization)
  • Object Model: .NET-based classes providing inherited properties and methods for all configured objects
  • IntelliSense: Context-aware auto-completion for tags, objects, and properties
  • Test Mode: In-Designer runtime execution for validation without deployment

What It Does

  • Provides unified interface for configuring all solution modules and components
  • Enables offline and online configuration with multi-user collaboration support
  • Offers integrated testing and validation without leaving the design environment
  • Manages cross-references, version control, and change tracking automatically
  • Supports refactoring with automatic reference updates throughout solution
  • Delivers context-sensitive editing with real-time validation and tooltips

Configuration Workflow

Designer Configuration Workflow

StepActionDescription
1. Foundation LayerConfigure UNSDefine tags, templates, enumerations, asset tree
2. Industrial IntegrationSetup Process ModulesConfigure Devices, Alarms, Historians
3. Business LogicAdd Application ModulesCreate Scripts, Datasets, Reports
4. VisualizationDesign User InterfaceBuild Displays, dashboards, client settings
5. SecurityDefine Access ControlSetup users, permissions, runtime security
6. Test & DeployValidate SolutionTest mode execution, build, and publish

Runtime Behavior

Module Organization by Four Pillars

Pillar 1: Unified Namespace (Foundation)

  • Tags: Real-time data points with .NET-based types and properties
  • Templates (UDTs): Reusable data structures for complex objects
  • Asset Tree: Hierarchical organization matching physical equipment
  • TagProviders: Dynamic connections to external data sources

Pillar 2: Process Modules (Industrial Integration)

  • Devices: 70+ native drivers, OPC UA/DA, MQTT SparkPlug B support
  • Alarms: Condition monitoring, notifications, audit trail
  • Historians: Time-series storage with SQL engine, Canary, PI, InfluxDB

Pillar 3: Application Modules (Business Logic)

  • Scripts: C#, VB.NET, Python, JavaScript with multi-threading
  • Datasets: SQL connections, queries, real-time data tables
  • Reports: Text, PDF, HTML5 generation with web services

Pillar 4: User Interface (Visualization)

  • Displays: HMI/SCADA screens with responsive design
  • Symbols: Reusable graphical components library
  • Clients: HTML5, .NET SmartClient, mobile deployment

Designer Workspace Interface

ComponentFunctionFeatures
Navigation TreeModule accessQuick shortcuts, search, hierarchical browsing
Design CanvasContext-sensitive editingIntelliSense, validation, real-time preview
Properties PanelObject configurationDynamic property grid, tooltips, examples
Output WindowSystem feedbackBuild results, errors, search results
Top ToolbarCommon operationsUndo/redo, cut/copy/paste, find, export

Object Model Integration

All configured objects inherit from .NET classes, providing:

  • Native properties and methods without custom coding
  • Direct access to .NET functionality (e.g., DateTime.DayOfWeek)
  • Runtime statistics (e.g., Script.Task.LastCPUTime)
  • Seamless integration with external .NET assemblies

Feature Highlights

Development Productivity

  • IntelliSense everywhere: Auto-completion for all tag names and object references
  • Real-time validation: Red borders and tooltips for invalid entries
  • Refactoring support: Rename objects with automatic reference updates
  • Cross-reference tools: Find all uses of any object instantly
  • Version control: Built-in change tracking and comparison

Unified Configuration

  • Single environment: All modules configured in one interface
  • Consistent UI: Same patterns across all configuration tables
  • Context menus: Right-click access to relevant operations
  • Drag-drop support: Move items between panels and modules
  • Keyboard shortcuts: Ctrl+S save, F5 test mode, standard editing

Testing and Validation

  • Test Mode: Run solution without leaving Designer
  • Online configuration: Modify running solutions safely
  • Simulation tools: Test without field devices connected
  • Error checking: Automatic validation on save
  • Performance monitoring: Real-time resource usage display

Collaboration Features

  • Multi-user support: Concurrent engineering on same solution
  • Change tracking: Automatic logging of all modifications
  • User permissions: Role-based access to configuration areas
  • Import/Export: Excel, CSV for bulk operations
  • Documentation: Integrated help and examples

Module Integration

  • Namespace organization: Logical grouping (Tag, Alarm, Device, Script)
  • Shared object model: Consistent properties across modules
  • Event-driven updates: Changes propagate automatically
  • Unified database: Single SQL store for all configurations
  • Cross-module references: Direct linking between components


Designer & Modules (Concept)




Overview



The Designer is the configuration workspace for your solution—where you define tags, devices, datasets, alarms, scripts, displays, and security. It supports offline and online editing in a unified, cross-platform UI. See the workspace layoutsketch on page 1 for the main regions (Navigation Tree, Canvas, Properties, Output). 



What you can do



  • Configure UNS/Tags, Devices, Datasets/SQL, Alarms, Scripts, Displays, and Security from a single workspace. 

  • Use Test Mode to validate behavior without leaving Designer. 

  • Navigate fast via Solution Explorer and quick shortcuts (Home, Tags/UNS, Draw, Runtime). 

  • Inspect cross-references, errors, and build output in the bottom panels. 

  • Benefit from tooltips, validation, IntelliSense, and refactoring across editors. 




Modules organized by the Four Pillars



Use this model to avoid a long flat list and give users a mental map. (Each item links to its module reference.)


  • Define Your Data

    UNS & Tags, Datasets/Queries, Data Explorer tools. 

  • Connect & Collect

    Devices (protocol drivers, OPC UA/DA, MQTT Sparkplug B), Connections/Monitors. 

  • Monitor & Act

    Alarms (Items/Groups/Areas, Notifications), Historian (SQL/Canary, store-and-forward), Security (users, groups, AD/LDAP). 

  • Visualize & Share

    Displays (desktop & web), Reports/Forms/WebData. 



Tip: In the Solution Explorer table (Reference), keep these pillar groupings by section so users can scan: Solution, Runtime, UNS, Devices, Alarms, Historian, Datasets, Reports, Scripts, Security, Displays, Data Explorer, Track Changes. (See page 3 for the full child-page matrix.) 



Key concepts & terms



  • Solution (.dbsln): encrypted SQL file storing all configuration. 

  • Modular architecture: changes in one module won’t break others. 

  • Unified Namespace (UNS): central semantic model for tags and assets. 




How it fits at runtime



Designer produces the configuration your Runtime executes; clients (desktop & web) visualize and interact with the running system. Designer’s Test Mode lets you validate behavior before publishing to Runtime. (See “Runtime execution” and “Display/HMI clients” callouts on page 1.) 



Interface at a glance



  • Navigation Tree (modules by pillar) • Design CanvasProperties PanelOutput/Errors/Cross-Ref. Diagram on page 1. 

  • Quick navigation: Home, UNS/Tags, Draw (Displays), Runtime; plus Switch menu to Solution Management, docs, forum, and training. 




Configuration at a glance



  1. Open a solution in Designer.

  2. Work pillar-by-pillar: Define data → Connect devices → Monitor/Act → Visualize/Share.

  3. Run/Test from Designer; then publish to Runtime. 




See also



  • Solution Center (Concept): launchpad for create/open/license/run.

  • Runtime & Clients (Concept): execution and client connections.

  • Designer Environment (Reference): UI details, toolbars, shortcuts, child pages. 






Notes



  • This keeps Overview short and moves value into What you can do—the same pattern we used for Solution Center.

  • The pillar mapping mirrors the Process/Application modules split and the Define/Setup/Runtime tiles shown in the Designer reference intro image (page 1), making the concept page consistent with the reference UI. 



Want me to generate the matching Modules (Reference) index grouped by the four pillars (with one-line summaries for each module)?

  • Designer Workspace (configuration environment)
  • All functional modules (Tags, Historian, Security, etc.)
  • Development tools
  • Runtime execution
  • Display/HMI clients (Web, Mobile, Desktop)
  • Utilities and tools

The Designer is where you configure your solution: tags, devices, datasets, alarms, scripts, displays, and security. It supports offline and online configuration and a unified, cross-platform UI.


On this page


  • What you configure here

  • Offline vs. online editing

  • Saving & deploying changes (high level)


Workspace Layout

???????????????????????????????????????????????????????????
?  Menu Bar            [File][Edit][View][Tools][Help]    ?
???????????????????????????????????????????????????????????
?              ?                        ?                 ?
?  Navigation  ?     Design Canvas      ?   Properties    ?
?     Tree     ?                        ?     Panel       ?
?              ?   (Context-Sensitive)  ?                 ?
? ? Solution   ?                        ?  Tag: Temp      ?
?   ? UNS      ?                        ?  Type: Float    ?
?     • Tags   ?                        ?  Value: 75.5    ?
?   ? Devices  ?                        ?                 ?
?   ? Displays ?                        ?                 ?
???????????????????????????????????????????????????????????
?  Output Window      [Build][Errors][Search Results]     ?
???????????????????????????????????????????????????????????

Key Designer Features

FeatureLocationPurpose
Tag EditorUNS → TagsCreate and configure tags
Display DesignerDisplays → PagesBuild HMI screens
Device ConfigurationDevices → ChannelsSetup communications
Script EditorScripts → TasksWrite custom logic
Test ModeToolbar → Run TestTest without leaving Designer

Navigation Tips

  • Double-click items to edit
  • Right-click for context menus
  • Drag-drop between panels
  • Ctrl+S saves current item
  • F5 starts test mode



Unified Namespace And Tags

Build real-time data models, like Tags and Templates. Connect seamlessly to external systems using Dynamic ExternalTags for on-demand data connectivity. Asset modeling allows for the creation of a hierarchical view of the data.

Historian

Easily store and access time-series data. Our platform includes an SQL historian engine, Canary Historian, at no extra cost. It seamlessly integrates with other historian tools like OSIsoft PI and InfluxDB. Plus, it offers out-of-the-box store-and-forward functionality.

Security

Control access to project configuration and user security effortlessly. Enable FDA compliance applications, integrate with Active Directory, LDAP, and more for user security. Define access to displays and objects based on user profiles and security groups with ease.

Devices

Access over 60 native communication protocol drivers for PLCs, transmitters, and field devices effortlessly. Our platform fully supports OPC UA and DA for both server and client execution, along with emerging standards like MQTT SparkPlug B.

Alarms

Easily organize Tags into Groups and Areas for setting Alarm conditions, Audit-Trail, and notifications via email, SMS, or voice. Visualize alarms online and in the historian. Store data agnostically on any selected Database provider.

Datasets

Effortlessly handle multiple connections with SQL databases, customize processes with queries, and tailor tables for real-time tag values. Manage recipes and data files in ASCII, UNICODE, or XML formats with ease.

Scripts

Enable powerful server-side and client-side scripting with high performance. Use languages like C#, VB .NET, Python, and JavaScript. Easily develop multi-threading applications with parallel execution and add references to externally developed classes.

Reports

Generate Text (Plain, XML or JSON), PDF, or HTML5 reports directly without relying on external tools. Additionally, utilize web services to interact with external applications or systems. Access, manipulate, and share data using standardized communication protocols like HTTP and RESTful APIs. This facilitates integration with various software systems such as ERP, BI tools, and custom applications, enhancing data sharing and collaboration.

Displays

Effortlessly design User Interface Displays using our advanced drawing tool, featuring a wide range of customizable Symbols and Graphical components. Whether you need a Responsive Dashboard, a traditional Process Diagram, or high-performance SCADA Graphics, we've got you covered. Deploy your displays seamlessly in HTML5 or secure .NET SmartClient to desktop, mobile, or web clients. Enhance user experience with features like Language Localization, dynamic Engineering Units conversion, and dynamic theme color schemes.


Data Explorer

Perform data mining and monitoring from various data sources, including MQTT Brokers, OPC-UA, PLCs and SQL databases.

Track Changes

Automatically maintain a log of Solution configuration changes, cross-reference tables, and Version Control Information.


Modules Namespaces 

Object Model

In most systems, you usually have to go through the hassle of creating Tags or Variables and writing code to display information about what's happening in your application, like how much CPU is being used by the latest task.

Using our platform, things are way simpler. All those things you need to keep track of, like Tags, AlarmGroups, and ScriptTasks, are actually classes that extend from .NET classes. This means that when you configure your project, you get to use all the properties and methods created by our platform, as well as those already built into the .NET classes.

Take the Tag DateTime, for example. In other systems, you'd need to write code and methods to convert strings to DateTime formats or figure out what day of the week a specific date falls on. But with our platform, the DateTime Tag is just an instance of the .NET class DateTime. That means your project can easily tap into all the properties and methods that come with it, right out of the box.


Examples

Finding the weekday of date time event: simply access the property Tag.DateTimeExample.Value.DayOfWeek,

Finding the amount of CPU used the last time a calculation was executed: simply access the property Script.Task.Example1.LastCPUTime

Namespaces

All the Modules, tools and objects used in a project are organized in accessible namespaces. Some of main namespaces are:

Tags: Group of variables of the real-time database

Alarms: Provides access to all information about the management of Alarms. 

Devices: Includes information on all field devices and its communication status.





  • No labels