QueryImplementingThingsWithNamedData

Composer의 ThingWorx 모델 정의 > 모델링 > 코드 조각 > QueryImplementingThingsWithNamedData

설명

이 서비스를 사용하여 서비스가 실행되는 사물 템플릿 또는 사물 형태를 구현하는 사물을 질의할 수 있습니다. 속성 이름은 입력 매개 변수(basicPropertyNames 및 propertyNames)로 전달됩니다. 결과는 사물 템플릿 또는 사물 형태를 구현하는 사물과 질의가 실행되는 사물 템플릿 또는 사물 형태의 속성 값을 포함하는 인포테이블입니다.

입력

매개 변수 이름	설명	기본 유형
maxItems	결과 집합에서 반환할 최대 항목 수입니다. 기본값은 500입니다. 이 매개 변수는 다른 모든 필터가 적용된 후에 적용됩니다.	NUMBER
tags	이 엔트리의 소스와 연관된 모델 태그입니다.	TAGS
nameMask	사물 템플릿 또는 사물 형태를 구현하는 엔티티의 이름 패턴입니다.	STRING
query	데이터를 필터링하는 데 사용되는 질의 조건입니다. 필터는 서비스가 실행되는 사물 템플릿 또는 사물 형태의 유효 속성에 대해서만 작성할 수 있습니다. 자세한 내용은 질의 서비스의 질의 매개 변수를 참조하십시오.	QUERY
basicPropertyNames	isSystemObject, 이름, 설명, homeMashup, 아바타, 태그 등 기본 속성 목록이 포함된 인포테이블입니다. 인포테이블의 예상 데이터 셰이프는 EntityList입니다.	INFOTABLE
propertyNames	사물 템플릿 또는 사물 형태의 특정 속성 목록이 포함된 인포테이블입니다. 인포테이블의 예상 데이터 셰이프는 EntityList입니다.	INFOTABLE

출력

매개 변수 이름	설명	기본 유형
result	사물 템플릿 또는 사물 형태를 구현하는 사물의 목록과 사물 템플릿 또는 사물 형태 및 해당 값의 요청된 속성이 포함된 인포테이블을 반환합니다.	INFOTABLE

예

다음 예에서 TestStream에는 Property1, Property2 및 Property3 필드가 있는 데이터 셰이프가 있습니다.

엔티티	ShapeProp1	ShapeProp2	ShapeProp3
ThingShape1	정의됨	해당 없음	해당 없음
ThingShape2	해당 없음	해당 없음	해당 없음
ThingShape2	해당 없음	해당 없음	정의됨

엔티티	상위 템플릿	Prop1	Prop2	Prop3	Prop4	구현된 형태	유효 속성
Template1		정의됨	해당 없음	해당 없음	해당 없음	ThingShape1	Prop1, ShapeProp1
Template2	Template1	Template1에서 상속됨	정의됨	해당 없음	해당 없음	ThingShape2	Prop1, Prop2, ShapeProp1, ShapeProp2
Template3	Template2	Template2에서 상속됨	Template2에서 상속됨	정의됨	해당 없음		Prop1, Prop2, Prop3, ShapePropy1, ShapeProp2
Template4	Template2	Template2에서 상속됨	Template2에서 상속됨	해당 없음	정의됨	ThingShape4	Prop1, Prop2, Prop4, ShapeProp1, ShapeProp2, ShapeProp4

엔티티	구현	모델 태그	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

다음 예에서는 지원되는 매개 변수를 사용하여 데이터가 포함된 사물을 구현하기 위한 질의를 보여줍니다. 이 API 호출은 입력 매개 변수와 일치하는 사물 템플릿 또는 사물 형태의 요청된 기본 속성 및 기타 속성을 포함하는 인포테이블을 반환합니다.

다음 질의를 실행하면 결과 인포테이블에 이름, 설명, 태그, Prop1, ShapeProp4가 포함됩니다.

