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