Page History

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

Create Tag Expressions

1. Navigate to Scripts → Expressions
2. Add temperature conversion:

Add status logic:

Create Script Task

1. Go to Scripts → Tasks
2. Click plus icon, name: ShiftCounter
3. Use Server.DateTimeInfo.Hour as Trigger
4. Double-click to open Code Editor
5. 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
Enter methods (no class declaration):
csharp
public double CalculateVolume(double level, double diameter)
{
    double radius = diameter / 2;
    return Math.PI * radius * radius * level;
}

public double CalculateFlowRate(double volumeStart, double volumeEnd, int minutes)
{
    if (minutes == 0) return 0;
    return (volumeEnd - volumeStart) / minutes;
}

public string GetStatusText(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
Create volume calculation:
Field
Value
Object
Tag.Tank1_Volume
Expression
Script.Class.TankCalculations.CalculateVolume(Tag.Tank1_Level, 10.5)
Execution
OnChange
Note: No @ symbol needed in expressions
Event-Driven Task
Create task: TemperatureMonitor
Configure trigger on tag change:
csharp
if (@Tag.Tank1_Temp > @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.ServerMain.LogEvent(
        "Temperature Alarm",
        @Tag.Tank1_Temp
    );
}
Configure:
Trigger: Tag.Tank1_Temp
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...