Unified Namespace Tutorial: Add Tags to UNS.

Tutorials → Unified Namespace | Tutorial | How-to Guide | Reference

This 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.

1. Create Tank Farm Tags

  1. Open Unified Namespace → Asset Tree
  2. Create folder structure:
    • Right-click → New Asset Folder: TankFarm
    • Create subfolder: Tank1
  3. Create Tank1 tags:
  • Right click the Tank1 folder, then click the New Tag button
  • The Tag will be created inside that folder
  • If you create in a wrong place, just drag drop to the correct location
NameTypePathMinMaxUnitsDescription
LevelDoubleTankFarm/Tank10100%Tank level percentage
TemperatureDoubleTankFarm/Tank10150°CTank temperature
PressureDoubleTankFarm/Tank1050PSITank pressure
PumpStatusDigitalTankFarm/Tank1---Pump running status
ValvePositionIntegerTankFarm/Tank10100%Valve position

Quick duplication for Tank 2 & 3

  1. Select the Tank1 Folder
  2. Right-click the mouse and Copy (Ctrl+C)
  3. Select the TankFarm
  4. Paste (Ctrl+V)
  5. Rename the folder
  6. Repeat the process to create Tank3
  7. Paste again and replace for Tank3

2. Create Production Tags

Used for counters, batching, and KPI calculations:

  1. Add production tags:
NameTypePathDescription
Production_CountIntegerProductionUnits produced
Production_RateDoubleProductionUnits per hour
Batch_IDTextProductionCurrent batch identifier
Batch_StartDateTimeProductionBatch start time
Shift_NumberIntegerProductionCurrent shift (1-3)
Quality_ScoreDoubleProductionQuality percentage

    

Paste to the Tags Table

In order to create those tags quicker, just copy copy-paste this table

  1. Select the entire table, include the titles (Name, Type, Path, Description)
  2. Open Unified Namespace →Tags
  3. Right-Click on the first row (insertion) row and execute PASTE
    1. if by mistake you left-click, instead of right click, you selected one specific cell to edit
    2. If that happen, either press ESC, or click with the mouse outside the grid area, to close that editing. 
  4. This command will automatically create the Production folder, and the tags.
  5. Navigate to Unified Namespace →Asset Tree to confirm the tags are in the expected folder

3. Create Equipment Tags

For motor control and equipment status:

  1. Create folder: Equipment
  2. Add equipment tags:
NameTypePathDescription
MotorRunningDigitalEquipmentMotor on/off
MotorSpeedDoubleEquipmentMotor RPM
MotorCurrentDoubleEquipmentMotor current (Amps)
MotorHoursDoubleEquipmentRun hours
ConveyorSpeedDoubleEquipmentBelt speed (m/s)


Use similar expedite process you used for the other tags

4. Configure Tag Properties

Set Retentive Values

For production counters:

  1. Select Production_Count
  2. Enable Retentive checkbox
  3. Preserves value through restart


5. Create Motor UserType

Build a reusable template:

  1. Navigate to Unified Namespace → UserTypes
  2. Create new type: MotorType
  3. Add members:
    • Running (Digital)
    • Speed (Double, 0-3600 RPM)
    • Current (Double, 0-100 Amps)
    • Hours (Double, retentive)
    • FaultCode (Integer)
  4. Return to Tags
  5. Create instances:
    • Name: Motor2, Type: MotorType
    • Name: Motor3, Type: MotorType

6. Create System Tags

For scripts and calculations:

NameTypeDescription
System_RunningDigitalSystem status
Calc_AverageDoubleCalculated average
Alarm_CountIntegerActive alarm counter
Report_TriggerDigitalReport generation trigger

7. Test Your Tags

  1. go to Runtime → Startup
  2. Click Run Startup
  3. Open Unified Namespace → Asset Tree
  4. Verify:
    • Tag values 
    • Folder structure visible
    • UserType instances expanded

Explanation - about foundational technologies

→ Platform Overview / Technology / Real-Time Tag Database

→ Platform Overview / Technology / Native Unified Namespace

→ Platform Overview / Technology / TagProvider Services

Explanation - to understand concepts

→ Modules / Data Foundation / Unified Namespace

Tutorials - to learn by doing

→ Tutorials / Data Foundation / Unified Namespace Tutorial

How-to Guides - to accomplish specific tasks

→ How-to Guides / Data Foundation / Unified Namespace How-to Guide

Reference - technical details

→ Technical Reference / Platform Modules / Unified Namespace


In this section...