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
| Property | Typ | Erforderlich | Standard | Beschreibung |
|---|---|---|---|---|
path | string | Nein | $ | Pfad zu einem EnergyData-Objekt mit den neuen Mengen |
existingEnergyQuantitiesPath | string | Ja | - | Pfad zum Array der gespeicherten Energiemengen, z. B. die Zeilen eines Abfrageergebnisses; jedes Element benötigt eine RtId |
energyQuantityFromPath | string | Ja | - | Pfad zum Beginn (From) innerhalb eines Array-Elements |
energyQuantityToPath | string | Ja | - | Pfad zum Ende (To) innerhalb eines Array-Elements |
energyQuantityQualityPath | string | Ja | - | Pfad zur Qualität innerhalb eines Array-Elements (wird gelesen, derzeit aber nicht für die Entscheidung verwendet) |
targetPath | string | Nein | $ | Pfad, an den das Ergebnis geschrieben wird |
Verhalten
- Wird unter
pathkeinEnergyDatagefunden, schreibt der Node nichts. - Alle Zeiten werden in UTC verglichen. Eine gespeicherte Menge überschneidet sich mit einer neuen Menge, wenn
new.To > stored.Fromundnew.From < stored.Togilt. FehltFromoderToeines gespeicherten Elements, wird0001-01-01verwendet. - Gespeicherte Elemente ohne
RtIdwerden ignoriert.
Ausgabe
Das Ergebnis ist ein Paar (Tupel), das mit den Property-Namen Item1 und Item2 geschrieben wird:
| Property | Beschreibung |
|---|---|
Item1 | Array der RtIds gespeicherter Energiemengen, die sich mit einer neuen Menge überschneiden (jede RtId einmal) |
Item2 | Array aller neuen Energiemengen des EnergyData |
Die Konfigurations-Properties sind in der API-Referenz dokumentiert.