메인 콘텐츠로 건너뛰기
Analytics Reporting Warehouse는 시스템 내 문서 처리 효율성을 분석하는 데 사용할 수 있는 데이터를 저장합니다. 이 데이터를 통해 어떤 문서가 수동 검토에 더 많은 시간이 걸리는지와 그 이유를 파악할 수 있습니다. 통계는 적어도 하나의 수동 검토 단계가 있고, 적어도 하나의 Document skill을 포함하는 프로세스 스킬에 대해 수집됩니다. 시스템은 수동 검토 이전 문서의 초기 상태와 처리 후 상태를 비교합니다. Analytics Reporting Warehouse는 다음 데이터를 저장합니다:
  • 문서 변경 사항에 대한 정보
  • 문서 field에 대한 정보:
    • 추출된 field 값의 개수
    • 변경된 field 값의 개수
    • 각 field의 상태(올바른지, 인식 문제 여부, 잘못된 위치에 배치되었는지, 또는 감지되지 않았는지)

v1에서 v2로 마이그레이션

경로만 “/v1/”에서 “/v2/”로 변경되었습니다. 요청/응답 field나 동작에는 변경 사항이 없습니다.

데이터 보고서 다운로드

참고: Tenant Administrator 또는 Processing Supervisor 역할을 가진 사용자만 데이터 보고서를 다운로드할 수 있습니다. 자세한 내용은 역할 기반 액세스 제어를 참조하십시오.
Analytics Reporting Warehouse에서 데이터를 가져오려면, 필요한 보고서 유형에 따라 다음 리소스 중 하나에 GET 요청을 보내십시오.

프로세스 스킬로 처리된 문서 데이터 가져오기

Process 스킬과 Document skill에서 처리된 field 데이터 가져오기

요청 본문에는 다음 매개변수를 포함합니다.
  • startDate. 데이터를 다운로드할 기간의 시작일(예시 형식: 2022-01-07T13:03:38, 시간은 UTC 기준이어야 함). 필수 매개변수입니다.
  • endDate. 데이터를 다운로드할 기간의 종료일(예시 형식: 2022-09-07T13:03:38, 시간은 UTC 기준이어야 함).
  • processSkillId. 데이터를 다운로드할 대상 프로세스 스킬의 ID입니다. 필수 매개변수입니다.
  • documentSkillId. 데이터를 다운로드할 대상 Document skill의 ID입니다.
참고: 이 매개변수는 /api/reporting/v1/qa/process-skills/fields 요청에만 포함할 수 있습니다.
  • imageType. 문서 이미지 유형입니다. 가능한 값: Unknown, Receipt, A4, BusinessCard, Book, Id, PassportRus, DiscountCard, BankCard, NotDocument, PassportPage.
  • imageColority. 문서의 첫 번째 페이지가 어떤 색상 모드인지 나타냅니다. 가능한 값: BlackWhite, Gray, Color.
  • imageSource. 문서 이미지의 출처입니다. 가능한 값: Unknown, Photo, Scan, Synthetic, Screenshot, Pdf.
  • wasCorrectedInManualReview. 수동 검토 중에 문서 field가 수정되었는지 여부를 나타냅니다.
  • wasDocumentTypeChangedInManualReview. 수동 검토 중에 문서 유형이 변경되었는지 여부를 나타냅니다.
결과 CSV 파일에는 다음 정보가 열 단위로 정렬되어 포함됩니다.

문서 변경 내역 보고서

ColumnDescription
ProcessSkillId프로세스 스킬 ID입니다.
ProcessSkillVersion프로세스 스킬 버전입니다.
ProcessSkillName프로세스 스킬 이름입니다.
DocumentSkillIdDocument skill ID입니다.
DocumentSkillVersionDocument skill 버전입니다.
DocumentSkillNameDocument skill 이름입니다.
TransactionId트랜잭션 ID입니다.
HasManualReview문서가 수동 검토되었는지 여부를 나타냅니다. 가능한 값: 1 또는 0입니다.
DocumentId처리를 위해 전달된 문서의 ID입니다.
DocumentName처리를 위해 전달된 문서의 이름입니다.
PageSize문서의 첫 번째 페이지 크기(픽셀 단위, 너비와 높이)입니다.
ImageColority문서의 첫 번째 페이지가 컬러, 그레이, 흑백인지 여부를 나타냅니다.
ImageSource문서의 첫 번째 페이지 이미지 소스입니다. 예를 들어, 스캔, 사진, PDF 파일, 스크린샷 등이 있습니다.
ImageType문서의 첫 번째 페이지 이미지 유형입니다. 예를 들어, A4, 영수증, 신용카드 등이 있습니다.
DPI문서의 첫 번째 페이지에 있는 도트(또는 픽셀) 수입니다.
TransactionParameter1..N처리를 위해 전달된 트랜잭션 Parameter입니다. 문서에 트랜잭션 Parameter가 없으면, 보고서의 해당 값은 null입니다.
DimensionField1..MValue처리를 위해 전달된 dimension field입니다. 문서에 dimension field가 없으면, 보고서의 해당 값은 null입니다.
DocumentSkillChanged수동 검토 중에 문서 유형이 변경되었는지 여부를 나타냅니다. 가능한 값: true, false입니다.
DocumentSkillIdUsedBeforeManualReview수동 검토 단계 이전에 문서에 적용된 Document skill입니다.
NumberOfExportedFields문서에서 내보낸 field 수입니다.
NumberOfChangedFields문서에서 수동으로 변경된 field 수입니다.
이 보고서의 데이터는 12개월 동안 저장됩니다.

