feat(opcuaserver): Phase7Composer substitutes {{equip}} per equipment

2026-06-10 07:49:28 -04:00
parent f431504825
commit a4b36c54ba
2 changed files with 121 additions and 24 deletions
@@ -0,0 +1,101 @@
+using Shouldly;
+using Xunit;
+using ZB.MOM.WW.OtOpcUa.Configuration.Entities;
+using ZB.MOM.WW.OtOpcUa.Configuration.Enums;
+
+namespace ZB.MOM.WW.OtOpcUa.OpcUaServer.Tests;
+
+/// <summary>
+/// Verifies the live-edit compose seam (<see cref="Phase7Composer.Compose"/>) substitutes the
+/// reserved <c>{{equip}}</c> token in a shared VirtualTag script with each owning equipment's
+/// derived tag base (from its child-tag <c>FullName</c>s) — so one script reused across N
+/// identical machines resolves to N machine-specific dependency graphs.
+/// </summary>
+public sealed class Phase7ComposerEquipTokenTests
+{
+    /// <summary>One shared <see cref="Script"/> using <c>ctx.GetTag("{{equip}}.Source")</c>, bound
+    /// to two equipments (TestMachine_001 / _002) each with one equipment Tag whose FullName carries
+    /// the per-machine base. Compose must expand the token per equipment in both the Expression and
+    /// the parsed DependencyRefs.</summary>
+    [Fact]
+    public void Compose_substitutes_equip_token_per_equipment()
+    {
+        var ns = new Namespace
+        {
+            NamespaceId = "ns-eq",
+            ClusterId = "c1",
+            Kind = NamespaceKind.Equipment,
+            NamespaceUri = "urn:eq",
+        };
+        var driver1 = new DriverInstance
+        {
+            DriverInstanceId = "drv-1",
+            ClusterId = "c1",
+            NamespaceId = "ns-eq",
+            Name = "Modbus1",
+            DriverType = "Modbus",
+            DriverConfig = "{}",
+        };
+        var driver2 = new DriverInstance
+        {
+            DriverInstanceId = "drv-2",
+            ClusterId = "c1",
+            NamespaceId = "ns-eq",
+            Name = "Modbus2",
+            DriverType = "Modbus",
+            DriverConfig = "{}",
+        };
+        var area = new UnsArea { UnsAreaId = "area-1", ClusterId = "c1", Name = "filling" };
+        var line = new UnsLine { UnsLineId = "line-1", UnsAreaId = "area-1", Name = "line-1" };
+        var equip1 = new Equipment { EquipmentId = "eq-1", DriverInstanceId = "drv-1", UnsLineId = "line-1", Name = "TestMachine_001", MachineCode = "TESTMACHINE_001" };
+        var equip2 = new Equipment { EquipmentId = "eq-2", DriverInstanceId = "drv-2", UnsLineId = "line-1", Name = "TestMachine_002", MachineCode = "TESTMACHINE_002" };
+        var tag1 = new Tag
+        {
+            TagId = "tag-1",
+            DriverInstanceId = "drv-1",
+            EquipmentId = "eq-1",
+            Name = "Source",
+            DataType = "Int32",
+            AccessLevel = TagAccessLevel.Read,
+            TagConfig = "{\"FullName\":\"TestMachine_001.Source\",\"DataType\":\"Int32\"}",
+        };
+        var tag2 = new Tag
+        {
+            TagId = "tag-2",
+            DriverInstanceId = "drv-2",
+            EquipmentId = "eq-2",
+            Name = "Source",
+            DataType = "Int32",
+            AccessLevel = TagAccessLevel.Read,
+            TagConfig = "{\"FullName\":\"TestMachine_002.Source\",\"DataType\":\"Int32\"}",
+        };
+        var script = new Script
+        {
+            ScriptId = "s-equip",
+            Name = "over-50",
+            SourceCode = "return System.Convert.ToInt32(ctx.GetTag(\"{{equip}}.Source\").Value) > 50;",
+            SourceHash = "hash-equip",
+        };
+        var vt1 = new VirtualTag { VirtualTagId = "vt-1", EquipmentId = "eq-1", Name = "over50", DataType = "Boolean", ScriptId = "s-equip" };
+        var vt2 = new VirtualTag { VirtualTagId = "vt-2", EquipmentId = "eq-2", Name = "over50", DataType = "Boolean", ScriptId = "s-equip" };
+
+        var result = Phase7Composer.Compose(
+            new[] { area }, new[] { line }, new[] { equip1, equip2 },
+            new[] { driver1, driver2 }, Array.Empty<ScriptedAlarm>(),
+            new[] { tag1, tag2 }, new[] { ns },
+            virtualTags: new[] { vt1, vt2 },
+            scripts: new[] { script });
+
+        result.EquipmentVirtualTags.Count.ShouldBe(2);
+
+        var plan1 = result.EquipmentVirtualTags.Single(p => p.VirtualTagId == "vt-1");
+        plan1.Expression.ShouldContain("ctx.GetTag(\"TestMachine_001.Source\")");
+        plan1.Expression.ShouldNotContain("{{equip}}");
+        plan1.DependencyRefs.ShouldBe(new[] { "TestMachine_001.Source" });
+
+        var plan2 = result.EquipmentVirtualTags.Single(p => p.VirtualTagId == "vt-2");
+        plan2.Expression.ShouldContain("ctx.GetTag(\"TestMachine_002.Source\")");
+        plan2.Expression.ShouldNotContain("{{equip}}");
+        plan2.DependencyRefs.ShouldBe(new[] { "TestMachine_002.Source" });
+    }
+}