ExtractStructuredBoxFileMetadata 2025.5.31.15¶

번들¶

org.apache.nifi | nifi-box-nar

설명¶

Box AI 를 사용하여 Box 파일에서 메타데이터를 추출합니다. 추출은 템플릿 또는 필드 목록을 사용할 수 있습니다. 추출된 메타데이터는 FlowFile 내용 에JSON 으로 기록됩니다.

태그¶

ai, box, extract, metadata, storage

입력 요구 사항¶

REQUIRED

민감한 동적 속성 지원¶

false

속성¶

속성	설명
Extraction Method	메타데이터 추출에 사용할 메서드입니다. TEMPLATE 은 추출을 위해 Box 메타데이터 템플릿을 사용합니다. FIELDS 는 JSON 필드 스키마(FlowFile 내용에서 읽기)를 사용하여 추출합니다.
파일 ID	메타데이터를 추출할 파일의 ID 입니다.
Record Reader	수신 데이터를 구문 분석하는 데 사용할 Record Reader입니다. 추출 방법이 FIELDS 인 경우 필수입니다.
Template Key	추출에 사용할 메타데이터 템플릿의 키입니다. 추출 방법이 TEMPLATE 인 경우 필수입니다.
box-client-service	Box API 연결을 얻는 데 사용되는 컨트롤러 서비스입니다.

관계¶

이름	설명
실패	메타데이터 추출 중에 오류가 발생하면 FlowFile 은 이 관계로 라우팅됩니다.
file not found	지정된 Box 파일이 발견되지 않은 FlowFiles 은 이 관계로 라우팅됩니다.
성공	메타데이터가 성공적으로 추출된 후 FlowFile 은 이 관계로 라우팅됩니다.
template not found	지정된 메타데이터 템플릿을 찾을 수 없는 경우 FlowFiles 은 이 관계로 라우팅됩니다.

Writes 특성¶

이름	설명
box.id	메타데이터가 추출된 파일의 ID
box.ai.template.key	추출에 사용되는 템플릿 키(TEMPLATE추출 방법 사용 시)
box.ai.extraction.method	사용된 추출 방법(TEMPLATE 또는 FIELDS)
box.ai.completion.reason	AI 추출의 완료 이유
mime.type	JSON 내용에 대해 ‘application/json’으로 설정합니다
error.code	Box에서 반환한 오류 코드
error.message	Box에서 반환하는 오류 메시지

참고 항목¶