Composer의 ThingWorx 모델 정의 > 모델링 > 코드 조각 > QueryImplementingThingsWithNamedData
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
});
도움이 되셨나요?