ThingWorx Modelldefinition in Composer > Modellierung > Code-Snippets > QueryImplementingThingsWithData
QueryImplementingThingsWithData
Beschreibung
Sie können diesen Dienst verwenden, um die Dinge abzufragen, die die Dingvorlage oder Dingform implementieren, auf der der Dienst ausgeführt wird. Das Ergebnis ist eine Infotable, die die Dinge enthält, die die Dingvorlage oder Dingform implementieren, sowie die effektiven Eigenschaftswerte der Dingvorlage oder Dingform, für die die Abfrage ausgeführt wird.
Eingabe
Parametername
Beschreibung
Basistyp
maxItems
Die maximale Anzahl der im Ergebnissatz zurückzugebenden Elemente. Der Standardwert ist 500. Dieser Parameter wird angewendet, nachdem alle anderen Filter angewendet wurden.
NUMBER
tags
Die Modell-Tags, die der Quelle dieses Eintrags zugeordnet sind.
TAGS
nameMask
Das Namensmuster für die Entitäten, die die Dingvorlage oder Dingform implementieren.
STRING
query
Die Abfragekriterien, die zum Filtern von Daten verwendet werden.
Filter können nur für die effektiven Eigenschaften der Dingvorlage oder Dingform geschrieben werden, auf der der Dienst ausgeführt wird.
Weitere Informationen finden Sie unter Abfrageparameter für Abfragedienste.
QUERY
Ausgabe
Parametername
Beschreibung
Basistyp
result
Gibt eine Infotable zurück, die die Liste der Dinge enthält, die die Dingvorlage oder Dingform implementieren, und die effektiven Eigenschaftswerte der Dingvorlage oder Dingform.
INFOTABLE
Beispiel
Im folgenden Beispiel hat TestStream einen Data Shape mit den Feldern Property1, Property2 und Property3.
Entität
ShapeProp1
ShapeProp2
ShapeProp3
ThingShape1
Definiert
-
-
ThingShape2
-
-
-
ThingShape2
-
-
Definiert
Entität
Eltern-Vorlage
Prop1
Prop2
Prop3
Prop4
Implementierte Form
Effektive Eigenschaften
Template1
Definiert
-
-
-
ThingShape1
Prop1, ShapeProp1
Template2
Template1
Geerbt von Template1
Definiert
-
-
ThingShape2
Prop1,
Prop2,
ShapeProp1,
ShapeProp2
Template3
Template2
Geerbt von Template2
Geerbt von Template2
Definiert
-
Prop1,
Prop2,
Prop3,
ShapePropy1,
ShapeProp2
Template4
Template2
Geerbt von Template2
Geerbt von Template2
-
Definiert
ThingShape4
Prop1,
Prop2,
Prop4,
ShapeProp1,
ShapeProp2,
ShapeProp4
Entität
Implementiert
Modell-Tags
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
Das folgende Beispiel zeigt eine Abfrage zum Implementieren von Dingen mit Daten unter Verwendung der unterstützten Parameter. Dieser API-Aufruf gibt eine Infotable zurück, die den Avatar, die Beschreibung, homeMashup, isSystemObject, den Namen, die Tags, alle in der Dingvorlage definierten Eigenschaften, für die die Abfrage ausgeführt wird, und die unmittelbare Elternvorlage der Dinge enthält, die den Eingabeparametern entsprechen.
In der folgenden Abfrage werden Avatar, Beschreibung, homeMashup, isSystemObject, Name, Tags, Prop1, Prop2, Prop4, ShapeProp1, ShapeProp2, ShapeProp4 und die unmittelbare Elternvorlage des Dings in der Infotable zurückgegeben.
result = ThingTemplates["Template4"].QueryImplementingThingsWithData({
maxItems: 50 /* NUMBER {"defaultValue":500} */,
nameMask: "T*" /* STRING */,
tags: "MT1:MT1-MTerm1",
query: "{\"filters\":{\"type\": \"LIKE\", \"fieldName\": \"Prop1\", \"value\": \"Val2*\" }}"

});
In der folgenden Abfrage werden Avatar, Beschreibung, homeMashup, isSystemObject, Name, Tags. Prop1 und ShapeProp1 des Dings in der Infotable zurückgegeben.
result = ThingShapes["ThingShape1"].QueryImplementingThingsWithData({
maxItems: 50 /* NUMBER {"defaultValue":500} */,
nameMask: "T*" /* STRING */,
tags: "MT1:MT1-MTerm1",
query: "{\"filters\":{\"type\": \"LIKE\", \"fieldName\": \"ShapeProp1\", \"value\": \"SVal*\" }}"

});
War dies hilfreich?