ThingWorx Modelldefinition in Composer > Datenspeicher > Wert-Streams > Auf Wert-Stream-Daten mit Diensten zugreifen
Auf Wert-Stream-Daten mit Diensten zugreifen
Die folgenden Wert-Stream-Dienste sind über ein Ding oder eine Dingvorlage verfügbar. Die Daten müssen über das Ding zugänglich sein, das den Wert-Stream verwendet.
Sie können Wert-Stream-Einträge in einer Vielzahl von Arten und Weisen mit den bereitgestellten Diensten abrufen. Beispielsweise können Einträge von einer bestimmten protokollierten Eigenschaft (QueryBooleanPropertyHistory), (QueryDateTimePropertyHistory), einem Satz protokollierter Eigenschaften (QueryNamedPropertyHistory) oder allen protokollierten Eigenschaften (QueryPropertyHistory) abgerufen werden.
Wenn Sie mehrere Eigenschaften abrufen, führt ThingWorx einen speziellen Algorithmus aus, um sicherzustellen, dass eine vollständige synchrone Tabelle ohne Nullen zurückgegeben wird. Wenn eine Eigenschaft beispielsweise häufiger als eine andere Eigenschaft protokolliert wird, füllt ThingWorx die Leerstellen, wenn beide Eigenschaften gleichzeitig abgerufen werden.
Wert-Stream-Daten werden nicht gelöscht, es sei denn, das Ding, das die Daten erstellt hat, löscht die Daten explizit, oder der Wert-Stream wird gelöscht. Daten bleiben intakt, wenn das ursprüngliche Ding oder die ursprüngliche Eigenschaft gelöscht wird.
* 
Wenn Sie den Persistenzanbieter eines Wert-Streams wechseln (beispielsweise von ThingworxPersistenceProvider zu PostgreSQL oder InfluxDB), muss jedes Ding, das einen Wert-Stream implementiert, den Dienst RestartThing aufrufen, um in den neuen Persistenzanbieter geschriebene Einträge abrufen zu können. Wenn die Dinge nicht neu gestartet werden, werden die Einträge eventuell in die Datenbank geschrieben; sie werden jedoch erst abgerufen, wenn das Ding neu gestartet wurde.
Wert-Stream-Dienste
Dienst
Beschreibung
AddBooleanValueStreamEntry
Fügt dem Wert-Stream für das Ding einen booleschen Eigenschaftswert hinzu.
AddDateTimeValueStreamEntry
Fügt dem Wert-Stream für das Ding einen DateTime-Eigenschaftswert hinzu.
AddImageValueStreamEntry
Fügt dem Wert-Stream für das Ding einen Image-Eigenschaftswert hinzu.
AddInfoTableValueStreamEntry
Fügt dem Wert-Stream für das Ding einen Infotable-Eigenschaftswert hinzu.
AddIntegerValueStreamEntry
Fügt dem Wert-Stream für das Ding einen Integer-Eigenschaftswert hinzu.
AddLocationValueStreamEntry
Fügt dem Wert-Stream für das Ding einen Location-Eigenschaftswert hinzu.
AddLongValueStreamEntry
Fügt dem Wert-Stream für das Ding einen Long Value-Eigenschaftswert hinzu.
AddNumberValueStreamEntry
Fügt dem Wert-Stream für das Ding einen Number-Eigenschaftswert hinzu.
AddStringValueStreamEntry
Fügt dem Wert-Stream für das Ding einen String-Eigenschaftswert hinzu.
AddThingCodeValueStreamEntry
Fügt dem Wert-Stream für das Ding einen ThingCode-Eigenschaftswert hinzu.
AddVec2ValueStreamEntry
Fügt dem Wert-Stream für das Ding einen angegebenen vec2-Eigenschaftswert (eine Sammlung von zwei Zahlen, z.B. 2D-Koordinaten x und y) hinzu.
AddVec3ValueStreamEntry
Fügt dem Wert-Stream für das Ding einen angegebenen vec3-Eigenschaftswert (eine Sammlung von drei Zahlen, z.B. 3D-Koordinaten x, y und z) hinzu.
AddVec4ValueStreamEntry
Fügt dem Wert-Stream für das Ding einen angegebenen vec4-Eigenschaftswert (eine Sammlung von vier Zahlen, z.B. 4D-Koordinaten x, y, z und w) hinzu.
GetLoggedProperties
Gibt eine Liste der Eigenschaften des Dings zurück, die für die Wert-Stream-Protokollierung markiert sind.
GetNumericLoggedProperties
Gibt eine Liste der Eigenschaften für einen angegebenen numerischen Basistyp zurück.
GetPropertyLogging
QueryBooleanPropertyHistory
GetValueStream
Gibt den Namen des Wert-Streams zurück, der dem Ding zugewiesen ist.
PurgePropertyHistory
Löscht alle Wert-Stream-Einträge für eine Eigenschaft innerhalb des angegebenen Datumsbereichs.
QueryBooleanPropertyHistory
Fragt die Wert-Stream-Einträge für die angegebenen Booleschen Eigenschaftswerte innerhalb eines Datumsbereichs für das Ding ab.
QueryDateTimePropertyHistory
Fragt die Wert-Stream-Einträge für die angegebenen DateTime-Eigenschaftswerte des Dings ab.
QueryImagePropertyHistory
Fragt die Wert-Stream-Einträge für die angegebenen Image-Eigenschaftswerte des Dings ab.
QueryInfoTablePropertyHistory
Fragt die Wert-Stream-Einträge für die angegebenen Infotable-Eigenschaftswerte innerhalb eines Datumsbereichs für das Ding ab.
QueryIntegerPropertyHistory
Fragt die Wert-Stream-Einträge für die angegebenen Integer-Eigenschaftswerte des Dings ab.
QueryLocationPropertyHistory
Fragt die Wert-Stream-Einträge für die angegebenen Location-Eigenschaftswerte innerhalb eines angegebenen Zeitbereichs für das Ding ab.
QueryLongPropertyHistory
Fragt die Wert-Stream-Einträge für die angegebenen Long-Eigenschaftswerte des Dings ab.
QueryNamedPropertyHistory
Fragt die Wert-Stream-Einträge für einen angegebenen protokollierten Eigenschaftswert zusammen mit Filter- und Sortierkriterien ab und normalisiert den Datensatz, um Ergebnisse für einen bestimmten Zeitbereich anzuzeigen.
QueryNumberPropertyHistory
Fragt den Wert-Stream für die angegebenen Number-Eigenschaftswerte innerhalb eines angegebenen Zeitbereichs für das Ding ab.
Fragt den Wert-Stream für protokollierte Eigenschaftswerte zusammen mit Filter- und Sortierkriterien ab und normalisiert den Datensatz, um Ergebnisse für einen bestimmten Zeitbereich anzuzeigen.
QueryStringPropertyHistory
Fragt den Wert-Stream für die angegebenen String-Eigenschaftswerte innerhalb eines angegebenen Zeitbereichs für das Ding ab.
QueryThingCodePropertyHistory
Fragt die Wert-Stream-Einträge für die angegebenen ThingCode-Eigenschaftswerte (eine numerische Darstellung eines Dings mit einer Domänen-ID und Instanz-ID) des Dings ab.
QueryVec2PropertyHistory
Fragt die Wert-Stream-Einträge für den angegebenen vec2-Eigenschaftswerts (eine Sammlung von zwei Zahlen, z.B. 2D-Koordinaten x und y) des Dings ab.
QueryVec3PropertyHistory
Fragt die Wert-Stream-Einträge für den angegebenen vec3-Eigenschaftswerts (eine Sammlung von drei Zahlen, z.B. 3D-Koordinaten x, y und z) des Dings ab.
QueryVec4PropertyHistory
Fragt die Wert-Stream-Einträge für den angegebenen vec4-Eigenschaftswerts (eine Sammlung von vier Zahlen, z.B. 4D-Koordinaten x, y, z und w) des Dings ab.
SetPropertyLogging
Aktiviert/deaktiviert die Protokollierung für eine angegebene Eigenschaft.
SetValueStream
Legt den Wert-Stream für das Ding fest.
War dies hilfreich?