Definición del modelo de ThingWorx en Composer > Almacenamiento de datos > Tablas de datos > Servicios de tabla de datos
Servicios de tabla de datos
Hay varios servicios integrados para obtener datos en tablas de datos y fuera de ellas, que son específicos de la definición de tabla de datos. Son las siguientes:
Servicio
Descripción
AddDataTableEntry (TAGS tags, VALUES values)
Permite pasar VALUES y opcionalmente tags. La devolución booleana indica el éxito o el fallo.
AddDataTableEntries
Permite añadir múltiples entradas de tabla de datos.
AddOrUpdateDataTableEntry (TAGS tags, VALUES values)
Permite pasar VALUES y opcionalmente tags. Se devuelve un valor STRING de streamID de la entrada nueva o actualizada en la tabla de datos. Permite actualizar una fila si existe; de lo contrario se añade una fila.
AddOrUpdateDataTableEntries
Permite añadir o actualizar múltiples entradas de tabla de datos. Permite actualizar una fila si existe; de lo contrario se añade una fila. Las claves principales deben coincidir para la actualización.
AssignDataTableEntries
Permite reemplazar entradas de tabla de datos existentes.
DeleteDataTableEntry (STRING keyvalue)
Permite borrar una entrada única en función del valor de clave. La devolución booleana indica el éxito o el fallo.
* 
Se requiere una clave principal para borrar una entrada.
DeleteDataTableEntries
Permite borrar múltiples entradas que coinciden con la primera fila de valores especificados en el parámetro de entrada de infotable. Por ejemplo, si una tabla de datos tiene un campo denominado Int01 y tres entradas tienen Int01 definido en 10. Cuando se ejecute, DeleteDataTableEntries borrará las tres entradas si 10 se especifica como criterio de borrado.
* 
Un error que indica "Invalid Number of values provided to DeleteDataTableEntries in thingName" se muestra si se especifica más de una fila de valores en el parámetro de entrada de infotable.
FindDataTableEntries
Permite buscar solo índices, por lo que puede ser más rápido de utilizar que el servicio QueryDataTableEntries.
* 
Si se define más de un índice en la configuración para la tabla de datos, el índice que se utiliza para la búsqueda se pondera en función de lo que se ha indicado como campos en los que buscar en el parámetro Valores que se pasa en FindDataTableEntries. Por ejemplo, si hay cuatro propiedades (INTEGER, BOOLEAN, STRING y TEXT) y se han creado dos índices (uno en BOOLEAN y STRING y otro en STRING), si solo se especifica un valor en el que buscar para la propiedad TEXT, dicho índice se ponderará más que el índice de BOOLEAN/STRING porque se ha proporcionado un valor para buscar en ese índice.
* 
Solo se acepta un parámetro de entrada de infotable para FindDataTableEntries. No se devuelve ningún resultado si no se proporciona ninguna entrada o se proporciona más de un parámetro de entrada.
GetDataTableEntries (NUMBER maxItems)
Permite devolver las últimas entradas hasta el número máximo de elementos solicitados.
GetDataTableEntry (STRING keyvalue)
Permite devolver una infotable de una fila con la entrada coincidente.
GetFieldNames
Permite devolver una lista de nombres de campos asociados con esta tabla de datos.
PurgeDataTableEntries
Permite eliminar todas las entradas para esta tabla de datos. La devolución booleana indica el éxito o el fallo.
QueryDataTableEntries (NUMBER maxItems, STRING queryExpression, TAGS tags, VALUES query)
Permite devolver una infotable de registros que coinciden con los parámetros de la solicitud.
* 
Solo se acepta un parámetro de entrada de infotable para QueryDataTableEntries.
Si no se proporciona ningún parámetro de entrada, QueryDataTableEntries devuelve todas las filas de la tabla de datos.
Si se proporciona más de un parámetro de entrada, se devuelven las filas que coinciden solo con la primera entrada y se descartarán otras entradas. En este caso, utilice el parámetro de entrada de consulta del servicio.
SearchDataTableEntries
Permite devolver todas las entradas de tabla de datos que coincidan con los parámetros de la consulta de búsqueda. searchExpression es la clave para este servicio y en ella se incluye la búsqueda de texto completo para los campos STRING y TEXT solo. Los siguientes archivadores se pueden utilizar para searchExpression: + (signo más), con distinción entre mayúsculas y minúsculas, ? (signo de interrogación), % (signo de porcentaje), AND y OR.
UpdateDataTableEntry (TAGS tags, VALUES values)
Permite pasar values y opcionalmente tags. La devolución booleana indica el éxito o el fallo. Permite actualizar una fila, si existe.
Definición de distinción entre mayúsculas y minúsculas en búsquedas de tabla de datos
La distinción entre mayúsculas y minúsculas en las búsquedas de tabla de datos se puede definir mediante un filtro en el parámetro query.
Por ejemplo, si se utiliza el servicio SearchDataTableEntries con las siguientes entradas:
Se puede definir un filtro para el parámetro query de manera que se devuelvan resultados con distinción entre mayúsculas y minúsculas. Por ejemplo:
{"filters":{"type":"EQ", "fieldName":"Field1","isCaseSensitive":true, "value":"AA"}}
Al utilizar la consulta anterior, se devuelven los siguientes resultados:
En otro ejemplo en que se utiliza el mismo servicio, mediante el siguiente filtro en el parámetro query:
{"filters":{"type":"EQ", "fieldName":"Field1","isCaseSensitive":true, "value":"aa"}}
.
Se devuelven los resultados siguientes:
¿Fue esto útil?