Accesso ai dati dello stream di valori mediante servizi
I servizi dello stream di valori riportati di seguito sono disponibili tramite un oggetto o un modello di oggetto. I dati devono essere accessibili tramite l'oggetto che utilizza lo stream di valori.
È possibile recuperare le voci dello stream di valori in vari modi utilizzando i servizi forniti. Ad esempio è possibile recuperare le voci in base a una specifica proprietà registrata (QueryBooleanPropertyHistory, QueryDateTimePropertyHistory), un insieme di proprietà registrate (QueryNamedPropertyHistory) o tutte le proprietà registrate (QueryPropertyHistory).
Durante il recupero di più proprietà, ThingWorx esegue un algoritmo speciale per garantire la restituzione di una tabella completa sincronizzata senza valori Null. Se, ad esempio, una proprietà viene registrata più frequentemente di un'altra, ThingWorx compila i campi vuoti se entrambe le proprietà vengono immediatamente recuperate.
I dati dello stream di valori non vengono eliminati, a meno che l'oggetto che ha creato i dati in modo esplicito non elimini i dati o non venga eliminato lo stream di valori. I dati rimangono invariati se viene eliminato l'oggetto originario o la proprietà.
 |
In caso di cambiamento del provider di persistenza di uno stream di valori (ad esempio, da ThingworxPersistenceProvider a PostgreSQL o InfluxDB), qualsiasi oggetto che implementi uno stream di valori deve chiamare il servizio RestartThing per recuperare le voci scritte nel nuovo provider di persistenza. Se gli oggetti non vengono riavviati, le voci potrebbero essere scritte nel database, ma non vengono recuperate fino al riavvio degli oggetti.
|
Servizi di uno stream di valori
|
Servizio
|
Descrizione
|
|---|---|
|
AddBooleanValueStreamEntry
|
Aggiunge un valore di proprietà booleana nello stream di valori per l'oggetto. A partire da ThingWorx 9.5, è possibile includere anche informazioni sulla qualità.
|
|
AddDateTimeValueStreamEntry
|
Aggiunge un valore di proprietà data e ora allo stream di valori per l'oggetto. A partire da ThingWorx 9.5, è possibile includere anche informazioni sulla qualità.
|
|
AddImageValueStreamEntry
|
Aggiunge un valore di proprietà immagine allo stream di valori per l'oggetto. A partire da ThingWorx 9.5, è possibile includere anche informazioni sulla qualità.
|
|
AddInfoTableValueStreamEntry
|
Aggiunge un valore di proprietà infotable allo stream di valori per l'oggetto. A partire da ThingWorx 9.5, è possibile includere anche informazioni sulla qualità.
|
|
AddIntegerValueStreamEntry
|
Aggiunge un valore di proprietà numero intero allo stream di valori per l'oggetto. A partire da ThingWorx 9.5, è possibile includere anche informazioni sulla qualità.
|
|
AddLocationValueStreamEntry
|
Aggiunge un valore di proprietà di ubicazione allo stream di valori per l'oggetto. A partire da ThingWorx 9.5, è possibile includere anche informazioni sulla qualità.
|
|
AddLongValueStreamEntry
|
Aggiunge un valore di proprietà di tipo Long allo stream di valori per l'oggetto. A partire da ThingWorx 9.5, è possibile includere anche informazioni sulla qualità.
|
|
AddNumberValueStreamEntry
|
Aggiunge un valore di proprietà numero allo stream di valori per l'oggetto. A partire da ThingWorx 9.5, è possibile includere anche informazioni sulla qualità.
|
|
AddStringValueStreamEntry
|
Aggiunge un valore di proprietà stringa allo stream di valori per l'oggetto. A partire da ThingWorx 9.5, è possibile includere anche informazioni sulla qualità.
|
|
AddThingCodeValueStreamEntry
|
Aggiunge un valore di proprietà thingcode allo stream di valori per l'oggetto. A partire da ThingWorx 9.5, è possibile includere anche informazioni sulla qualità.
|
|
AddVec2ValueStreamEntry
|
Aggiunge un valore di proprietà vec2 (raccolta di due numeri, ad esempio le coordinate 2D x e y) specificato allo stream di valori per l'oggetto. A partire da ThingWorx 9.5, è possibile includere anche informazioni sulla qualità.
|
|
AddVec3ValueStreamEntry
|
Aggiunge un valore di proprietà vec3 (raccolta di tre numeri, ad esempio le coordinate 3D x, y e z) specificato allo stream di valori dell'oggetto. A partire da ThingWorx 9.5, è possibile includere anche informazioni sulla qualità.
|
|
AddVec4ValueStreamEntry
|
Aggiunge un valore di proprietà vec4 (raccolta di quattro numeri, ad esempio le coordinate 4D x, y, z e w) specificato allo stream di valori per l'oggetto. A partire da ThingWorx 9.5, è possibile includere anche informazioni sulla qualità.
|
|
GetLoggedProperties
|
Restituisce un elenco delle proprietà dell'oggetto contrassegnate per la registrazione dello stream di valori.
|
|
GetNumericLoggedProperties
|
Restituisce un elenco delle proprietà per un tipo di base numerico specificato.
|
|
GetPropertyLogging
|
QueryBooleanPropertyHistory
|
|
GetValueStream
|
Restituisce il nome dello stream di valori assegnato all'oggetto.
|
|
PurgePropertyHistory
|
Elimina tutte le voci dello stream di valori per una proprietà nell'intervallo di date specificato.
|
|
QueryBooleanPropertyHistory
|
Interroga le voci dello stream di valori per i valori delle proprietà booleane specificati in un intervallo di date per l'oggetto. A partire da ThingWorx 9.5, è possibile filtrare anche in base alla qualità.
|
|
QueryDateTimePropertyHistory
|
Interroga le voci dello stream di valori per i valori delle proprietà di data e ora specificati dell'oggetto. A partire da ThingWorx 9.5, è possibile filtrare anche in base alla qualità.
|
|
QueryImagePropertyHistory
|
Interroga le voci dello stream di valori per i valori delle proprietà di immagine specificati dell'oggetto. A partire da ThingWorx 9.5, è possibile filtrare anche in base alla qualità.
|
|
QueryInfoTablePropertyHistory
|
Interroga le voci dello stream di valori per i valori delle proprietà di infotable specificati in un intervallo di date per l'oggetto. A partire da ThingWorx 9.5, è possibile filtrare anche in base alla qualità.
|
|
QueryIntegerPropertyHistory
|
Interroga le voci dello stream di valori per i valori delle proprietà di integer specificati dell'oggetto. A partire da ThingWorx 9.5, è possibile filtrare anche in base alla qualità.
|
|
QueryLocationPropertyHistory
|
Interroga le voci dello stream di valori per i valori delle proprietà di ubicazione specificati dell'oggetto in un intervallo di tempo specificato. A partire da ThingWorx 9.5, è possibile filtrare anche in base alla qualità.
|
|
QueryLongPropertyHistory
|
Interroga le voci dello stream di valori per i valori delle proprietà di tipo Long specificati dell'oggetto. A partire da ThingWorx 9.5, è possibile filtrare anche in base alla qualità.
|
|
QueryNamedPropertyHistory
|
Interroga le voci dello stream di valori per un valore di proprietà registrato specificato e i criteri di filtro e ordinamento e normalizza l'insieme di dati per visualizzare i risultati per un determinato intervallo di tempo. A partire da ThingWorx 9.5, è possibile filtrare le voci dello stream di valori in base alla qualità e visualizzare anche la qualità nei risultati.
|
|
QueryNumberPropertyHistory
|
Interroga lo stream di valori per i valori delle proprietà di numero specificati dell'oggetto in un intervallo di tempo specificato. A partire da ThingWorx 9.5, è possibile filtrare anche in base alla qualità.
|
|
Interroga lo stream di valori per i valori delle proprietà registrati e i criteri di filtro e ordinamento e normalizza l'insieme di dati per visualizzare i risultati per un determinato intervallo di tempo. A partire da ThingWorx 9.5, è possibile filtrare le voci dello stream di valori in base alla qualità e visualizzare anche la qualità nei risultati.
|
|
|
QueryStringPropertyHistory
|
Interroga lo stream di valori per i valori delle proprietà di stringa specificati dell'oggetto in un intervallo di tempo specificato. A partire da ThingWorx 9.5, è possibile filtrare anche in base alla qualità.
|
|
QueryThingCodePropertyHistory
|
Interroga le voci dello stream di valori per i valori delle proprietà thingcode (rappresentazione numerica di un oggetto contenente un ID dominio e un ID istanza) specificati dell'oggetto. A partire da ThingWorx 9.5, è possibile filtrare anche in base alla qualità.
|
|
QueryVec2PropertyHistory
|
Interroga le voci dello stream di valori per i valori delle proprietà vec2 (raccolta di due numeri, ad esempio le coordinate 2D x e y) specificati dell'oggetto. A partire da ThingWorx 9.5, è possibile filtrare anche in base alla qualità.
|
|
QueryVec3PropertyHistory
|
Interroga le voci dello stream di valori per i valori delle proprietà vec3, ad esempio le coordinate 3D x, y e z) specificati dell'oggetto. A partire da ThingWorx 9.5, è possibile filtrare anche in base alla qualità.
|
|
QueryVec4PropertyHistory
|
Interroga le voci dello stream di valori per i valori delle proprietà vec4, ad esempio le coordinate 4D x, y, z e w) specificati dell'oggetto. A partire da ThingWorx 9.5, è possibile filtrare anche in base alla qualità.
|
|
SetPropertyLogging
|
Attiva o disattiva la registrazione per una proprietà specificata.
|
|
SetValueStream
|
Imposta lo stream di valori per l'oggetto.
|