Zum Hauptinhalt springen

SearchExistingEnergyQuantities@1

Der Node SearchExistingEnergyQuantities@1 vergleicht neue Energiedaten mit Energiemengen, die bereits in der Runtime gespeichert sind. Er liefert die RtIds aller gespeicherten Mengen, deren Zeitraum sich mit einer neuen Menge überschneidet (damit sie gelöscht werden können), zusammen mit den neuen Mengen (damit sie eingefügt werden können).

Adapter-Voraussetzungen​

Node-Konfiguration​

Zu den Feldern path, targetPath, targetValueWriteMode und targetValueKind siehe Überblick.

transformations:
- type: SearchExistingEnergyQuantities@1
path: $.energyData # one EnergyData object
existingEnergyQuantitiesPath: $.existing.Rows # stored energy quantities (query result rows)
energyQuantityFromPath: $.Values[0] # 'From' within one row
energyQuantityToPath: $.Values[1] # 'To' within one row
energyQuantityQualityPath: $.Values[2] # 'Quality' within one row
targetPath: $.changes
PropertyTypErforderlichStandardBeschreibung
pathstringNein$Pfad zu einem EnergyData-Objekt mit den neuen Mengen
existingEnergyQuantitiesPathstringJa-Pfad zum Array der gespeicherten Energiemengen, z. B. die Zeilen eines Abfrageergebnisses; jedes Element benötigt eine RtId
energyQuantityFromPathstringJa-Pfad zum Beginn (From) innerhalb eines Array-Elements
energyQuantityToPathstringJa-Pfad zum Ende (To) innerhalb eines Array-Elements
energyQuantityQualityPathstringJa-Pfad zur Qualität innerhalb eines Array-Elements (wird gelesen, derzeit aber nicht für die Entscheidung verwendet)
targetPathstringNein$Pfad, an den das Ergebnis geschrieben wird

Verhalten​

  • Wird unter path kein EnergyData gefunden, schreibt der Node nichts.
  • Alle Zeiten werden in UTC verglichen. Eine gespeicherte Menge überschneidet sich mit einer neuen Menge, wenn new.To > stored.From und new.From < stored.To gilt. Fehlt From oder To eines gespeicherten Elements, wird 0001-01-01 verwendet.
  • Gespeicherte Elemente ohne RtId werden ignoriert.

Ausgabe​

Das Ergebnis ist ein Paar (Tupel), das mit den Property-Namen Item1 und Item2 geschrieben wird:

PropertyBeschreibung
Item1Array der RtIds gespeicherter Energiemengen, die sich mit einer neuen Menge überschneiden (jede RtId einmal)
Item2Array aller neuen Energiemengen des EnergyData

Die Konfigurations-Properties sind in der API-Referenz dokumentiert.