EvaluateXPath 2025.5.31.15

번들

org.apache.nifi | nifi-standard-nar

설명

FlowFile 의 내용에 대해 1개 이상의 XPaths 를 평가합니다. 이러한 식의 결과는 프로세서의 구성에 따라 FlowFile 특성에 할당되거나 FlowFile 자체의 내용에 기록됩니다. XPaths 는 사용자 정의 속성을 추가하여 입력되며, 속성 이름은 결과가 배치될 특성 이름에 매핑됩니다(대상이 flowfile 속성인 경우, 그렇지 않으면 속성 이름이 무시됨). 속성 값은 유효한 XPath 식이어야 합니다. XPath 가 두 개 이상의 노드로 평가되고 반환 유형이 ‘nodeset’으로 설정된 경우(직접 또는 ‘flowfile-content’를 대상으로 ‘auto-detect’를 통해), FlowFile 은 수정되지 않고 실패로 라우팅됩니다. XPath 가 노드로 평가되지 않으면 FlowFile 은 내용을 수정하지 않고 ‘unmatched’로 라우팅됩니다. 대상이 flowfile-attribute고 식이 일치하는 항목이 없는 경우 빈 문자열을 값으로 사용하여 특성이 생성되고 FlowFile 은 항상 ‘일치’로 라우팅됩니다

태그

XML, XPath, 평가

입력 요구 사항

REQUIRED

민감한 동적 속성 지원

false

속성

속성

설명

Destination

XPath 평가의 결과를 FlowFile 내용에 기록할지, FlowFile 특성에 기록할지를 나타내며, 특성을 사용하는 경우 속성 이름 속성을 지정해야 합니다. flowfile 내용으로 설정된 경우 1개의 XPath 만 지정할 수 있으며 속성 이름은 무시됩니다.

Return Type

Xpath 식의 원하는 반환 유형을 나타냅니다. ‘auto-detect’를 선택하면 반환 유형이 ‘flowfile-content’ 대상의 경우 ‘노드 집합’으로,’flowfile-attribute’ 대상의 경우’문자열’로 설정됩니다.

DTD 유효성 검사

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

관계

이름

설명

실패

FlowFiles 은 XPath 가 FlowFile 의 내용에 대해 평가될 수 없는 경우, 예를 들어, FlowFile 이 유효하지 않은 경우 XML 또는 반환 유형이 ‘노드 집합’이고 XPath 가 여러 노드로 평가되는 경우 이 관계로 라우팅됩니다

matched

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

unmatched

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

Writes 특성

이름

설명

user-defined

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