Composer의 ThingWorx 모델 정의 > 시스템 > 하위 시스템 > 감사 하위 시스템 > 감사 보관, 내보내기 및 정리 작업 > 감사 데이터 내보내기
감사 데이터 내보내기
ExportAuditData 서비스는 오프라인(보관된) 데이터 또는 온라인 데이터에서 번역된 버전의 감사 메시지를 내보내는 데 사용됩니다. 이 서비스는 보관된 데이터 및 온라인 데이터에서 번역된 감사 메시지를 구성합니다. 이 서비스는 저장소 이름, 대상 경로, 대상 파일 이름, 시작 날짜 및 종료 날짜를 사용하며, 온라인 또는 오프라인 스토리지의 모든 항목을 지정된 대상 경로와 지정된 대상 파일 이름의 zip 파일로 내보냅니다. 내보내기는 감사 날짜를 기준으로 정렬됩니다. 서비스와 해당 입력은 다음과 같습니다.

ExportAuditData(locale[String], targetRepositoryName[THINGNAME],
targetPath[STRING],
targetFileName[STRING],
startDate(dateTime),
endDate(dateTime))
다음 표에는 입력 매개 변수 및 해당 매개 변수에 대한 간단한 설명 및 해당 ThingWorx 기본 유형이 나와 있습니다.
매개 변수
설명
기본 유형
locale
데이터를 내보낼 때 사용되는 언어에 대한 두 문자로 된 약어입니다. 예를 들어, 영어의 경우 "en"이며 프랑스어의 경우 "fr"입니다.
STRING
targetRepositoryName
번역된 감사 항목이 포함된 출력 파일이 저장되는 파일 저장소 사물의 이름입니다.
THINGNAME
targetPath
출력 파일이 작성되어야 하는 위치입니다.
STRING
targetFileName
번역된 감사 데이터가 저장되어야 하는 출력 파일의 이름입니다.
STRING
startDate
내보낼 첫 번째 감사 항목의 날짜 및 시간입니다. 이 감사 항목 이후 및 endDate 이전의 타임스탬프가 있는 모든 감사 항목을 내보냅니다.
DATETIME
endDate
내보낼 마지막 감사 항목의 날짜 및 시간입니다. 이 감사 항목 이전 및 startDate 이후의 타임스탬프가 있는 모든 감사 항목을 내보냅니다.
DATETIME
다음은 이 서비스에 대한 호출의 예입니다.

AuditSubsystem.ExportAuditData("en", myExportRepository, "/auditExport/",
"export_11-03_one_hour", 2017-11-03 18:50:03.000, 2017-11-03 19:50:03.000)
이 예는 /auditExport/export_11-03_one_hour.zip의 myExportRepository에서 내보내기를 영어로 생성합니다. 콘텐츠는 지정된 시작 및 종료 날짜에 따라 모든 온라인 감사 메시지와 모든 오프라인 감사 메시지가 됩니다. 내보낸 zip 파일의 크기는 시작 날짜와 종료 날짜 사이에 수집된 데이터의 양에 따라 달라집니다. 다음 표에는 시작 및 종료 날짜에 따라 달라지는 내보내기의 콘텐츠가 나와 있습니다.
시작 날짜
종료 날짜
내보내기의 콘텐츠
2017-11-03 18:50:03.000 (특정 날짜 및 시간)
2017-11-03 19:50:03.000(특정 날짜 및 시간)
이 예의 경우 시작 날짜와 종료 날짜 사이에 있는 모든 온라인 데이터 및 오프라인 데이터가 동일한 날짜(2017–11–03)이며, 한 시간짜리 데이터(18:50:03.000 ~ 19:50:03.000)입니다.
null
2017-11-03 19:50:03.000(특정 날짜 및 시간)
모든 온라인 데이터와 종료 날짜 및 시간(2017-11-03 19:50:03.000)보다 오래된 오프라인 데이터입니다. 시작 날짜를 null로 설정하면 오프라인 데이터가 보존되기 시작한 실제 날짜에 따라 내보내기에 많은 양의 감사 데이터가 포함될 수 있습니다.
2017-11-03 18:50:03.000 (특정 날짜 및 시간)
null
모든 온라인 데이터와 종료 날짜를 null로 설정하여 지정된 시작 날짜 및 시간과 현재 날짜 및 시간 사이의 오프라인 데이터입니다.
null
null
모든 온라인 및 오프라인 감사 데이터입니다. 이는 시간이 매우 오래 걸릴 수 있으므로 권장되지 않습니다.
다음 계속되는 예에는 export_11-03_one_hour.zip 파일에 AuditArchives/export/export_11-03_one_hour.json 파일이 포함됩니다. 다음은 내보내기에서 JSON의 예입니다.

{
"rows": [
{
"auditCategory": "Modeling",
"sourceType": "ModelTagVocabulary",
"source": "IntegrationTesting",
"id": "12345678-0123-4567-8901-123457890123",
"message": "Created ModelTagVocabulary \"IntegrationTesting\"",
"user": "Administrator",
"timestamp": 1490029001679
},
...
...
]
}
이 예에 대해 반환된 정보에는 다음 세부 정보가 포함됩니다.
• auditCategory - 감사 메시지의 카테고리 이름입니다. 위 예에서는 Modeling 카테고리입니다. 감사 카테고리에 대한 자세한 내용은 감사 카테고리 항목을 참조하십시오.
• sourceType - 이 감사 메시지를 생성한 응용 프로그램과 연관된 유형입니다(source).
• source - 이 감사 메시지를 생성한 ThingWorx 응용 프로그램 또는 실행 파일입니다. 이 예에서 소스는 IntegrationTesting입니다.
• id - 감사 메시지를 생성한 응용 프로그램에 대한 GUID입니다. GUID는 실제로 응용 프로그램에 대해 ThingWorx에서 생성한 응용 프로그램 키입니다.
• message - 감사 메시지의 텍스트입니다.
• user - 감사 메시지가 생성될 때 응용 프로그램을 실행한 사용자의 로그인 이름입니다.
• timestamp - 에포크 시간에서 감사 메시지가 생성된 날짜 및 시간입니다.
내보내기 후 온라인 데이터의 상태
내보내기 후 온라인 데이터는 다음 조건이 충족되는 한 온라인 스토리지에 유지됩니다.
• 온라인 데이터의 기간이 감사 하위 시스템의 DaysOnline 매개 변수에 대해 지정된 일 수보다 짧습니다. 기본적으로 이 설정은 60일입니다.
• 온라인 감사 데이터 테이블에 감사 하위 시스템의 maxEntriesOnlineAuditData 매개 변수에 대해 지정된 최대 행 수보다 적은 행이 있습니다. 기본값은 500000개 행입니다.
내보내기 작업은 ArchiveAuditHistory 서비스를 호출합니다. 이 서비스는 온라인 스토리지의 감사 데이터를 예약된 내보내기를 위해 AuditArchiveFileRepository에 복사하고 온라인 상태로 유지합니다(이러한 조건이 모두 충족된 경우). 이러한 조건 중 하나가 충족되지 않으면(데이터가 일 수보다 오래되었거나 테이블에 최대 행 수보다 많은 행이 있는 경우) 온라인 데이터가 내보내기 중 오프라인 스토리지에 보관된 후 온라인 스토리지에서 제거됩니다.