Composer의 ThingWorx 모델 정의 > 모델링 > 코드 조각 > QueryImplementingThingsOptimizedWithTotalCount
QueryImplementingThingsOptimizedWithTotalCount
설명
이 서비스를 사용하여 서비스가 실행되는 사물 템플릿 또는 사물 형태를 구현하는 사물을 질의할 수 있습니다. 결과는 템플릿 또는 데이터 셰이프를 구현하는 사물과 질의가 실행되는 사물 템플릿 또는 사물 형태의 속성 값을 포함하는 인포테이블입니다.
입력
매개 변수 이름
설명
기본 유형
maxItems
결과 집합에서 반환할 최대 항목 수입니다. 기본값은 500입니다. 이 매개 변수는 다른 모든 필터가 적용된 후에 적용됩니다.
NUMBER
tags
이 엔트리의 소스와 연관된 모델 태그입니다.
TAGS
nameMask
사물 템플릿 또는 사물 형태를 구현하는 엔티티의 이름 패턴입니다.
STRING
query
데이터를 필터링하는 데 사용되는 질의 조건입니다.
필터는 서비스가 실행되는 사물 템플릿 또는 사물 형태의 유효 속성에 대해서만 작성할 수 있습니다.
자세한 내용은 질의 서비스의 질의 매개 변수를 참조하십시오.
QUERY
withPermissions
true이면 권한 정보가 결과에 포함됩니다.
BOOLEAN
basicPropertyNames
isSystemObject, 이름, 설명, homeMashup, 아바타, 태그 등 기본 속성 목록이 포함된 인포테이블입니다.
인포테이블의 예상 데이터 셰이프는 EntityList입니다.
INFOTABLE
propertyNames
사물 템플릿 또는 사물 형태의 특정 속성 목록이 포함된 인포테이블입니다. 지정된 속성은 서비스가 실행되는 사물 템플릿 또는 사물 형태에 정의되어야 합니다.
인포테이블의 예상 데이터 셰이프는 EntityList입니다.
INFOTABLE
networkName
필터링할 네트워크 이름입니다. 질의는 해당 네트워크에 있는 사물의 결과만 반환합니다.
networkParentNode
networkName에 지정된 네트워크의 최상위 노드 이름입니다. 질의는 네트워크에 지정된 상위 노드의 모든 하위 노드를 반환합니다.
STRING
networkMaxDepth
네트워크에서 검색할 최대 깊이입니다. 이 값을 0(기본값)으로 설정하면 질의는 하위의 전체 계층을 반환합니다.
INTEGER
offset
질의에서 행 반환을 시작하기 전에 건너뛸 행 수입니다. 0(기본값)으로 설정하면 질의는 모든 행을 반환합니다. 이는 결과에 페이지 매김을 적용하는 데 사용할 수 있습니다.
NUMBER
출력
매개 변수 이름
설명
기본 유형
result
사물 템플릿 또는 사물 형태를 구현하는 사물의 목록과 사물 템플릿 또는 사물 형태 및 해당 값의 요청된 속성이 포함된 인포테이블을 반환합니다. 인포테이블의 데이터 셰이프는 ImplementedThingsWithTotalCount입니다.
INFOTABLE
예
엔티티
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
Thing1
Template1
{vocabulary: "MT1", vocabularyTerm: "MT1-MTerm1"}
Val1-1
Thing2
Template2
{vocabulary: "MT1", vocabularyTerm: "MT1-MTerm1"}
Val2-1
Val2-2
Thing3
Template3
{vocabulary: "MT1", vocabularyTerm: "MT1-MTerm1"}
Val3-1
Val3-2
Val3-3
Thing4
Template4
{vocabulary: "MT1", vocabularyTerm: "MT1-MTerm2"}
Val4-1
Val4-2
Val4-4
다음 질의에서 결과 인포테이블에는 요청된 기본 속성(이름, 설명, 태그, homeMashup), 사물 템플릿에 대해 요청된 속성(Prop1) 및 사물의 이름이 포함됩니다.
다음 코드는 지원되는 모든 매개 변수를 사용하여 데이터가 포함된 사물을 구현하기 위해 질의합니다.
var params = {
infoTableName : "InfoTable",
dataShapeName : "EntityList"
};
// CreateInfoTableFromDataShape
var basicpropInfoTable = Resources["InfoTableFunctions"].CreateInfoTableFromDataShape(params);
// EntityList entry object
var basicProp1 = new Object();
basicProp1.name = "name";
basicProp1.description = undefined;
var basicProp2 = new Object();
basicProp2.name = "description";
basicProp2.description = undefined;
var basicProp3 = new Object();
basicProp3.name = "tags";
basicProp3.description = undefined;
var basicProp4 = new Object();
basicProp4.name = "homeMashup";
basicProp4.description = undefined;
basicpropInfoTable.AddRow(basicProp1);
basicpropInfoTable.AddRow(basicProp2);
basicpropInfoTable.AddRow(basicProp3);
basicpropInfoTable.AddRow(basicProp4);
var propertyNamesInfoTable = Resources["InfoTableFunctions"].CreateInfoTableFromDataShape(params);
var prop1 = new Object();
prop1.name = "Property1";
prop1.description = undefined;
var prop2 = new Object();
prop2.name = "Property4";
prop2.description = undefined;
propertyNamesInfoTable.AddRow(prop1);
result = ThingTemplates["Template1"].QueryImplementingThingsOptimizedWithTotalCount({
maxItems: 50 ,
nameMask: "T*",
tags: "MT1:MT1-MTerm1",
query: "{\"filters\":{\"type\": \"LIKE\", \"fieldName\": \"Property1\", \"value\": \"Val*\" }}",
basicPropertyNames: basicpropInfoTable,
propertyNames: propertyNamesInfoTable,
networkName: 'Network1',
networkParentNode: 'TestThing1',
networkMaxDepth: 0,
offset: 0
});
도움이 되셨나요?