field 변경에 대한 보고서

ColumnDescription
ProcessSkillId프로세스 스킬의 ID입니다.
ProcessSkillVersion프로세스 스킬의 버전입니다.
ProcessSkillName프로세스 스킬의 이름입니다.
DocumentSkillIdDocument skill의 ID입니다.
DocumentSkillVersionDocument skill의 버전입니다.
DocumentSkillNameDocument skill의 이름입니다.
TransactionId트랜잭션의 ID입니다.
HasManualReview문서가 수동으로 검토되었는지 여부를 나타냅니다. 가능한 값: 1 또는 0.
DocumentId처리 대상으로 전달된 문서의 ID입니다.
DocumentName처리 대상으로 전달된 문서의 이름입니다.
PageSize문서 첫 번째 페이지의 크기(픽셀 기준, 너비와 높이)입니다.
ImageColority문서 첫 번째 페이지가 컬러, 그레이스케일 또는 흑백인지 여부를 나타냅니다.
ImageSource문서 첫 번째 페이지의 이미지 소스입니다. 예: 스캔, 사진, PDF 파일, 스크린샷 등.
ImageType문서 첫 번째 페이지의 이미지 유형입니다. 예: A4, 영수증, 은행 카드 등.
DPI문서 첫 번째 페이지의 DPI(인치당 도트/픽셀 수)입니다.
TransactionParameter1..N처리 대상으로 전달된 트랜잭션 파라미터입니다. 문서에 트랜잭션 파라미터가 없으면, 보고서의 값은 null입니다.
DimensionField1..MValue처리 대상으로 전달된 Dimension field입니다. 문서에 Dimension field가 없으면, 보고서의 값은 null입니다.
DocumentSkillChanged수동 검토 중에 문서 유형이 변경되었는지 여부를 나타냅니다. 가능한 값: true, false.
DocumentSkillIdUsedBeforeManualReview수동 검토 단계 이전에 문서에 적용된 Document skill입니다.
NumberOfExportedFields문서에서 내보낸 field의 수입니다.
NumberOfChangedFields문서에서 수동으로 변경된 field의 수입니다.
FieldID문서 field의 ID입니다.
FieldName문서 field의 이름입니다.
Correct반복되지 않는 field의 교정 상태와, 교정되지 않은 반복 field 인스턴스 수에 대한 정보입니다. 가능한 값:
- 반복되지 않는 field가 수동 검토 중에 교정되지 않은 경우 1.
- 수동 검토 중에 교정되지 않은 반복 field 인스턴스의 수.
RecognitionIssue문서 field 처리 중 발생한 인식 문제에 대한 정보입니다. 가능한 값:
- 반복되지 않는 field의 값은 교정되었으나, 영역은 교정되지 않은 경우 1.
- 수동 검토 중에 반복 field의 값이 교정된 인스턴스의 수.
DetectedIncorrectly수동 검토 중 수행된 교정에 대한 정보입니다. 가능한 값:
- 반복되지 않는 field의 영역과 값이 모두 교정된 경우 1.
- 수동 검토 중에 반복 field의 영역과 값이 교정된 인스턴스의 수.
NotDetected수동 검토 이전에는 추출되지 않았던 field 값에 대한 정보입니다. 가능한 값:
- 수동 검토 이전에는 반복되지 않는 field의 값이 추출되지 않았고, 검증자가 생성한 경우 1.
- 수동 검토 중에 생성된 반복 field 값 인스턴스의 수.
IsInDocument해당 field가 문서 내에 하나 이상의 인스턴스를 가지고 있는지 여부를 나타냅니다. 가능한 값: true, false.
이 보고서의 데이터는 14일 동안 저장됩니다. CSV 형식으로 얻은 데이터는 어떤 BI 도구에서도 추가로 분석할 수 있습니다.