온라인 감사 데이터 내보내기

Composer의 ThingWorx 모델 정의 > 시스템 > 하위 시스템 > 감사 하위 시스템 > 직접 지속성 구현 사용 > 온라인 감사 데이터 내보내기

온라인 감사 데이터 내보내기

직접 지속성 구현이 활성 상태일 때 ExportOnlineAuditData 서비스를 사용하여 온라인 데이터 저장소에서 감사 메시지의 번역된 버전을 내보냅니다. ExportOnlineAuditData 서비스는 직접 지속성 구현에만 사용할 수 있으므로 데이터 저장소는 ThingWorx Platform에 대한 지속성 공급자로 구성된 데이터베이스(PostgreSQL 또는 MS SQL)입니다.

ExportOnlineAuditData 서비스는 온라인 데이터에서 번역된 감사 메시지를 생성합니다. 이 서비스는 로캘, 저장소 이름, 대상 경로, 대상 파일 이름, 시작 날짜 및 종료 날짜를 사용합니다. 로캘은 감사 메시지를 번역하는 데 사용됩니다. 호출되면 서비스는 온라인 스토리지의 지정된 조건과 일치하는 감사 항목을 지정된 대상 경로에 있는 zip 파일(지정된 대상 파일 이름 사용)로 내보냅니다. 내보내기는 감사 날짜를 기준으로 정렬됩니다. 서비스와 해당 입력은 다음과 같습니다.

ExportOnlineAuditData(locale[STRING],
targetRepositoryName[THINGNAME],
targetPath[STRING],
targetFileName[STRING],
startDate[DATETIME],
endDate[DATETIME],
query[QUERY])

다음 표에는 입력 매개 변수 및 해당 매개 변수에 대한 간단한 설명 및 해당 ThingWorx 기본 유형이 나와 있습니다.

매개 변수	설명	기본 유형
locale	결과를 반환할 언어 이름의 약어(STRING)입니다. 예를 들어, fr(프랑스어) 또는 zh_CN(중국어(중국))입니다. ThingWorx에서 지원하는 로캘 목록은 지원되는 로캘 항목을 참조하십시오.	STRING
targetRepositoryName	번역된 감사 항목이 포함된 출력 파일이 저장되는 파일 저장소 사물의 이름입니다.	THINGNAME
targetPath	출력 파일이 작성되어야 하는 위치입니다.	STRING
targetFileName	번역된 감사 데이터가 저장되어야 하는 출력 파일의 이름입니다.	STRING
startDate	내보낼 첫 번째 감사 항목의 날짜 및 시간입니다. 첫 번째로 내보낸 감사 항목의 날짜와 시간 이후 및 endDate 이전의 타임스탬프가 있는 모든 감사 항목을 내보냅니다.	DATETIME
endDate	내보낼 마지막 감사 항목의 날짜 및 시간입니다. 마지막으로 내보낸 감사 항목의 날짜와 시간 이전 및 startDate 이후의 타임스탬프가 있는 모든 감사 항목을 내보냅니다.	DATETIME
query	감사 데이터를 필터링하고 정렬하기 위한 JSON 형식 질의입니다. 이 매개 변수에 대한 기본값은 없습니다. 예를 보려면 아래의 온라인 감사 데이터 내보내기의 예 단원을 참조하십시오.

온라인 감사 데이터 내보내기의 예

다음은 이 서비스에 대한 호출의 예입니다.

AuditSubsystem.ExportOnlineAuditData("en", myExportRepository, "/auditExport/",
"export_02-03_one_hour", 2020-02-03 18:50:03.000, 2020-02-03 19:50:03.000,
{
"filters": {
"type": "OR",
"filters": [{
"type": "EQ",
"fieldName": "user",
"value": "Administrator",
"isCaseSensitive": false
},
{
"type": "Between",
"fieldName": "timestamp",
"from": 1570195753953,
"to": 1570195753961
},
{
"type": "IN",
"fieldName": "source",
"values": ["test_tt", "test"],
"isCaseSensitive": false
},}
]
},
"sorts": [
{
"fieldName": "source",
"isAscending": true,
"isCaseSensitive": true
},
{
"fieldName": "timestamp",
"isAscending": true,
"isCaseSensitive": true
}
]
})

