Scripts Module Tutorial

Create Script Expressions, Tasks and Classes.

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

1. Create Tag Expressions

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

Add status logic:

2. Create Script Task

1. Go to Scripts → Tasks
2. Click plus icon, name: ShiftCounter
3. Choose language CSharp
4. Press OK
5. Use Server.DateTimeInfo.Hour as Trigger
6. Double-click to open Code Editor
7. Enter code (no method wrapper):

// Reset counter at shift change
int hour = @Server.DateTimeInfo.Hour;
if (hour == 6 || hour == 14 || hour == 22)
{
        @Tag.Units_Previous = @Tag.Units_Produced;
        @Tag.Units_Produced = 0;
}

3. Build Script Class

1. Navigate to Scripts → Classes
2. Create class: TankCalculations
3. Enter methods (no class declaration):

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";
}

4. Use Class in Expression

1. Go to Scripts → Expressions
2. Create volume calculation:

Note: No @ symbol needed in expressions

Test and Debug

1. Build verification:
   • Check green checkmark in BuildStatus
   • Review BuildErrors if red X
2. Runtime monitoring:
   • Go to Scripts → Scripts Monitor
   • Check Counter
   • Review LastRun
3. Debug with breakpoints:
   • Follow Code Editor Reference and Debugging Scripts Code with Microsoft Visual Studio to debug the code

Scripts Module Links

Explanation - to understand concepts

→ Modules / Business Operations / Scripts Module

Tutorials - to learn by doing

→ Tutorials /  Business Operations / Scripts Module Tutorial

How-to Guides - to accomplish specific tasks

→ How-to Guides / I Business Operations / Scripts Module How-to Guide

Reference - technical details

→ Technical Reference /  Business Operations / Scripts Module Reference

In this section...