Learn how to create and organize real-time data tags in FrameworX's Unified Namespace (UNS). Tags are the foundation of any solution, representing data points from devices, calculations, or user inputs.
What You'll Learn
Add Tags to UNS (Tutorial) teaches you to:
- Create different tag types
- Organize tags with folders
- Configure tag properties
- Use
- UserTypes (UDTs)
Prerequisites:
Tags created here providing the foundation for all other tutorials.
In this page:
Table of Contents maxLevel 2 minLevel 2 indent 10px exclude Steps style none
Understanding Tag Types
Some fundamental tag types supported by the platform
- FrameworX Designer installed
- Basic understanding of data types
Step 1: Understanding Tag Types
FrameworX supports these fundamental tag types:
Type | Use Case | Example |
---|---|---|
Digital | On/Off states | Motor_Running |
Integer | Whole numbers | Product_Count |
Double | Decimal values | Temperature |
Text | Strings | Batch_ID |
DateTime | Timestamps | Last_Update |
Step
21: Create
Your FirstTank Farm Tags
- Open Unified Namespace → Tags
- Click first empty row to add tag
- Create these example tags:
Digital Tag:
- Name:
Motor1_Running
- Type: Digital
- Description: Main motor status
Analog Tag:
- Name:
Tank1_Level
- Type: Double
- Min: 0, Max: 100
- Units: %
- Description: Tank level percentage
String Tag:
- Name:
Current_Recipe
- Type: Text
- Initial Value: "Recipe_001"
Step 3: Organize with Folders
- Right-click in tag grid → New Folder
- Name:
Production_Line_1
- Drag tags into folder
- Create hierarchy:
- → Asset Tree
- Create folder structure:
- Right-click → New Folder:
TankFarm
- Create subfolders:
Tank1
- Right-click → New Folder:
- Create Tank1 tags:
- Select the Tank1 folder, then click the Add Tag button
- The Tag will be created inside that folder
- If you create in a wrong place, just drag drop to the correct location
Name | Type | Folder | Min | Max | Units | Description |
---|---|---|---|---|---|---|
Level | Double | TankFarm/Tank1 | 0 | 100 | % | Tank level percentage |
Temp | Double | TankFarm/Tank1 | 0 | 150 | °C | Tank temperature |
Pressure | Double | TankFarm/Tank1 | 0 | 50 | PSI | Tank pressure |
PumpStatus | Digital | TankFarm/Tank1 | - | - | - | Pump running status |
ValvePosition | Integer | TankFarm/Tank1 | 0 | 100 | % | Valve position |
Quick duplication for Tank 2 & 3
- Select the Tank1 Folder
- Right-click the mouse and Copy (Ctrl+C)
- Select the
TankFarm
- Paste (Ctrl+V)
- Repeat the process to create Tank3
- Paste again and replace for Tank3
Step 2: Create Production Tags
Used for counters, batching, and KPI calculations:
- Add production tags:
Name | Type | Path | Description |
---|---|---|---|
Production_Count | Integer | Production | Units produced |
Production_Rate | Double | Production | Units per hour |
Batch_ID | Text | Production | Current batch identifier |
Batch_Start | DateTime | Production | Batch start time |
Shift_Number | Integer | Production | Current shift (1-3) |
Quality_Score | Double | Production | Quality percentage |
Info | ||
---|---|---|
| ||
In order to create those tags quicker, just copy copy-paste this table
|
Step 3: Create Equipment Tags
For motor control and equipment status:
- Create folder:
Equipment
- Add equipment tags:
Name | Type | Folder | Description |
---|---|---|---|
MotorRunning | Digital | Equipment | Motor on/off |
MotorSpeed | Double | Equipment | Motor RPM |
MotorCurrent | Double | Equipment | Motor current (Amps) |
MotorHours | Double | Equipment | Run hours |
ConveyoSpeed | Double | Equipment | Belt speed (m/s) |
Info |
---|
Use similar expedite process you used for the other tags |
Production_Line_1/
??? Motors/
? ??? Motor1_Running
??? Tanks/
? ??? Tank1_Level
??? Recipes/
??? Current_Recipe
Step 4: Configure Tag Properties
Select a tag and configure:
Scaling (for analog tags):
- Engineering Units: Set Min/Max
- Raw Scale: Device Min/Max
- Auto-scales between device and engineering values
Retentive:
- Enable to preserve value through restart
Initial Value:
- Starting value when solution runs
Add Simulation (for testing)
- Select
Tank1_Level
- In properties:
- Simulation: Ramp
- Period: 60 seconds
- For temperatures (random variation):
- Select all temperature tags
- Simulation: Random
- Min: 20, Max: 30
Set Retentive Values
For production counters:
- Select
Production_Count
- Enable Retentive checkbox
- Preserves value through restart
Step 5: Create Motor UserType
Build a reusable template:
Step 5: Create Tag Template- Navigate to Unified Namespace → UserTypes
- Create new type:
Motor
MotorType
- Add members:
- Running (Digital)
- Speed (Double, 0-3600 RPM)
- Current (Double, 0-100 Amps)
- Hours (Double, retentive)
- Fault FaultCode (DigitalInteger)
- Return to Tags
- Create tag from templateinstances:
- Name:
Motor2
, Type:MotorType
- Name:
Motor3
, Type: Select your Motor template
- Name:
- :
MotorType
- :
Step 6: Create System Tags
For scripts and calculations:
Name | Type | Initial Value | Description |
---|---|---|---|
System_Running | Digital | 0 | System status |
Calc_Average | Double | 0 | Calculated average |
Alarm_Count | Integer | 0 | Active alarm counter |
Report_Trigger | Digital | 0 | Report generation trigger |
Step 7: Test Your Tags
- Click Run (F5)
- Open Unified Namespace → MonitorSee your tags updating
- Verify:
- Simulation values changing
- Folder structure visible
- UserType instances expanded
- Double-click values to modify values
Best Practices
- Use consistent naming:
Area_Equipment_Signal
- Group related tags in folders
- Document with descriptions
- Set appropriate engineering units
- Use templates for repeated structures
Next Steps
- manually
Tag Summary
You've created ~40 tags that serve as the foundation for:
- Alarms: Level and temperature monitoring
- Historian: Time-series data collection
- Scripts: Calculations and logic
- Displays: Visual representations
- Reports: Production metrics
Next Steps
With tags configured, proceed to:
- [Alarms & Audit-Trail] - Monitor tank levels
- [Historian: Store & Trend] - Log process data
- [Scripts & Data Enrichment] - Add calculations
- [Complete Solution] - Build full application
In this section...
Page Tree | ||||
---|---|---|---|---|
|