Definición del modelo de ThingWorx en Composer > Modelado > Fragmentos de código > QueryImplementingThingsWithData
QueryImplementingThingsWithData
Descripción
Este servicio se puede utilizar para consultar las cosas que implementan la plantilla de cosa o la definición de cosa en la que se ejecuta el servicio. El resultado es una infotable en la que se incluyen las cosas que implementan la plantilla de cosa o la definición de cosa y los valores de propiedad efectivos de la plantilla de cosa o la definición de cosa en los que se ejecuta la consulta.
Entrada
Nombre del parámetro
Descripción
Tipo base
maxItems
Número máximo de elementos que se devolverán en el conjunto de resultados. El valor por defecto es 500. Este parámetro se aplica después de aplicar todos los otros filtros.
NUMBER
tags
Las etiquetas de modelo asociadas al origen de esta entrada.
TAGS
nameMask
El patrón de nombres para las entidades que implementan la plantilla de cosa o la definición de cosa.
STRING
query
Los criterios de consulta que se utilizan para filtrar los datos.
Los filtros solo se pueden escribir para las propiedades efectivas de la plantilla de cosa o la definición de cosa en la que se ejecuta el servicio.
Para obtener más información, consulte Parámetro de consulta para servicios de consulta.
QUERY
Salida
Nombre del parámetro
Descripción
Tipo base
result
Se devuelve una infotable en la que se incluye la lista de cosas que implementan la plantilla de cosa o la definición de cosa y los valores de propiedad efectivos de la plantilla de cosa o la definición de cosa.
INFOTABLE
Ejemplo
En el siguiente ejemplo, TestStream tiene una definición de datos que tiene los campos Property1, Property2 y Property3.
Entidad
ShapeProp1
ShapeProp2
ShapeProp3
ThingShape1
Definido
N/D
N/D
ThingShape2
N/D
N/D
N/D
ThingShape2
N/D
N/D
Definido
Entidad
Plantilla padre
Prop1
Prop2
Prop3
Prop4
Definición implementada
Propiedades de efectividad
Template1
Definido
N/D
N/D
N/D
ThingShape1
Prop1, ShapeProp1
Template2
Template1
Heredado de Template1
Definido
N/D
N/D
ThingShape2
Prop1,
Prop2,
ShapeProp1,
ShapeProp2
Template3
Template2
Heredado de Template2
Heredado de Template2
Definido
N/D
Prop1,
Prop2,
Prop3,
ShapePropy1,
ShapeProp2
Template4
Template2
Heredado de Template2
Heredado de Template2
N/D
Definido
ThingShape4
Prop1,
Prop2,
Prop4,
ShapeProp1,
ShapeProp2,
ShapeProp4
Entidad
Implementa
Etiquetas de modelo
Prop1
Prop2
Prop3
Prop4
ShapeProp1
ShapeProp2
ShapeProp4
Thing1
Template1
{vocabulary: "MT1", vocabularyTerm: "MT1-MTerm1"}
Val1-1
SVal1-1
Thing2
Template2
{vocabulary: "MT1", vocabularyTerm: "MT1-MTerm1"}
Val2-1
Val2-2
SVal2-1
SVal2-2
Thing3
Template3
{vocabulary: "MT1", vocabularyTerm: "MT1-MTerm1"}
Val3-1
Val3-2
Val3-3
SVal3-1
SVa3l-2
Thing4
Template4
{vocabulary: "MT1", vocabularyTerm: "MT1-MTerm2"}
Val4-1
Val4-2
Val4-4
SVal4-1
SVal3-2
SVal4-4
En el siguiente ejemplo se muestra una consulta para implementar cosas con datos mediante sus parámetros soportados. Con esta llamada a la API, se devuelve una infotable en la que se incluyen el avatar, la descripción, homeMashup, isSystemObject, el nombre, las etiquetas, todas las propiedades definidas en la plantilla de cosa en la que se ejecuta la consulta y la plantilla padre inmediata de las cosas que coinciden con los parámetros de entrada.
En la siguiente consulta, el avatar, la descripción, homeMashup, isSystemObject, el nombre, las etiquetas, Prop1, Prop2, Prop4, ShapeProp1, ShapeProp2, ShapeProp4 y la plantilla padre inmediata de la cosa se devuelven en la infotable.
result = ThingTemplates["Template4"].QueryImplementingThingsWithData({
maxItems: 50 /* NUMBER {"defaultValue":500} */,
nameMask: "T*" /* STRING */,
tags: "MT1:MT1-MTerm1",
query: "{\"filters\":{\"type\": \"LIKE\", \"fieldName\": \"Prop1\", \"value\": \"Val2*\" }}"

});
En la siguiente consulta, el avatar, la descripción, homeMashup, isSystemObject, el nombre, las etiquetas, Prop1 y ShapeProp1 de la cosa se devuelven en la infotable.
result = ThingShapes["ThingShape1"].QueryImplementingThingsWithData({
maxItems: 50 /* NUMBER {"defaultValue":500} */,
nameMask: "T*" /* STRING */,
tags: "MT1:MT1-MTerm1",
query: "{\"filters\":{\"type\": \"LIKE\", \"fieldName\": \"ShapeProp1\", \"value\": \"SVal*\" }}"

});
¿Fue esto útil?