Definizione del modello ThingWorx in Composer > Modellazione > Snippet di codice > QueryImplementingThingsWithData
QueryImplementingThingsWithData
Descrizione
È possibile utilizzare questo servizio per interrogare gli oggetti che implementano il modello di oggetto o la thing shape per cui viene eseguito il servizio. Il risultato è un'infotable contenente gli oggetti che implementano il modello di oggetto o la thing shape e i valori effettivi delle proprietà del modello di oggetto o della thing shape per cui viene eseguita l'interrogazione.
Input
Nome parametro
Descrizione
Tipo di base
maxItems
Numero massimo di elementi da restituire nell'insieme di risultati. Il valore di default è 500. Questo parametro viene applicato dopo l'applicazione di tutti gli altri filtri.
NUMBER
tags
Tag modello associati all'origine di questa voce.
TAGS
nameMask
Schema del nome per le entità che implementano il modello di oggetto o la thing shape.
STRING
query
Criteri dell'interrogazione utilizzati per filtrare i dati.
È possibile scrivere i filtri solo per le proprietà effettive del modello di oggetto o della thing shape per cui viene eseguito il servizio.
QUERY
Output
Nome parametro
Descrizione
Tipo di base
result
Restituisce un'infotable contenente l'elenco di oggetti che implementano il modello di oggetto o la thing shape e i valori effettivi delle proprietà del modello di oggetto o della thing shape.
INFOTABLE
Esempio
Nell'esempio riportato di seguito, TestStream presenta una data shape con i campi Property1, Property2 e Property3.
Entità
ShapeProp1
ShapeProp2
ShapeProp3
ThingShape1
Definito
ND
ND
ThingShape2
ND
ND
ND
ThingShape2
ND
ND
Definito
Entità
Modello padre
Prop1
Prop2
Prop3
Prop4
Shape implementata
Proprietà effettive
Template1
Definito
ND
ND
ND
ThingShape1
Prop1, ShapeProp1
Template2
Template1
Ereditato da Template1
Definito
ND
ND
ThingShape2
Prop1,
Prop2,
ShapeProp1,
ShapeProp2
Template3
Template2
Ereditato da Template2
Ereditato da Template2
Definito
ND
Prop1,
Prop2,
Prop3,
ShapePropy1,
ShapeProp2
Template4
Template2
Ereditato da Template2
Ereditato da Template2
ND
Definito
ThingShape4
Prop1,
Prop2,
Prop4,
ShapeProp1,
ShapeProp2,
ShapeProp4
Entità
Implementa
Tag modello
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
Nell'esempio riportato di seguito viene illustrata un'interrogazione che consente di implementare oggetti con i dati utilizzando i relativi parametri supportati. Questa chiamata API restituisce un'infotable contenente avatar, descrizione, homeMashup, isSystemObject, nome, tag e tutte le proprietà definite nel modello di oggetto per cui viene eseguita l'interrogazione e il modello padre immediato degli oggetti che corrispondono ai parametri di input.
Nell'interrogazione che segue, nell'infotable vengono restituiti avatar, descrizione, homeMashup, isSystemObject, nome, tag, Prop1, Prop2, Prop4, ShapeProp1, ShapeProp2, ShapeProp4 e il modello padre immediato dell'oggetto.
result = ThingTemplates["Template4"].QueryImplementingThingsWithData({
maxItems: 50 /* NUMBER {"defaultValue":500} */,
nameMask: "T*" /* STRING */,
tags: "MT1:MT1-MTerm1",
query: "{\"filters\":{\"type\": \"LIKE\", \"fieldName\": \"Prop1\", \"value\": \"Val2*\" }}"

});
Nell'interrogazione che segue, nell'infotable vengono restituiti avatar, descrizione, homeMashup, isSystemObject, nome, tag, Prop1 e ShapeProp1 dell'oggetto.
result = ThingShapes["ThingShape1"].QueryImplementingThingsWithData({
maxItems: 50 /* NUMBER {"defaultValue":500} */,
nameMask: "T*" /* STRING */,
tags: "MT1:MT1-MTerm1",
query: "{\"filters\":{\"type\": \"LIKE\", \"fieldName\": \"ShapeProp1\", \"value\": \"SVal*\" }}"

});
È stato utile?