- 트랜잭션 ID
- Skill ID 및 버전
- 단계별 처리 경로:
- 단계 유형
- 이름
- 단계 시작 및 종료 일시
- 소요 시간(초 단위)
- 수동 검토 작업자의 이름과 이메일
- 문서 및 트랜잭션 등록 Parameter
참고: Warehouse는 설정에 따라 한 번도 실행되지 않는 activities에서의 문서 처리 이벤트 정보는 저장하지 않습니다. 예를 들어, Assemble by files 설정은 Vantage의 기본 동작에 해당하므로, 해당 activity에서의 문서 처리는 워크플로에서 생략됩니다.
v1에서 v2로 마이그레이션
transaction-steps v1 엔드포인트가 사용 중단(deprecated)되었습니다. 하위 호환성을 위해 v2 엔드포인트도 유사하게 동작하지만, 엔드포인트 이름이 변경되고 쿼리 매개변수가 요청 본문으로 이동했습니다. v2 엔드포인트는 대용량 데이터 요청을 더 잘 처리하기 위해 비동기 모델로 전환되었습니다. 보고서를 요청한 후에는 보고서가 준비될 때까지 상태를 폴링할 수 있습니다. 완료되면 결과를 다운로드할 수 있습니다.
무엇이 변경되었나요?
/api/reporting/v2/exports/transaction-steps)에서:
- 필터가 쿼리 파라미터에서 요청 본문(
filtersJSON 객체)으로 이동했습니다. - 이제
filters객체 안에 지정하는startDate가 필수입니다. - 새 field:
sendEmailNotification(true/false) - 보고서를 다운로드할 준비가 되면 보고서 요청자에게 이메일을 발송합니다.
/api/reporting/v2/exports/transaction-steps/{{requestId}}/result/{fileIndex})로 다운로드되는 CSV 파일에는 두 개의 열이 추가되었습니다.
DocumentsCount: 트랜잭션에서 처리된 문서 수.PagesCount: 트랜잭션에서 처리된 페이지 수.
데이터 보고서 다운로드
참고: Tenant Administrator 및 Processing Supervisor 역할을 가진 사용자만 Warehouse에서 데이터 보고서를 다운로드할 수 있습니다. 자세한 내용은 역할 기반 액세스 제어를 참조하세요.Warehouse에서 데이터를 CSV 파일 형식으로 가져오려면 Vantage API를 사용할 수 있습니다. 이를 위해 다음 리소스로 POST 요청을 전송합니다: 요청 본문에는
filters 객체 내에 다음 속성이 포함되어야 합니다:
- skillId. 다운로드할 트랜잭션이 속한 스킬의 ID입니다. 선택 사항.
- transactionId. 필터링 대상 트랜잭션의 ID입니다. 선택 사항.
- startDate. 트랜잭션을 다운로드할 기간의 시작일입니다(예시 형식: 2022-01-07T13:03:38, 시간은 UTC여야 합니다). 필수.
- endDate. 트랜잭션을 다운로드할 기간의 종료일입니다(예시 형식: 2022-09-07T13:03:38, 시간은 UTC여야 합니다). 선택 사항.
- sendEmailNotification. 보고서 요청을 생성한 사용자에게 보고서를 다운로드할 수 있게 되면 이를 알리는 이메일을 전송합니다. 선택 사항.
requestId가 반환됩니다.
결과:
requestId를 포함합니다:
보고서가 생성되면 status 값은 “Succeeded”가 되고, totalFileCount는 다운로드할 수 있는 파일 수를 표시합니다:
requestId를 다시 전달하고 파일의 0부터 시작하는 인덱스인 fileIndex를 추가하여 다음 엔드포인트에 GET 요청을 보내십시오. 예를 들어 "totalFileCount": 3인 경우 사용 가능한 파일 인덱스는 0, 1, 2입니다.
다음은 CSV 응답 예시입니다:
| SkillId | SkillVersion | SkillName | TransactionId | StepName | StepType | ManualReviewOperatorName | ManualReviewOperatorEmail | StartedUtc | CompletedUtc | Status | Duration | DocumentsCount | PagesCount | document_SourceFileName | document_SourceType | transaction_App |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| d0e27b2d-bcc6-4129-bfd1-c1e37ee3efae | 1 | Redaction Test | 6d7e9eeb-86e3-4952-8e29-3f76b3fae59f | Input | Input | 11/17/2025 19:37:52 | 11/17/2025 19:38:01 | FinishedSuccessfully | 9 | Invoice CA_2.pdf | PublicAPI | PublicAPI | ||||
| d0e27b2d-bcc6-4129-bfd1-c1e37ee3efae | 1 | Redaction Test | 6d7e9eeb-86e3-4952-8e29-3f76b3fae59f | OCR | Ocr | 11/17/2025 19:38:02 | 11/17/2025 19:38:17 | FinishedSuccessfully | 15 | Invoice CA_2.pdf | PublicAPI | PublicAPI | ||||
| d0e27b2d-bcc6-4129-bfd1-c1e37ee3efae | 1 | Redaction Test | 6d7e9eeb-86e3-4952-8e29-3f76b3fae59f | Classify | Classification | 11/17/2025 19:38:17 | 11/17/2025 19:38:20 | FinishedSuccessfully | 3 | Invoice CA_2.pdf | PublicAPI | PublicAPI | ||||
| d0e27b2d-bcc6-4129-bfd1-c1e37ee3efae | 1 | Redaction Test | 6d7e9eeb-86e3-4952-8e29-3f76b3fae59f | Extract | Extraction | 11/17/2025 19:38:21 | 11/17/2025 19:38:44 | FinishedSuccessfully | 23 | Invoice CA_2.pdf | PublicAPI | PublicAPI | ||||
| d0e27b2d-bcc6-4129-bfd1-c1e37ee3efae | 1 | Redaction Test | 6d7e9eeb-86e3-4952-8e29-3f76b3fae59f | Output | Output | 11/17/2025 19:38:47 | 11/17/2025 19:39:01 | Failed | 13 | Invoice CA_2.pdf | PublicAPI | PublicAPI |
Response Structure
| Column | Description |
|---|---|
SkillId | 스킬 ID. |
SkillVersion | 스킬 버전. |
SkillName | 스킬 이름. |
TransactionId | 트랜잭션 ID. |
StepName | 이벤트 이름 또는 프로세스 스킬의 경우 액티비티 이름. |
StepType | 이벤트 유형. 가능한 값: - Input (모든 스킬 유형에서 사용 가능) - Ocr (OCR 스킬 또는 OCR 액티비티가 추가된 프로세스 스킬에서 사용 가능) - Classification (분류 스킬 또는 Classification 액티비티가 추가된 프로세스 스킬에서 사용 가능) - Extraction (모든 스킬 유형에서 사용 가능) - Condition (Condition 액티비티가 추가된 프로세스 스킬에서 사용 가능) - CustomActivity (Custom 액티비티가 추가된 프로세스 스킬에서 사용 가능) - WaitingForManualReview (Manual Review 액티비티가 추가된 프로세스 스킬에서 사용 가능). 트랜잭션이 수동 검토를 기다린 시간 - ManualReview (Manual Review 액티비티가 추가된 프로세스 스킬에서 사용 가능). 오퍼레이터가 트랜잭션을 검증한 시간 - Output (모든 스킬 유형에서 사용 가능) |
ManualReviewOperatorName | Manual Review 오퍼레이터 이름. |
ManualReviewOperatorEmail | Manual Review 오퍼레이터 이메일. |
StartedUtc | 이벤트 시작 시간(UTC). 예를 들어, 5/3/2022 1:59:02 PM. |
CompletedUtc | 이벤트 종료 시간(UTC). |
Status | 이벤트 상태. 가능한 값: - Processing - Finished Successfully - Canceled - Failed |
Duration | 이벤트의 지속 시간(초 단위). |
DocumentsCount | 트랜잭션에서 처리된 문서 수. |
PagesCount | 트랜잭션에서 처리된 페이지 수. |
document_*, transaction_* | 처리 시 전달된 문서 또는 트랜잭션 파라미터. 헤더에서 문서 파라미터에는 접두사 document_ 가, 트랜잭션 파라미터에는 접두사 transaction_ 가 추가됩니다. 예를 들어, document_SourceFileName. 트랜잭션에 이름은 같지만 값이 다른 파라미터를 가진 문서들이 포함되어 있는 경우, Warehouse는 이 파라미터의 모든 고유 값을 쉼표로 구분하여 나열합니다. 예를 들어, 하나의 트랜잭션 내 모든 파일 이름. |
리포팅 요청 목록 검색
GET 요청을 보냅니다. 여기서 createdFrom 및 createdTo는 날짜 범위를 나타내며, statusFilter는 다음 값 중 하나입니다: New, Queued, Processing, Succeeded, Failed, Cancelled. 이 방법은 요청 ID를 잃어버린 경우에 유용합니다.
응답에는 리포팅 요청의 배열이 포함됩니다.