QueryImplementingThingsWithData

Définition du modèle ThingWorx dans Composer > Modélisation > Extraits de code > QueryImplementingThingsWithData

Description

Vous pouvez utiliser ce service pour interroger les objets qui implémentent le modèle d'objet ou la forme d'objet sur lequel le service est exécuté. Vous obtenez une table d'informations contenant les objets qui implémentent le modèle d'objet ou la forme d'objet, ainsi que les valeurs de propriété effectives du modèle d'objet ou de la forme d'objet sur lequel la requête est exécutée.

Entrée

Nom de paramètre	Description	Type de base
maxItems	Nombre maximal d'éléments à renvoyer dans le jeu de résultats. La valeur par défaut est 500. Ce paramètre est appliqué à la suite de tous les autres filtres.	NUMBER
tags	Tags de modèle associés à la source de cette entrée.	TAGS
nameMask	Modèle de nom des entités qui implémentent le modèle d'objet ou la forme d'objet.	STRING
query	Critères de requête utilisés pour filtrer les données. Les filtres ne peuvent être écrits que pour les propriétés effectives du modèle d'objet ou de la forme d'objet sur lequel le service est exécuté. Pour plus d'informations, consultez la rubrique Paramètre de requête pour les services de requête.	QUERY

Sortie

Nom de paramètre	Description	Type de base
result	Renvoie une table d'informations contenant la liste des objets qui implémentent le modèle d'objet ou la forme d'objet, ainsi que les valeurs de propriété effectives du modèle d'objet ou de la forme d'objet.	INFOTABLE

Exemple

Dans l'exemple suivant, TestStream comporte une forme de données avec des champs Property1, Property2 et Property3.

Entité	ShapeProp1	ShapeProp2	ShapeProp3
ThingShape1	Défini	N/A	N/A
ThingShape2	N/A	N/A	N/A
ThingShape2	N/A	N/A	Défini

Entité	Modèle parent	Prop1	Prop2	Prop3	Prop4	Forme implémentée	Propriétés effectives
Template1		Défini	N/A	N/A	N/A	ThingShape1	Prop1, ShapeProp1
Template2	Template1	Hérité de Template1	Défini	N/A	N/A	ThingShape2	Prop1, Prop2, ShapeProp1, ShapeProp2
Template3	Template2	Hérité de Template2	Hérité de Template2	Défini	N/A		Prop1, Prop2, Prop3, ShapePropy1, ShapeProp2
Template4	Template2	Hérité de Template2	Hérité de Template2	N/A	Défini	ThingShape4	Prop1, Prop2, Prop4, ShapeProp1, ShapeProp2, ShapeProp4

Entité	Implémente	Tags de modèle	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

L'exemple suivant présente une requête d'implémentation d'objets avec des données utilisant les paramètres pris en charge. Cet appel d'API renvoie une table d'informations qui contient l'avatar, la description, homeMashup, isSystemObject, le nom, les tags, toutes les propriétés définies dans le modèle d'objet sur lequel la requête est exécutée, ainsi que le modèle parent immédiat des objets qui correspondent aux paramètres d'entrée.

Dans la requête suivante, l'avatar, la description, homeMashup, isSystemObject, le nom, les tags, Prop1, Prop2, Prop4, ShapeProp1, ShapeProp2, ShapeProp4 et le modèle parent immédiat de l'objet sont renvoyés dans la table d'informations.

result = ThingTemplates["Template4"].QueryImplementingThingsWithData({
maxItems: 50 /* NUMBER {"defaultValue":500} */,
nameMask: "T*" /* STRING */,
tags: "MT1:MT1-MTerm1",
query: "{\"filters\":{\"type\": \"LIKE\", \"fieldName\": \"Prop1\", \"value\": \"Val2*\" }}"

});

Dans la requête suivante, l'avatar, la description, homeMashup, isSystemObject, le nom, les tags, Prop1 et ShapeProp1 de l'objet sont renvoyés dans la table d'informations.

result = ThingShapes["ThingShape1"].QueryImplementingThingsWithData({
maxItems: 50 /* NUMBER {"defaultValue":500} */,
nameMask: "T*" /* STRING */,
tags: "MT1:MT1-MTerm1",
query: "{\"filters\":{\"type\": \"LIKE\", \"fieldName\": \"ShapeProp1\", \"value\": \"SVal*\" }}"

});

Est-ce que cela a été utile ?