EvaluateXPath 2025.5.31.15

Bundle

org.apache.nifi | nifi-standard-nar

Beschreibung

Bewertet eine oder mehrere XPaths anhand des Inhalts eines FlowFile. Die Ergebnisse dieser XPaths werden den FlowFile-Attributen zugewiesen oder in den Inhalt des FlowFile selbst geschrieben, je nach Konfiguration des Prozessors. XPaths werden durch Hinzufügen von benutzerdefinierten Eigenschaften eingegeben. Der Name der Eigenschaft wird dem Attributnamen zugeordnet, in den das Ergebnis eingefügt wird (wenn das Ziel „flowfile-attribute“ ist; andernfalls wird der Eigenschaftsname ignoriert). Der Wert der Eigenschaft muss ein gültiger XPath-Ausdruck sein. Wenn der XPath mehr als einen Knoten auswertet und der Rückgabetyp auf „nodeset“ gesetzt ist (entweder direkt oder über „auto-detect“ mit einem Ziel von „flowfile-content“), bleibt das FlowFile unverändert und wird an die Beziehung „failure“ weitergeleitet. Wenn der XPath nicht auf einen Knoten ausgewertet wird, wird das FlowFile an die Beziehung „unmatched“ weitergeleitet, ohne dass sein Inhalt geändert wird. Wenn das Ziel „flowfile-attribute“ ist und der Ausdruck keine Übereinstimmung findet, werden Attribute mit leeren Zeichenfolgen als Wert erstellt und das FlowFile wird immer an die Beziehung „matched“ weitergeleitet.

Tags

XML, XPath, bewerten

Eingabeanforderung

REQUIRED

Unterstützt sensible dynamische Eigenschaften

false

Eigenschaften

Eigenschaft

Beschreibung

Destination

Gibt an, ob die Ergebnisse der XPath-Bewertung in den FlowFile-Inhalt oder in ein FlowFile-Attribut geschrieben werden. Wenn Sie ein Attribut verwenden, müssen Sie die Eigenschaft „Attribut Name“ angeben. Bei der Einstellung „flowfile-content“ kann nur ein XPath angegeben werden, und der Eigenschaftsname wird ignoriert.

Return Type

Gibt den gewünschten Rückgabetyp der Xpath-Ausdrücke an. Wenn Sie „auto-detect“ wählen, wird der Rückgabetyp bei einem „flowfile-content“-Ziel auf „nodeset“ und bei einem „flowfile-attribute“-Ziel auf „string“ gesetzt.

Validate DTD

Eingebettete Document Type Declaration in XML zulassen. Dieses Feature sollte deaktiviert werden, um Sicherheitslücken durch die Erweiterung von XML-Entitäten zu vermeiden.

Beziehungen

Name

Beschreibung

failure

FlowFiles werden an diese Beziehung weitergeleitet, wenn der XPath nicht gegen den Inhalt des FlowFile ausgewertet werden kann, z. B. wenn das FlowFile kein gültiges XML ist, oder wenn der Rückgabetyp „nodeset“ ist und der XPath auf mehrere Knoten ausgewertet wird.

matched

FlowFiles werden an diese Beziehung weitergeleitet, wenn der XPath erfolgreich ausgewertet und das FlowFile daraufhin geändert wurde.

unmatched

FlowFiles werden an diese Beziehung weitergeleitet, wenn der XPath nicht mit dem Inhalt des FlowFile übereinstimmt und das Ziel auf „flowfile-content“ gesetzt ist.

Schreibt Attribute

Name

Beschreibung

user-defined

Dieser Prozessor fügt benutzerdefinierte Attribute hinzu, wenn die Eigenschaft <Destination> auf „flowfile-attribute“ gesetzt ist.