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 은 항상 ‘일치’로 라우팅됩니다
입력 요구 사항¶
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 특성으로 설정된 경우 이 프로세서는 사용자 정의 특성을 추가합니다. |