Definición del modelo de ThingWorx en Composer > Modelado > Fragmentos de código > GetThingPropertyValues
GetThingPropertyValues
Descripción
GetThingPropertyValues recupera valores de propiedades en bloque para limitar el número de llamadas de caché necesarias para rellenar el conjunto de datos de retorno. Si la propiedad solicitada no se encuentra en la cosa solicitada, se devuelve un valor vacío.
Entradas
Nombre del parámetro
Descripción
BaseType
thingReferences
Una infotable que consta de una lista de cosas.
La definición de datos esperada para la infotable es EntityReference.
INFOTABLE
dataShapeName
Nombre de la definición de datos que encapsula los valores de las propiedades que debe devolver la consulta.
La definición de datos debe existir en el modelo de ThingWorx. La definición de datos puede ser una entidad del sistema o una entidad definida por el usuario.
DATASHAPENAME
Salida
Nombre del parámetro
Descripción
Tipo base
result
Se devuelve una infotable con los valores de las propiedades solicitadas en la definición de datos de cada cosa solicitada en la entrada de thingReferences.
En la definición de datos de la infotable de retorno se incluirá el nombre de la cosa y todas las propiedades de la definición de datos de entrada.
INFOTABLE
Ejemplo
En este ejemplo, se definen tres cosas, una definición de datos y un flujo con propiedades diferentes.
Entidad
Propiedades
Thing1
Property1
Thing2
Property1, Property2
Thing3
Property1, Property2, Property3
TestStream
Property1, Property2, Property3
TestDatashape
Property1, Property3, Property4
A continuación se incluye un código de ejemplo.
// Create a thingRef Infotable with the datashape EntityReference
var thingRefInfoTableParams = {
infoTableName : "InfoTable",
dataShapeName : "EntityReference"
};
var thingRef = Resources["InfoTableFunctions"].CreateInfoTableFromDataShape(thingRefInfoTableParams);
// populate thingRef InfoTable
var thing1Entry = new Object();
thing1Entry.name = "Thing1"; // STRING
thing1Entry.type = "Thing"; // STRING
var thing2Entry = new Object();
thing2Entry.name = "Thing2"; // STRING
thing2Entry.type = "Thing"; // STRING
var thing3Entry = new Object();
thing3Entry.name = "Thing3"; // STRING
thing3Entry.type = "Thing"; // STRING
var streamEntry = new Object();
streamEntry.name = "TestStream"; // STRING
streamEntry.type = "Thing"; // STRING
thingRef.AddRow(thing1Entry);
thingRef.AddRow(thing2Entry);
thingRef.AddRow(thing3Entry);
thingRef.AddRow(streamEntry);
// result: INFOTABLE dataShape: "RootEntityList"
result = Resources["EntityServices"].GetThingPropertyValues({
thingReferences: thingRef /* INFOTABLE */,
dataShapeName: "TestDatashape" /* DATASHAPENAME */
});
En la siguiente tabla se muestra la salida de la consulta anterior. Property4 está vacío, ya que no se ha definido Property4 en ninguna de las cosas solicitadas. Property3 está vacío para Thing1 y Thing2 puesto que no tenían definido Property3.
thingName
Property1
Property3
Property4
Thing1
11
Thing2
21
Thing3
31
33
TestStream
S1
S3
¿Fue esto útil?