Enhanced ExtEmDataConnection with simulateInternal method

Author: staudtMarius

CHANGELOG.md

@@ -7,6 +7,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased/Snapshot]
 
 ### Added
+- Enhanced `ExtEmDataConnection` with `simulateInternal` method [#398](https://github.com/ie3-institute/simonaAPI/issues/398)
 
 ### Changed
 

src/main/java/edu/ie3/simona/api/data/connection/ExtEmDataConnection.java

@@ -32,6 +32,16 @@ public List<UUID> getControlledEms() {
     return new ArrayList<>(controlled);
   }
 
+  /**
+   * Tells the em service in SIMONA to simulate the given tick internally. This should be used, when
+   * the external simulation will not provide data for the tick.
+   *
+   * @param tick that should be simulated internally
+   */
+  public void simulateInternal(long tick) {
+    sendExtMsg(new EmSimulationInternal(tick));
+  }
+
   /**
    * Tries to send em data to SIMONA. A message is sent, if the map is not empty.
    *

src/main/java/edu/ie3/simona/api/ontology/em/EmSimulationInternal.java

@@ -0,0 +1,14 @@
+/*
+ * © 2025. TU Dortmund University,
+ * Institute of Energy Systems, Energy Efficiency and Energy Economics,
+ * Research group Distribution grid planning and operation
+ */
+
+package edu.ie3.simona.api.ontology.em;
+
+/**
+ * Request send to SIMONA to simulate ems internally for the given tick.
+ *
+ * @param tick for which the em service should simulate internally
+ */
+public record EmSimulationInternal(long tick) implements EmDataMessageFromExt {}

src/test/groovy/edu/ie3/simona/api/data/connection/ExtEmDataConnectionTest.groovy

@@ -30,6 +30,24 @@ class ExtEmDataConnectionTest extends Specification implements DataServiceTestDa
         testKit = null
     }
 
+    def "ExtEmDataConnection should sent request to simulate internally correctly"() {
+        given:
+        def dataService = testKit.createTestProbe(DataMessageFromExt)
+        def extSimAdapter = testKit.createTestProbe(ScheduleDataServiceMessage)
+        def extEmDataConnection = new ExtEmDataConnection(controlled, EmMode.BASE)
+        extEmDataConnection.setActorRefs(
+                dataService.ref(),
+                extSimAdapter.ref()
+        )
+
+        when:
+        extEmDataConnection.simulateInternal(800L)
+
+        then:
+        dataService.expectMessage(new EmSimulationInternal(800L))
+        extSimAdapter.expectMessage(new ScheduleDataServiceMessage(dataService.ref()))
+    }
+
     def "ExtEmDataConnection should provide em data correctly"() {
         given:
         def dataService = testKit.createTestProbe(DataMessageFromExt)