var params = {
    infoTableName : "InfoTable",
    dataShapeName : "EntityList"
};
// CreateInfoTableFromDataShape
var basicpropInfoTable = Resources["InfoTableFunctions"].CreateInfoTableFromDataShape(params);
// EntityList entry object
var basicProp1 = new Object();
basicProp1.name = "name"; // STRING [Primary Key]
basicProp1.description = undefined; // STRING
var basicProp2 = new Object(); 
basicProp2.name = "description"; // STRING 
basicProp2.description = undefined; // STRING
var basicProp3 = new Object(); 
basicProp3.name = "tags"; // STRING 
basicProp3.description = undefined; // STRING
basicpropInfoTable.AddRow(basicProp1);
basicpropInfoTable.AddRow(basicProp2);
basicpropInfoTable.AddRow(basicProp3);
var propertyNamesInfoTable = Resources["InfoTableFunctions"].CreateInfoTableFromDataShape(params);
// EntityList entry object
var prop1 = new Object();
prop1.name = "Prop1"; // STRING [Primary Key]
prop1.description = undefined; // STRING
var prop2 = new Object();
prop2.name = "ShapeProp4"; // STRING [Primary Key]
prop2.description = undefined; // STRING
propertyNamesInfoTable.AddRow(prop1);
propertyNamesInfoTable.AddRow(prop2);
result = ThingTemplates["Template4"].QueryImplementingThingsWithNamedData({
	maxItems: 50 /* NUMBER {"defaultValue":500} */,
	nameMask: "T*" /* STRING */,
    tags: "MT1:MT1-MTerm1",
    query: "{\"filters\":{\"type\": \"LIKE\", \"fieldName\": \"Prop1\", \"value\": \"Val*\" }}",
    basicPropertyNames: basicpropInfoTable,
    propertyNames: propertyNamesInfoTable
});

다음 질의를 실행하면 결과 인포테이블에 이름, 설명, 태그, ShapeProp1이 포함됩니다.

var params = {
    infoTableName : "InfoTable",
    dataShapeName : "EntityList"
};
// CreateInfoTableFromDataShape
var basicpropInfoTable = Resources["InfoTableFunctions"].CreateInfoTableFromDataShape(params);
// EntityList entry object
var basicProp1 = new Object();
basicProp1.name = "name"; // STRING [Primary Key]
basicProp1.description = undefined; // STRING
var basicProp2 = new Object(); 
basicProp2.name = "description"; // STRING 
basicProp2.description = undefined; // STRING
var basicProp3 = new Object(); 
basicProp3.name = "tags"; // STRING 
basicProp3.description = undefined; // STRING
basicpropInfoTable.AddRow(basicProp1);
basicpropInfoTable.AddRow(basicProp2);
basicpropInfoTable.AddRow(basicProp3);
var propertyNamesInfoTable = Resources["InfoTableFunctions"].CreateInfoTableFromDataShape(params);
// EntityList entry object
var prop1 = new Object();
prop1.name = "ShapeProp1"; // STRING [Primary Key]
prop1.description = undefined; // STRING
propertyNamesInfoTable.AddRow(prop1);
result = ThingShapes["ThingShape1"].QueryImplementingThingsWithNamedData({
	maxItems: 50 /* NUMBER {"defaultValue":500} */,
	nameMask: "T*" /* STRING */,
    tags: "MT1:MT1-MTerm1",
    query: "{\"filters\":{\"type\": \"LIKE\", \"fieldName\": \"ShapeProp1\", \"value\": \"S*al*\" }}",
    basicPropertyNames: basicpropInfoTable,
    propertyNames: propertyNamesInfoTable
});

QueryImplementingThingsWithNamedDataV2

설명

입력

매개 변수 이름	설명	기본 유형
maxItems	결과 집합에서 반환할 최대 항목 수입니다. 기본값은 500입니다. 이 매개 변수는 다른 모든 필터가 적용된 후에 적용됩니다.	NUMBER
tags	이 엔트리의 소스와 연관된 모델 태그입니다.	TAGS
nameMask	사물 템플릿 또는 사물 형태를 구현하는 엔티티의 이름 패턴입니다.	STRING
query	데이터를 필터링하는 데 사용되는 질의 조건입니다. 필터는 서비스가 실행되는 사물 템플릿 또는 사물 형태의 유효 속성에 대해서만 작성할 수 있습니다. 자세한 내용은 질의 서비스의 질의 매개 변수를 참조하십시오.	QUERY
basicPropertyNames	isSystemObject, 이름, 설명, homeMashup, 아바타, 태그 등 기본 속성 목록이 포함된 인포테이블입니다. 인포테이블의 예상 데이터 셰이프는 EntityList입니다.	INFOTABLE
propertyNames	사물 템플릿 또는 사물 형태의 특정 속성 목록이 포함된 인포테이블입니다. 인포테이블의 예상 데이터 셰이프는 EntityList입니다.	INFOTABLE

출력

매개 변수 이름	설명	기본 유형
result	사물 템플릿 또는 사물 형태를 구현하는 사물의 목록과 사물 템플릿 또는 사물 형태 및 해당 값의 요청된 속성이 포함된 인포테이블을 반환합니다.	INFOTABLE

예

다음 예에서 TestStream에는 Property1, Property2 및 Property3 필드가 있는 데이터 셰이프가 있습니다.

엔티티	ShapeProp1	ShapeProp2	ShapeProp3
ThingShape1	정의됨	해당 없음	해당 없음
ThingShape2	해당 없음	해당 없음	해당 없음
ThingShape2	해당 없음	해당 없음	정의됨

