Acceso a datos de flujo de valor mediante servicios
Los siguientes servicios de flujo de valor están disponibles a través de una cosa o una plantilla de cosa. Se debe acceder a los datos a través de la cosa que utiliza el flujo de valor.
Se pueden recuperar entradas de flujo de valor de una variedad de maneras con los servicios proporcionados. Por ejemplo, se pueden recuperar entradas por una propiedad registrada específica (QueryBooleanPropertyHistory), (QueryDateTimePropertyHistory), un conjunto de propiedades registradas (QueryNamedPropertyHistory) o todas las propiedades registradas (QueryPropertyHistory).
Al recuperar varias propiedades, ThingWorx ejecuta un algoritmo especial para asegurarse de que se devuelva una tabla completa que no está sincronizada con ningún nulo. Por ejemplo, si una propiedad se registra más a menudo que otra propiedad, ThingWorx completa los espacios en blanco si las dos propiedades se recuperan a la vez.
Los datos de flujo de valor no se borran, a menos que la cosa que haya creado los datos los depure explícitamente o se borre el flujo de valor. Los datos permanecen intactos si se borra la cosa o la propiedad de origen.
 |
Al cambiar el proveedor de persistencia de un flujo de valor (por ejemplo, de ThingworxPersistenceProvider a PostgreSQL o InfluxDB), cualquier cosa que implemente un flujo de valor debe llamar al servicio RestartThing para recuperar las entradas escritas en el nuevo proveedor de persistencia. Si las cosas no se reinician, las entradas se pueden escribir en la base de datos; sin embargo, no se recuperarán hasta que se reinicie la cosa.
|
Servicios de flujo de valor
|
Servicio
|
Descripción
|
|---|---|
|
AddBooleanValueStreamEntry
|
Permite añadir un valor de propiedad booleana en el flujo de valor de la cosa.
|
|
AddDateTimeValueStreamEntry
|
Permite añadir un valor de propiedad de fecha y hora en el flujo de valor para la cosa.
|
|
AddImageValueStreamEntry
|
Permite añadir un valor de propiedad de imagen en el flujo de valor de la cosa.
|
|
AddInfoTableValueStreamEntry
|
Permite añadir un valor de propiedad de infotable en el flujo de valor de la cosa.
|
|
AddIntegerValueStreamEntry
|
Permite añadir un valor de propiedad de entero en el flujo de valor de la cosa.
|
|
AddLocationValueStreamEntry
|
Permite añadir un valor de propiedad de ubicación en el flujo de valor para la cosa.
|
|
AddLongValueStreamEntry
|
Permite añadir un valor de propiedad de valor largo en el flujo de valor de la cosa.
|
|
AddNumberValueStreamEntry
|
Permite añadir un valor de propiedad de número en el flujo de valor para la cosa.
|
|
AddStringValueStreamEntry
|
Permite añadir un valor de propiedad de cadena en el flujo de valor de la cosa.
|
|
AddThingCodeValueStreamEntry
|
Permite añadir un valor de propiedad de código de cosa en el flujo de valor de la cosa.
|
|
AddVec2ValueStreamEntry
|
Permite añadir un objeto vec2 especificado (una recopilación de dos números. Por ejemplo, el valor de la propiedad X e Y de las coordenadas 2D) en el flujo de valor de la cosa.
|
|
AddVec3ValueStreamEntry
|
Permite añadir un objeto vec3 especificado (una recopilación de tres números. Por ejemplo, el valor de propiedad X, Y y Z de las coordenadas 3D) en el flujo de valor de la cosa.
|
|
AddVec4ValueStreamEntry
|
Añade un objeto vec4 especificado (una recopilación de cuatro números. Por ejemplo, el valor de la propiedad X, Y, Z y W de las coordenadas 4D) en el flujo de valor de la cosa.
|
|
GetLoggedProperties
|
Se devuelve una lista de las propiedades de la cosa marcadas para el registro del flujo de valor.
|
|
GetNumericLoggedProperties
|
Se devuelve una lista de propiedades para un tipo base numérico especificado.
|
|
GetPropertyLogging
|
QueryBooleanPropertyHistory
|
|
GetValueStream
|
Se devuelve el nombre del flujo de valor asignado a la cosa.
|
|
PurgePropertyHistory
|
Se borran todas las entradas del flujo de valor para una propiedad dentro del rango de fechas especificado.
|
|
QueryBooleanPropertyHistory
|
Se consulta en las entradas del flujo de valor, los valores de propiedad booleana especificados dentro de un rango de fechas de la cosa.
|
|
QueryDateTimePropertyHistory
|
Se consulta en las entradas del flujo de valor, los valores especificados de propiedad de fecha y hora de la cosa.
|
|
QueryImagePropertyHistory
|
Se consulta en las entradas del flujo de valor, los valores especificados de propiedad de imagen de la cosa.
|
|
QueryInfoTablePropertyHistory
|
Se consulta en las entradas del flujo de valor, los valores especificados de propiedad de infotable dentro de un rango de fechas de la cosa.
|
|
QueryIntegerPropertyHistory
|
Se consulta en las entradas del flujo de valor, los valores especificados de propiedad de entero de la cosa.
|
|
QueryLocationPropertyHistory
|
Se consulta en las entradas del flujo de valor, los valores especificados de propiedad de ubicación de la cosa dentro de un rango de tiempo especificado.
|
|
QueryLongPropertyHistory
|
Se consulta en las entradas del flujo de valor, los valores especificados de propiedad largos de la cosa.
|
|
QueryNamedPropertyHistory
|
Se consulta en las entradas de flujo de valor, un valor de propiedad registrado especificado, junto con los criterios de filtro y clasificación, y se normaliza el conjunto de datos para mostrar los resultados de un rango de tiempo determinado.
|
|
QueryNumberPropertyHistory
|
Se consulta en el flujo de valor, los valores especificados de propiedad de número de la cosa en un rango de tiempo especificado.
|
|
Se consulta en el flujo de valor, los valores de propiedad registrados, junto con los criterios de filtro y clasificación, y se normaliza el conjunto de datos para mostrar los resultados de un rango de tiempo determinado.
|
|
|
QueryStringPropertyHistory
|
Se consulta en el flujo de valor, los valores especificados de propiedad de cadena de la cosa en un rango de tiempo especificado.
|
|
QueryThingCodePropertyHistory
|
Se consulta en las entradas del flujo de valor, el código de cosa especificado (una representación numérica de una cosa que contiene un ID de dominio e ID de instancia) de la cosa.
|
|
QueryVec2PropertyHistory
|
Se consulta en las entradas del flujo de valor, el objeto vec2 especificado (una recopilación de dos números. Por ejemplo, los valores de propiedad X e Y de las coordenadas 2D) de la cosa.
|
|
QueryVec3PropertyHistory
|
Se consulta en las entradas del flujo de valor, el objeto vec3 especificado (una recopilación de tres números. Por ejemplo, los valores de propiedad X, Y y Z de coordenadas 3D) de la cosa.
|
|
QueryVec4PropertyHistory
|
Se consulta en las entradas del flujo de valor, el objeto vec4 especificado (una recopilación de cuatro números. Por ejemplo, los valores de propiedad X, Y, Z y W de coordenadas 4D) de la cosa.
|
|
SetPropertyLogging
|
Se activa o desactiva el registro para una propiedad especificada.
|
|
SetValueStream
|
Se define el flujo de valor de la cosa.
|