QueryNamedPropertyHistory
설명
이 서비스는 입력 매개 변수를 기반으로 로깅된 속성의 기록을 질의합니다.
입력
매개 변수 이름
설명
기본 유형
propertyNames
사물의 로깅된 속성 목록이 포함된 인포테이블입니다.
인포테이블의 예상 데이터 셰이프는 EntityList입니다.
INFOTABLE
maxItems
결과 집합에서 반환할 최대 항목 수입니다. 기본값은 500입니다. 이 매개 변수는 다른 모든 필터가 적용된 후에 적용됩니다.
NUMBER
startDate
값이 로깅된 후의 타임스탬프입니다.
DATETIME
endDate
값이 로깅되기 전의 타임스탬프입니다.
DATETIME
quality
속성에 대해 로깅된 엔트리의 품질입니다. 여러 값은 파이프(|)로 구분할 수 있습니다. 유효한 옵션은 GOOD, BADUNKNOWN입니다.
STRING
fillOption
유효한 옵션은 PreviousNone입니다. Previous가 요청된 경우 다른 속성이 업데이트되는 동안 지정된 속성에 업데이트가 없으면 이전 값이 보고됩니다. None이 요청된 경우 다른 속성이 업데이트되는 동안 지정된 속성에 업데이트가 없으면 값이 보고되지 않습니다.
기본값은 Previous입니다.
STRING
oldestFirst
가장 오래되었거나 가장 최신 기록에서 검색합니다. 기본값은 False입니다.
BOOLEAN
query
데이터를 필터링할 추가 질의 조건입니다.
자세한 내용은 질의 서비스의 질의 매개 변수를 참조하십시오.
QUERY
returnedMetadata
속성 이름, 타임스탬프 및 속성 값 외에 추가로 요청할 수 있는 추가 열을 정의합니다.
기본값은 Quality입니다.
STRING
출력
매개 변수 이름
설명
기본 유형
result
요청된 속성의 기록 값 목록이 포함된 인포테이블을 반환합니다.
INFOTABLE
다음 예에서 Thing1에는 다음 순서로 값을 입력한 Prop1Prop2 속성이 있습니다.
엔티티
Prop1
Prop2
Thing1
1
2
11
22
다음 질의에서 결과 인포테이블에는 타임스탬프, Prop1, Prop1_Quality, Prop2Prop2_quality가 포함됩니다.
var params = {
infoTableName : "InfoTable",
dataShapeName : "EntityList"
};
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 = "Prop2"; // STRING [Primary Key]
prop2.description = undefined; // STRING
propertyNamesInfoTable.AddRow(prop1);
propertyNamesInfoTable.AddRow(prop2);

// result: INFOTABLE dataShape: ""
let result = Things["Thing1"].QueryNamedPropertyHistory({
propertyNames: propertyNamesInfoTable,
maxItems: 5,
startDate: new Date(new Date().setFullYear(new Date().getFullYear() - 1)),
endDate: Date.now(),
quality: 'GOOD|BAD',
fillOption: 'Previous',
oldestFirst: false,
query: "{ \"sorts\": [{\"fieldName\": \"Prop1\"}]}",
returnedMetadata: 'Quality'
});
다음 질의에서 결과 인포테이블에는 타임스탬프, Prop1Prop2가 포함됩니다.
var params = {
infoTableName : "InfoTable",
dataShapeName : "EntityList"
};
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 = "Prop2"; // STRING [Primary Key]
prop2.description = undefined; // STRING
propertyNamesInfoTable.AddRow(prop1);
propertyNamesInfoTable.AddRow(prop2);

// result: INFOTABLE dataShape: ""
let result = Things["Thing1"].QueryNamedPropertyHistory({
propertyNames: propertyNamesInfoTable,
maxItems: 5,
startDate: new Date(new Date().setFullYear(new Date().getFullYear() - 1)),
endDate: Date.now(),
quality: 'GOOD|BAD',
fillOption: 'None',
oldestFirst: false,
query: "{ \"sorts\": [{\"fieldName\": \"Prop1\"}]}",
returnedMetadata: 'Quality'
});
도움이 되셨나요?