PurgePropertyHistory

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

설명

로깅된 속성이 업데이트되면 데이터가 사물에 연관된 가치 스트림에 작성됩니다. PurgePropertyHistory 서비스를 사용하면 지정된 시간 범위 동안 하나의 로깅된 속성에서 기록 데이터를 제거할 수 있습니다.

서비스가 호출된 사물의 속성 기록은 제거되지만 다른 사물의 속성 기록은 제거되지 않습니다. 여러 사물에 대한 기록 데이터를 제거하려면 각 사물에서 서비스를 호출해야 합니다.

기본적으로 이 제거는 비동기적으로 실행됩니다.

입력

매개 변수 이름	설명	기본 유형
propertyName	기록 데이터를 제거해야 하는 속성의 이름입니다.	STRING
startDate	기록 데이터를 제거해야 하는 시작 날짜(지정된 날짜 포함)입니다.	DATETIME
endDate	기록 데이터를 제거해야 하는 종료 날짜(지정된 날짜 포함)입니다.	DATETIME
immediate	false이면 제거는 비동기적으로 실행됩니다. 기본값은 false입니다. true로 설정하면 제거가 동기적으로 실행됩니다.	BOOLEAN

출력

없음

예

다음 예에서 사물에는 여러 번 업데이트되고 기록 데이터를 수집하는 propertyA-Logged라는 로깅된 속성이 있습니다.

아래와 같이 입력 매개 변수를 인라인으로 전달할 수 있습니다.

// Purging historical data between the given start and end dates
Things["TestThing"].PurgePropertyHistory({
propertyName: 'propertyA-Logged' /* STRING */,
startDate: '2024-05-12T16:58:28.000Z' /* DATETIME */,
endDate: 'Date.now()' /* DATETIME */,
immediate: true /* BOOLEAN {"defaultValue":false} */
});

또는 인포테이블을 구성할 수 있습니다.

// Params for purging historical data from the past year
var purgeHistoryParams = {
propertyName: 'propertyA-Logged' /* STRING */,
startDate: new Date(new Date().setFullYear(new Date().getFullYear() - 1)),
endDate: Date.now(),
immediate: true /* BOOLEAN */
};
Things["TestThing"].PurgePropertyHistory(purgeHistoryParams);

도움이 되셨나요?