Page History

Scripts → Tutorial | Concept | How-to Guide | Reference

Create Tag Expressions

1. Navigate to Scripts → Expressions
2. Add calculated tag:

Temperature Conversion:

1. temperature conversion:

Add status logic:

Conditional Logic:

Create Script Task

1. Go to Scripts → Tasks
2. Add new task:

1. Click plus icon, name: ShiftCounter
2. Use Server.DateTimeInfo.Hour as Trigger
3. Double-click to open Code Editor
4. Enter code (no method wrapper):

csharp

// Reset counter at shift change
DateTimeint nowhour = DateTime@Server.DateTimeInfo.NowHour;
if (now.Hourhour == 6 || now.Hourhour == 14 || now.Hourhour == 22)
{
    if (@Tag.ShiftReset == false)
    {
        @Tag.Units_Previous = @Tag.Units_Produced;
        @Tag.Units_Produced = 0;
        @Tag.ShiftReset = true;
    }
}
else
{
    @Tag.ShiftReset = false;
}

Configure:

Build Script Class
Navigate to Scripts → Classes
Create class: 
TankCalculations
 TankCalculations
Enter methods (no class declaration):
csharp
    public static double CalculateVolume(double level, double diameter)
    {
        double radius = diameter / 2;
        return Math.PI * radius * radius * level;
    }
    
    public static double FlowRateCalculateFlowRate(double volumeStart, double volumeEnd, int minutes)
{
    {
if (minutes == 0) return 0;
    return (volumeEnd - volumeStart) / minutes;
    }
    
    public static string GetAlarmTextGetStatusText(double value, double limit)
    {
        if (value > limit)
            return $"High: {value:F2} (Limit: {limit:F2})";
        else
            return "Normal";
    }
Use Class in Expression
Go to Scripts → Expressions
In tag expressions:
csharp
@Script
Create volume calculation:
Field
Value
Object
Tag.Tank1_Volume
Expression
Script.Class.TankCalculations.CalculateVolume(
@Tag
Tag.Tank1_Level, 
 
 10.5)
Execution
Python Integration
Scripts → Settings
Enable Python
Create Python script:
python
OnChange
Note: No @ symbol needed in expressions
Event-Driven Task
Create task: TemperatureMonitor
Configure trigger on tag change:
csharp
import numpy as np
from datetime import datetime

def calculate_statistics(values):
    """Calculate statistical values"""
    arr = np.array(values)
    return if (@Tag.Tank1_Temp > @Tag.HighLimit)
{
        'mean': np.mean(arr),
        'std': np.std(arr),@Tag.Alarm_Active = true;
        'max': np.max(arr),
        'min': np.min(arr)
    }

def predict_value(history, hours_ahead):
    """Simple linear prediction"""
    # Implementation here
    return predicted_value

# Set tag values
tags['Stats_Mean'] = calculate_statistics(history)['mean']
Event-Driven Scripts
Create event handler:
csharp
// On tag change event
public void OnTemperatureChange()
{
    if (@Tag.Tank1_Temperature > @Tag.HighLimit)
    {
        @Tag.Alarm_Active = true;
    @Tag.Alarm_Message = $"High Temperature: {@Tag.Tank1_Temp:F1}°C";
    @Tag.Alarm_Time = DateTime.Now;
    
    // Log to historian
    @Script.Class.NotificationsServerMain.SendEmail(
            "operator@company.com",
    LogEvent(
        "High Temperature AlertAlarm",
            $"Tank 1: {@Tag.Tank1_Temperature}°C"
    Temp
    );
    }
}
Bind to tagConfigure:
Trigger: Tag: .Tank1_TemperatureTemp
Event: OnValueChange
Script: OnTemperatureChange
Test Scripts
Start Runtime with debugger
Set breakpoints in scripts
Monitor script execution:
Scripts → Monitor
Check execution time
View error messages
Next Steps
[SQL Database Query] - Database integration
[Reports Module] - Automated reporting
[Create Dashboards] - Display calculations
Domain: Server
Add External References
Go to Scripts → References
Add DLL if using external libraries
Open Code Editor
Click Namespace Declarations
Add required namespaces
Test and Debug
Build verification:
Check green checkmark in BuildStatus
Review BuildErrors if red X
Runtime monitoring:
Go to Scripts → Monitor
Check ExecutionCount
Review LastCPUTime
Debug with breakpoints:
Enable debug in Runtime → Build and Publish
Set breakpoints in Code Editor
Attach debugger during runtime

Step-by-step guide to add calculations, automation, and data enrichment to your TankFarm solution using Scripts module capabilities.

In this section...