EvaluateXQuery 2025.5.31.15

번들

org.apache.nifi | nifi-standard-nar

설명

FlowFile 의 내용에 대해 1개 이상의 XQueries 를 평가합니다. 이러한 식의 결과는 프로세서의 구성에 따라 FlowFile 특성에 할당되거나 FlowFile 자체의 내용에 기록됩니다. XQueries 는 사용자 정의 속성을 추가하여 입력되며, 속성 이름은 결과가 배치될 특성 이름에 매핑됩니다(대상이 flowfile 속성인 경우, 그렇지 않으면 속성 이름이 무시됨). 속성 값은 유효한 XQuery 여야 합니다. XQuery 가 2개 이상의 결과를 반환하는 경우, 각 결과에 대해 새 특성 또는 FlowFiles (‘flowfile-attribute’ 또는 ‘flowfile-content’ 대상의 경우 각각)이 생성됩니다(특성에는 지정된 속성 이름에 ‘.n’ 1이 증가한 번호가 추가됨). 제공된 XQuery 가 결과를 반환하면 FlowFile 은 ‘일치’로 라우팅됩니다. 제공된 XQuery 에서 결과가 반환되지 않으면 FlowFile 은 ‘unmatched’로 라우팅됩니다. 대상이 ‘flowfile-attribute’이고 XQueries 가 일치하는 항목이 없는 경우 FlowFile 에 아무런 특성이 적용되지 않습니다.

태그

XML, XPath, XQuery, 평가

입력 요구 사항

REQUIRED

민감한 동적 속성 지원

false

속성

속성

설명

Destination

XQuery 평가 결과를 FlowFile 내용에 기록할지, FlowFile 특성에 기록할지를 나타냅니다. <flowfile-content>로 설정된 경우 1개의 XQuery 만 지정할 수 있으며 속성 이름은 무시됩니다. <flowfile-attribute>로 설정하고 XQuery 가 2개 이상의 결과를 반환하는 경우, 여러 특성이 지정된 특성 이름에 ‘.n’이 1 증가한 번호가 추가되어 각 theFlowFile 에 추가됩니다

출력: 들여쓰기

결과 트리를 출력할 때 프로세서가 추가 공백을 추가할지 여부를 지정합니다.

출력: 메서드

결과 트리 출력에 사용해야 하는 전체 메서드를 식별합니다.

출력: XML 선언 생략

결과 트리를 변환할 때 프로세서가 XML 선언을 출력할지 여부를 지정합니다.

DTD 유효성 검사

XML 에서 임베디드 문서 유형 선언을 허용합니다. XML 엔터티 확장 취약점을 방지하려면 이 기능을 비활성화해야 합니다.

관계

이름

설명

실패

XQuery 가 FlowFile 의 내용과 일치하지 않을 경우 FlowFiles 은 이 관계로 라우팅됩니다.

matched

FlowFiles 은 XQuery 가 성공적으로 평가되고 FlowFile 이 수정되면 이 관계로 라우팅됩니다

unmatched

XQuery 가 FlowFile 의 내용과 일치하지 않고 대상이 flowfile-content로 설정된 경우 FlowFiles 은 이 관계로 라우팅됩니다.

Writes 특성

이름

설명

user-defined

<Destination> 속성이 flowfile 특성으로 설정된 경우 이 프로세서는 사용자 정의 특성을 추가합니다.