Accès aux données d'un flux de valeur à l'aide de services
Les services de flux de valeurs suivants sont accessibles via un objet ou un modèle d'objet. L'accès aux données doit s'effectuer par l'intermédiaire de l'objet qui utilise le flux de valeurs.
Les services à disposition offrent plusieurs façons de récupérer des entrées de flux de valeurs. Vous pouvez par exemple utiliser une propriété journalisée spécifique (QueryBooleanPropertyHistory, QueryDateTimePropertyHistory), un ensemble de propriétés journalisées (QueryNamedPropertyHistory) ou toutes les propriétés journalisées (QueryPropertyHistory).
Lors de la récupération de plusieurs propriétés, ThingWorx exécute un algorithme spécial pour garantir le renvoi d'une table complète synchronisée sans valeurs nulles. Par exemple, si une propriété est journalisée plus souvent qu'une autre propriété, ThingWorx complète les champs vides si les deux propriétés sont récupérées en même temps.
Les données du flux de valeurs ne sont pas supprimées sauf si l'objet ayant créé les données purge de façon explicite les données ou si le flux de valeurs est supprimé. Les données restent intactes si l'objet ou la propriété d'origine est supprimé.
 |
Lorsque vous changez le fournisseur de persistance d'un flux de valeurs (par exemple, de ThingworxPersistenceProvider à PostgreSQL ou InfluxDB), tout objet implémentant un flux de valeurs doit appeler le service RestartThing pour récupérer les entrées écrites sur le nouveau fournisseur de persistance. Si les objets ne sont pas redémarrés, les entrées peuvent être écrites dans la base de données. Elles ne seront cependant pas récupérées tant que l'objet n'aura pas été redémarré.
|
Services de flux de valeurs
|
Service
|
Description
|
|---|---|
|
AddBooleanValueStreamEntry
|
Ajoute une valeur de propriété booléenne dans le flux de valeurs de l'objet.
|
|
AddDateTimeValueStreamEntry
|
Ajoute une valeur de propriété de date et heure dans le flux de valeurs de l'objet.
|
|
AddImageValueStreamEntry
|
Ajoute une valeur de propriété d'image dans le flux de valeurs de l'objet.
|
|
AddInfoTableValueStreamEntry
|
Ajoute une valeur de propriété de table d'informations dans le flux de valeurs de l'objet.
|
|
AddIntegerValueStreamEntry
|
Ajoute une valeur de propriété d'entier dans le flux de valeurs de l'objet.
|
|
AddLocationValueStreamEntry
|
Ajoute une valeur de propriété d'emplacement dans le flux de valeurs de l'objet.
|
|
AddLongValueStreamEntry
|
Ajoute une valeur de propriété de longue valeur dans le flux de valeurs de l'objet.
|
|
AddNumberValueStreamEntry
|
Ajoute une valeur de propriété numérique dans le flux de valeurs de l'objet.
|
|
AddStringValueStreamEntry
|
Ajoute une valeur de propriété de chaîne dans le flux de valeurs de l'objet.
|
|
AddThingCodeValueStreamEntry
|
Ajoute une valeur de propriété de code d'objet dans le flux de valeurs de l'objet.
|
|
AddVec2ValueStreamEntry
|
Ajoute une valeur de propriété vec2 spécifiée (suite de deux valeurs numériques ; coordonnées 2D x et y, par exemple) dans le flux de valeurs de l'objet.
|
|
AddVec3ValueStreamEntry
|
Ajoute une valeur de propriété vec3 spécifiée (suite de trois valeurs numériques ; coordonnées 3D x, y et z, par exemple) dans le flux de valeurs de l'objet.
|
|
AddVec4ValueStreamEntry
|
Ajoute une valeur de propriété vec4 spécifiée (suite de quatre valeurs numériques ; coordonnées 4D x, y, z et w, par exemple) dans le flux de valeurs de l'objet.
|
|
GetLoggedProperties
|
Renvoie une liste des propriétés de l'objet marquées pour la journalisation du flux de valeurs.
|
|
GetNumericLoggedProperties
|
Renvoie une liste des propriétés pour un type de base numérique spécifique.
|
|
GetPropertyLogging
|
QueryBooleanPropertyHistory
|
|
GetValueStream
|
Renvoie le nom du flux de valeurs affecté à l'objet.
|
|
PurgePropertyHistory
|
Supprime toutes les entrées du flux de valeurs pour une propriété dans la plage de dates spécifiée.
|
|
QueryBooleanPropertyHistory
|
Interroge les entrées du flux de valeurs pour les valeurs de propriété booléenne spécifiées de l'objet dans une plage de dates.
|
|
QueryDateTimePropertyHistory
|
Interroge les entrées du flux de valeurs pour les valeurs de propriété de date et heure spécifiées de l'objet.
|
|
QueryImagePropertyHistory
|
Interroge les entrées du flux de valeurs pour les valeurs de propriété d'image spécifiées de l'objet.
|
|
QueryInfoTablePropertyHistory
|
Interroge les entrées du flux de valeurs pour les valeurs de propriété de table d'informations spécifiées de l'objet dans une plage de dates.
|
|
QueryIntegerPropertyHistory
|
Interroge les entrées du flux de valeurs pour les valeurs de propriété d'entier spécifiées de l'objet.
|
|
QueryLocationPropertyHistory
|
Interroge les entrées du flux de valeurs pour les valeurs de propriété d'emplacement spécifiées de l'objet dans une plage de temps donnée.
|
|
QueryLongPropertyHistory
|
Interroge les entrées du flux de valeurs pour les valeurs de propriété de valeur longue spécifiées de l'objet.
|
|
QueryNamedPropertyHistory
|
Interroge les entrées du flux de valeurs pour une valeur de propriété journalisée spécifiée, avec des critères de filtre et de tri, et normalise le jeu de données pour afficher les résultats pour une plage de temps donnée.
|
|
QueryNumberPropertyHistory
|
Interroge le flux de valeurs pour les valeurs de propriété numérique spécifiées de l'objet dans une plage de temps donnée.
|
|
Interroge le flux de valeurs pour des valeurs de propriété journalisée, avec des critères de filtrage et de tri, et normalise l'ensemble des données pour afficher les résultats pour une plage de temps donnée.
|
|
|
QueryStringPropertyHistory
|
Interroge le flux de valeurs pour les valeurs de propriété de chaîne spécifiées de l'objet dans une plage de temps donnée.
|
|
QueryThingCodePropertyHistory
|
Interroge les entrées du flux de valeurs pour les valeurs de propriété de code d'objet (représentation numérique d'un objet contenant un ID de domaine et un ID d'instance) spécifiées de l'objet.
|
|
QueryVec2PropertyHistory
|
Interroge les entrées du flux de valeurs pour les valeurs de propriété vec2 (suite de deux valeurs numériques ; coordonnées 2D x et y, par exemple) spécifiées de l'objet.
|
|
QueryVec3PropertyHistory
|
Interroge les entrées du flux de valeurs pour les valeurs de propriété vec3 (suite de trois valeurs numériques ; coordonnées 3D x, y et z, par exemple) spécifiées de l'objet.
|
|
QueryVec4PropertyHistory
|
Interroge les entrées du flux de valeurs pour les valeurs de propriété vec4 (suite de quatre valeurs numériques ; coordonnées 4D x, y, z et w, par exemple) spécifiées de l'objet.
|
|
SetPropertyLogging
|
Active ou désactive la journalisation pour une propriété spécifiée.
|
|
SetValueStream
|
Définit le flux de valeurs de l'objet.
|