EvaluateXQuery 2025.10.2.19

Bundle

org.apache.nifi | nifi-standard-nar

Beschreibung

Wertet eine oder mehrere XQueries anhand des Inhalts eines FlowFile aus. Die Ergebnisse dieser XQueries werden FlowFile-Attributen zugewiesen oder in den Inhalt des FlowFile selbst geschrieben, abhängig von der Konfiguration des Prozessors. XQueries werden durch Hinzufügen von benutzerdefinierten Eigenschaften eingegeben; der Name der Eigenschaft wird dem Attributnamen zugeordnet, in dem das Ergebnis platziert wird (wenn das Ziel ein Flowfile-Attribut ist; andernfalls wird der Eigenschaftsname ignoriert). Der Wert der Eigenschaft muss eine gültige XQuery sein. Wenn XQuery mehr als ein Ergebnis zurückgibt, werden neue Attribute oder FlowFiles (für Ziele von „flowfile-attribute“ bzw. „flowfile-content“) für jedes Ergebnis erstellt (Attribute haben eine „.n“-Eins-höher-Nummer, die an den angegebenen Attributnamen angehängt wird). Falls eine vorhandene XQuery ein Ergebnis zurückgibt, werden das bzw. dieFlowFile(s) an „matched“ weitergeleitet. Falls keine vorhandene XQuery ein Ergebnis zurückgibt, wird das FlowFile an „unmatched“ weitergeleitet. Wenn das Ziel „flowfile-attribute“ ist und die XQueries mit nichts übereinstimmen, werden keine Attribute auf das FlowFile angewendet.

Tags

XML, XPath, XQuery, bewerten

Eingabeanforderung

REQUIRED

Unterstützt sensible dynamische Eigenschaften

false

Eigenschaften

Eigenschaft

Beschreibung

Destination

Gibt an, ob die Ergebnisse der XQuery-Auswertung in den FlowFile-Inhalt oder ein FlowFile-Attribut geschrieben werden. Wenn auf <flowfile-content> gesetzt, kann nur eine XQuery angegeben werden und der Eigenschaftsname wird ignoriert. Wenn auf <flowfile-attribute> gesetzt und die XQuery gibt mehr als ein Ergebnis zurück, werden mehrere Attribute zum theFlowFile hinzugefügt, jeweils benannt mit einer einfachen „.n“-Eins-höher-Nummer, die an den angegebenen Attributnamen angehängt wird.

Output: Indent

Gibt an, ob der Prozessor bei der Ausgabe eines Ergebnisbaums zusätzliche Leerzeichen einfügen darf.

Output: Method

Identifiziert die allgemeine Methode, die für die Ausgabe eines Ergebnisbaums verwendet werden soll.

Output: Omit XML Declaration

Gibt an, ob der Prozessor bei der Transformation eines Ergebnisbaums eine XML-Deklaration ausgeben soll.

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 die XQuery nicht anhand des Inhalts des FlowFile ausgewertet werden kann.

matched

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

unmatched

FlowFiles werden an diese Beziehung weitergeleitet, wenn die XQuery 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.