ExtractStructuredBoxFileMetadata 2025.10.9.21 — Box 파일 메타데이터 추출 프로세서

ExtractStructuredBoxFileMetadata 프로세서는 Box AI를 사용해 Box 파일에서 메타데이터를 추출해요. 템플릿이나 필드 목록 중 하나를 사용해 추출할 수 있으며, 추출된 메타데이터는 JSON으로 FlowFile 내용에 기록돼요.

출처: Snowflake 문서

본문

기능 — 일반 공개 (Generally Available)

Openflow Snowflake 배포는 AWS, Azure, GCP의 상용 리전에서 모든 계정에 제공돼요.

Openflow BYOC 배포는 AWS의 상용 리전에서 모든 계정에 제공돼요.

org.apache.nifi | nifi-box-nar

Box AI를 사용해 Box 파일에서 메타데이터를 추출해요. 추출에는 템플릿 또는 필드 목록을 사용할 수 있어요. 추출된 메타데이터는 JSON으로 FlowFile 내용에 기록돼요.

REQUIRED

false

Property	Description
Box Client Service	Box API 연결을 얻는 데 사용하는 Controller Service예요
Extraction Method	메타데이터 추출에 사용할 방법이에요. TEMPLATE는 Box 메타데이터 템플릿을 사용해 추출하고, FIELDS는 (FlowFile 내용에서 읽은) 필드의 JSON 스키마를 사용해 추출해요
File ID	메타데이터를 추출할 파일의 ID예요
Record Reader	들어오는 데이터를 파싱하는 데 사용할 Record Reader예요. Extraction Method가 FIELDS일 때 필수예요
Template Key	추출에 사용할 메타데이터 템플릿의 키예요. Extraction Method가 TEMPLATE일 때 필수예요

Name	Description
failure	메타데이터 추출 중 오류가 발생하면 FlowFile이 이 관계로 라우팅돼요
file not found	지정된 Box 파일을 찾지 못한 FlowFile이 이 관계로 라우팅돼요
success	메타데이터를 성공적으로 추출한 후 FlowFile이 이 관계로 라우팅돼요
template not found	지정된 메타데이터 템플릿을 찾지 못한 FlowFile이 이 관계로 라우팅돼요

Name	Description
box.id	메타데이터를 추출한 파일의 ID
box.ai.template.key	추출에 사용된 템플릿 키 (TEMPLATE 추출 방법을 사용할 때)
box.ai.extraction.method	사용된 추출 방법 (TEMPLATE 또는 FIELDS)
box.ai.completion.reason	AI 추출의 완료 사유(completion reason)
mime.type	JSON 내용에 대해 'application/json'으로 설정돼요
error.code	Box가 반환한 오류 코드
error.message	Box가 반환한 오류 메시지