이 예는 /auditExport/export_02-03_one_hour.zip의 myExportRepository에서 내보내기를 영어로 생성합니다. 콘텐츠는 지정된 시작 날짜 및 종료 날짜를 기반으로 하는 모든 온라인 감사 메시지입니다. 내보낸 zip 파일의 크기는 시작 날짜와 종료 날짜 사이에 수집된 데이터의 양에 따라 달라집니다. 다음 표에는 시작 및 종료 날짜에 따라 달라지는 내보내기의 콘텐츠가 나와 있습니다.

시작 날짜	종료 날짜	내보내기의 콘텐츠
2020-02-03 18:50:03.000 (특정 날짜 및 시간)	2020-02-03 19:50:03.000(특정 날짜 및 시간)	이 예의 경우 시작 날짜와 종료 날짜 사이에 있는 모든 온라인 데이터가 동일한 날짜(2020–02–03)이며, 한 시간짜리 데이터(18:50:03.000 ~ 19:50:03.000)입니다.
null	2020-02-03 19:50:03.000(특정 날짜 및 시간)	종료 날짜 및 시간(2020-02-03 19:50:03.000)보다 오래된 모든 온라인 데이터입니다. 시작 날짜가 null로 설정되어 있으면 데이터베이스 스토리지 및 온라인 데이터 보존 정책에 있는 감사 메시지의 수량에 따라 내보내기에 많은 양의 감사 데이터가 포함될 수 있습니다.
2020-02-03 18:50:03.000 (특정 날짜 및 시간)	null	종료 날짜를 null로 설정하여 지정된 시작 날짜 및 시간과 현재 날짜 및 시간 사이의 모든 온라인 데이터입니다.
null	null	모든 온라인 감사 데이터입니다. 이는 시간이 매우 오래 걸릴 수 있으므로 권장되지 않습니다.

다음 계속되는 예에는 export_02-03_one_hour.zip 파일이 AuditArchiveDirectPersistence/export/export_02-03_one_hour.json이라는 보관 파일을 만듭니다.

다음은 내보내기 파일 AuditArchiveDirectPersistence/export/export_02-03_one_hour.json에 있는 JSON의 예입니다.

{
"rows":[
{
"auditCategory":"Modeling",
"application":"ThingWorxCore",
"sourceType":"Thing",
"id":"4164",
"source":"ExampleThing",
"message":"Created Thing \"ExampleThing\"",
"user":"ExampleUser",
"timestamp":1580773803
},
...
...
]
}

이 직접 지속성 예에 대해 반환된 정보에는 다음 세부 정보가 포함됩니다.

속성	설명
auditCategory	감사 메시지의 카테고리 이름입니다. 위 예에서는 Modeling 카테고리입니다. 감사 카테고리에 대한 자세한 내용은 감사 카테고리 항목을 참조하십시오.
application	감사 메시지를 생성한 응용 프로그램의 이름입니다. 코어 ThingWorx Platform에서 생성한 감사 메시지의 경우 값이 ThingworxCore로 설정됩니다.
sourceType	이 감사 메시지를 생성한 응용 프로그램과 연관된 유형입니다(Thing).
source	이 감사 메시지를 생성한 ThingWorx 응용 프로그램 또는 실행 파일입니다. 이 예에서 소스는 ExampleThing입니다.
id	이는 감사 항목에 대해 자동 생성된 고유 식별자입니다. 이 예에서는 id가 4164입니다.
message	감사 메시지의 텍스트입니다.
user	감사 메시지가 생성될 때 응용 프로그램을 실행한 사용자의 로그인 이름입니다.
timestamp	에포크 시간에서 감사 메시지가 생성된 날짜 및 시간입니다.

내보내기 후 온라인 데이터의 상태

온라인 데이터는 내보내기 후 온라인 스토리지에 유지됩니다. ArchiveAuditHistory 서비스를 실행하여 수동으로 또는 AuditArchiveScheduler를 설정하여 자동으로 데이터를 온라인 스토리지에서 삭제할 수 있습니다.