feat(historian-gateway): HistorianEvent->HistoricalEvent mapper (+ clamped severity)

Claude-Session: https://claude.ai/code/session_012SDSQ3AcaXqPcBtDESBRii
2026-06-26 16:32:38 -04:00
parent c7296d7458
commit a54c7a9366
2 changed files with 107 additions and 0 deletions
@@ -0,0 +1,40 @@
+using Google.Protobuf.WellKnownTypes;
+using Xunit;
+using ZB.MOM.WW.HistorianGateway.Contracts.Grpc;
+using ZB.MOM.WW.OtOpcUa.Driver.Historian.Gateway.Mapping;
+
+namespace ZB.MOM.WW.OtOpcUa.Driver.Historian.Gateway.Tests.Mapping;
+
+public sealed class EventMapperTests
+{
+    [Fact]
+    public void Maps_core_fields_and_times()
+    {
+        var e = new HistorianEvent { Id = "E1", SourceName = "Pump1",
+            EventTime = Ts(2026, 1, 1, 0, 0, 0), ReceivedTime = Ts(2026, 1, 1, 0, 0, 5) };
+        e.Properties["Message"] = "High temp";
+        e.Properties["Severity"] = "700";
+        var h = EventMapper.ToHistoricalEvent(e);
+        Assert.Equal("E1", h.EventId);
+        Assert.Equal("Pump1", h.SourceName);
+        Assert.Equal("High temp", h.Message);
+        Assert.Equal((ushort)700, h.Severity);
+        Assert.Equal(DateTimeKind.Utc, h.EventTimeUtc.Kind);
+    }
+
+    [Theory]
+    [InlineData("Priority", "999", 999)]
+    [InlineData("Severity", "0", 1)]       // clamp to OPC UA min 1
+    [InlineData("Severity", "5000", 1000)] // clamp to OPC UA max 1000
+    [InlineData(null, null, 1)]            // missing → default min severity
+    public void Severity_parsed_and_clamped(string? key, string? val, int expected)
+    {
+        var e = new HistorianEvent { Id = "E", EventTime = Ts(2026, 1, 1, 0, 0, 0), ReceivedTime = Ts(2026, 1, 1, 0, 0, 0) };
+        if (key is not null) e.Properties[key] = val!;
+        Assert.Equal((ushort)expected, EventMapper.ToHistoricalEvent(e).Severity);
+    }
+
+    // Ts(...) builds a Google.Protobuf.WellKnownTypes.Timestamp from UTC parts.
+    private static Timestamp Ts(int y, int mo, int d, int h, int mi, int s)
+        => Timestamp.FromDateTime(new DateTime(y, mo, d, h, mi, s, DateTimeKind.Utc));
+}