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.
|
|
|
Al filtrar datos de flujo de los flujos de valor DSE, la fecha de fin no es inclusiva. Por ejemplo, si se consultan entradas y se define la fecha de fin en la fecha y hora exactas de la última entrada, la última entrada no se incluirá en los resultados.
|
Servicios de flujo de valor
• 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
Se determina si se registra una propiedad.
• 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.
• 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 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.
Se consulta en el flujo de valor cada valor de propiedad registrado de la cosa en un intervalo de tiempo especificado.
• QueryStringPropertyHistory
Se consulta en el flujo de valor, los valores especificados de propiedad de cadena de la cosa en un rango de tiempo especificado.
• SetPropertyLogging
Se activa o desactiva el registro para una propiedad especificada.
• SetValueStream
Se define el flujo de valor de la cosa.