EvaluateXPath 2025.5.31.15¶

Bundle¶

org.apache.nifi | nifi-standard-nar

Description¶

Évalue un ou plusieurs XPaths par rapport au contenu d’un FlowFile. Les résultats de ces XPaths sont attribués aux attributs de FlowFile ou sont écrits dans le contenu de FlowFile lui-même, en fonction de la configuration du processeur. Les XPaths sont saisis en ajoutant des propriétés définies par l’utilisateur ; le nom de la propriété mappe le nom de l’attribut dans lequel le résultat sera placé (si la destination est flowfile-attribute ; sinon, le nom de la propriété est ignoré). La valeur de la propriété doit être une expression XPath valide. Si XPath évalue plus d’un nœud et que le type de retour est réglé sur nodeset (soit directement, soit via « auto-detection » avec une destination de flowfile-content), FlowFile ne sera pas modifié et sera routé vers « échec ». Si l’adresse XPath ne correspond pas à un nœud, l’adresse FlowFile sera routée vers sans correspondance sans que son contenu ne soit modifié. Si Destination est flowfile-attribute et que l’expression ne correspond à rien, les attributs seront créés avec des chaînes vides comme valeur, et le FlowFile sera toujours routé vers avec « correspondance »

Balises¶

XML, XPath, évaluer

Exigences en matière d’entrées¶

REQUIRED

Prend en charge les propriétés dynamiques sensibles¶

false

Propriétés¶

Propriété	Description
Destination	Indique si les résultats de l’évaluation XPath sont écrits dans le contenu FlowFile ou dans un attribut FlowFile ; si vous utilisez un attribut, vous devez spécifier la propriété Nom de l’attribut. S’il est paramétré sur flowfile-content, un seul XPath peut être spécifié, et le nom de la propriété est ignoré.
Type de renvoi	Indique le type de retour souhaité pour les expressions Xpath. En sélectionnant « auto-détection », le type de retour sera « nodeset » pour une destination de type « flowfile-content », et « string » pour une destination de type flowfile-attribute.
Valider DTD	Autoriser la déclaration de type de document intégrée dans XML. Cette fonction doit être désactivée pour éviter les vulnérabilités liées à l’expansion de l’entité XML.

Relations¶

Nom	Description
failure	Les FlowFiles sont routés vers cette relation lorsque le XPath ne peut pas être évalué par rapport au contenu du FlowFile ; par exemple, si le FlowFile n’est pas un XML valide, ou si le type de retour est « nodeset » et que le XPath évalue plusieurs nœuds
matched	Les FlowFiles sont routés vers cette relation lorsque le XPath est évalué avec succès et que le FlowFile est modifié en conséquence
unmatched	Les FlowFiles sont routés vers cette relation lorsque le XPath ne correspond pas au contenu du FlowFile et que le paramètre Destination est fixé à flowfile-content

Écrit les attributs¶

Nom	Description
user-defined	Ce processeur ajoute des attributs définis par l’utilisateur si la propriété <Destination> est paramétrée sur flowfile-attribute.