엔티티	상위 템플릿	Prop1	Prop2	Prop3	Prop4	구현된 형태	유효 속성
Template1		정의됨	해당 없음	해당 없음	해당 없음	ThingShape1	Prop1, ShapeProp1
Template2	Template1	Template1에서 상속됨	정의됨	해당 없음	해당 없음	ThingShape2	Prop1, Prop2, ShapeProp1, ShapeProp2
Template3	Template2	Template2에서 상속됨	Template2에서 상속됨	정의됨	해당 없음		Prop1, Prop2, Prop3, ShapePropy1, ShapeProp2
Template4	Template2	Template2에서 상속됨	Template2에서 상속됨	해당 없음	정의됨	ThingShape4	Prop1, Prop2, Prop4, ShapeProp1, ShapeProp2, ShapeProp4

엔티티	구현	모델 태그	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

다음 질의를 실행하면 결과 인포테이블에 이름, 설명, 태그, Prop1, ShapeProp4가 포함됩니다.

var params = {
    infoTableName : "InfoTable",
    dataShapeName : "EntityList"
};
// CreateInfoTableFromDataShape
var basicpropInfoTable = Resources["InfoTableFunctions"].CreateInfoTableFromDataShape(params);
// EntityList entry object
var basicProp1 = new Object();
basicProp1.name = "name"; // STRING [Primary Key]
basicProp1.description = undefined; // STRING
var basicProp2 = new Object(); 
basicProp2.name = "description"; // STRING 
basicProp2.description = undefined; // STRING
var basicProp3 = new Object(); 
basicProp3.name = "tags"; // STRING 
basicProp3.description = undefined; // STRING
basicpropInfoTable.AddRow(basicProp1);
basicpropInfoTable.AddRow(basicProp2);
basicpropInfoTable.AddRow(basicProp3);
var propertyNamesInfoTable = Resources["InfoTableFunctions"].CreateInfoTableFromDataShape(params);
// EntityList entry object
var prop1 = new Object();
prop1.name = "Prop1"; // STRING [Primary Key]
prop1.description = undefined; // STRING
var prop2 = new Object();
prop2.name = "ShapeProp4"; // STRING [Primary Key]
prop2.description = undefined; // STRING
propertyNamesInfoTable.AddRow(prop1);
propertyNamesInfoTable.AddRow(prop2);
result = ThingTemplates["Template4"].QueryImplementingThingsWithNamedDataV2({
	maxItems: 50 /* NUMBER {"defaultValue":500} */,
	nameMask: "T*" /* STRING */,
    tags: "MT1:MT1-MTerm1",
    query: "{\"filters\":{\"type\": \"LIKE\", \"fieldName\": \"Prop1\", \"value\": \"Val*\" }}",
    basicPropertyNames: basicpropInfoTable,
    propertyNames: propertyNamesInfoTable
});

다음 질의를 실행하면 결과 인포테이블에 이름, 설명, 태그, ShapeProp1이 포함됩니다.

var params = {
    infoTableName : "InfoTable",
    dataShapeName : "EntityList"
};
// CreateInfoTableFromDataShape
var basicpropInfoTable = Resources["InfoTableFunctions"].CreateInfoTableFromDataShape(params);
// EntityList entry object
var basicProp1 = new Object();
basicProp1.name = "name"; // STRING [Primary Key]
basicProp1.description = undefined; // STRING
var basicProp2 = new Object(); 
basicProp2.name = "description"; // STRING 
basicProp2.description = undefined; // STRING
var basicProp3 = new Object(); 
basicProp3.name = "tags"; // STRING 
basicProp3.description = undefined; // STRING
basicpropInfoTable.AddRow(basicProp1);
basicpropInfoTable.AddRow(basicProp2);
basicpropInfoTable.AddRow(basicProp3);
var propertyNamesInfoTable = Resources["InfoTableFunctions"].CreateInfoTableFromDataShape(params);
// EntityList entry object
var prop1 = new Object();
prop1.name = "ShapeProp1"; // STRING [Primary Key]
prop1.description = undefined; // STRING
propertyNamesInfoTable.AddRow(prop1);
result = ThingShapes["ThingShape1"].QueryImplementingThingsWithNamedDataV2({
	maxItems: 50 /* NUMBER {"defaultValue":500} */,
	nameMask: "T*" /* STRING */,
    tags: "MT1:MT1-MTerm1",
    query: "{\"filters\":{\"type\": \"LIKE\", \"fieldName\": \"ShapeProp1\", \"value\": \"S*al*\" }}",
    basicPropertyNames: basicpropInfoTable,
    propertyNames: propertyNamesInfoTable
});

도움이 되셨나요?