EvaluateJsonPath 2025.10.2.19¶

Bundle¶

org.apache.nifi | nifi-standard-nar

Beschreibung¶

Wertet einen oder mehrere JsonPath-Ausdrücke anhand des Inhalts eines FlowFile aus. Die Ergebnisse dieser Ausdrücke werden FlowFile-Attributen zugewiesen oder werden in den Inhalt der FlowFile selbst geschrieben, abhängig von der Konfiguration des Prozessors. JsonPaths 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 ein gültiger JsonPath-Ausdruck sein. Der Rückgabetyp „auto-detected“ nimmt eine Bestimmung auf der Grundlage des konfigurierten Ziels vor. Wenn „Destination“ auf „flowfile-attribute“ gesetzt ist, wird der Rückgabetyp „scalar“ verwendet. Wenn „Destination“ auf „flowfile-content“ gesetzt ist, wird der Rückgabetyp „JSON“ verwendet. Wenn der JsonPath ein JSON-Array oder ein JSON-Objekt ergibt und der Rückgabetyp auf „scalar“ gesetzt ist, bleibt das FlowFile unverändert und wird an „failure“ weitergeleitet. Ein Rückgabetyp JSON kann skalare Werte zurückgeben, wenn der bereitgestellte JsonPath den angegebenen Wert ergibt, und wird als „match“ weitergeleitet. Wenn das Ziel „flowfile-content“ ist und JsonPath nicht zu einem definierten Pfad ausgewertet wird, wird das FlowFile an „unmatched“ weitergeleitet, ohne dass sein Inhalt geändert wird. Wenn das Ziel „flowfile-attribute“ ist und der Ausdruck mit nichts übereinstimmt, werden Attribute mit leeren Zeichenfolgen als Wert erstellt, es sei denn, „Path Not Found Behaviour“ ist auf „skip“ gesetzt, dann wird das FlowFile wird immer an „matched“ weitergeleitet.

Tags¶

JSON, JsonPath, bewerten

Eingabeanforderung¶

REQUIRED

Unterstützt sensible dynamische Eigenschaften¶

false

Eigenschaften¶

Eigenschaft	Beschreibung
Destination	Gibt an, ob die Ergebnisse der JsonPath-Bewertung in den FlowFile-Inhalt oder in ein FlowFile-Attribut geschrieben werden. Wenn Sie ein Attribut verwenden, müssen Sie die Eigenschaft „Attribute Name“ angeben. Bei der Einstellung „flowfile-content“ kann nur ein JsonPath angegeben werden, und der Eigenschaftsname wird ignoriert.
Max String Length	Die maximal zulässige Länge eines Zeichenfolgenwertes beim Parsen des JSON-Dokuments
Null Value Representation	Gibt die gewünschte Darstellung von JSON-Pfadausdrücken an, die einen Nullwert ergeben.
Path Not Found Behavior	Gibt an, wie fehlende JSON-Pfadausdrücke behandelt werden sollen, wenn das Ziel auf „flowfile-attribute“ gesetzt ist. Wenn Sie „warn“ wählen, wird eine Warnung ausgegeben, wenn ein JSON-Pfadausdruck nicht gefunden wird. Wenn Sie „skip“ wählen, werden Attribute für alle nicht übereinstimmenden JSON-Pfadausdrücke ausgelassen.
Return Type	Gibt den gewünschten Rückgabetyp der JSON-Pfadausdrücke an. Wenn Sie „auto-detect“ auswählen, wird der Rückgabetyp auf „json“ für ein Ziel von „flowfile-content“ und auf „scalar“ für ein Ziel von „flowfile-attribute“ gesetzt.

Beziehungen¶

Name	Beschreibung
failure	FlowFiles werden an diese Beziehung weitergeleitet, wenn der JsonPath nicht anhand des Inhalts des FlowFile ausgewertet werden kann, zum Beispiel, wenn das FlowFile kein gültiges JSON ist.
matched	FlowFiles werden an diese Beziehung weitergeleitet, wenn der JsonPath erfolgreich ausgewertet und das FlowFile daraufhin geändert wurde.
unmatched	FlowFiles werden an diese Beziehung weitergeleitet, wenn der JsonPath nicht mit dem Inhalt des FlowFile übereinstimmt und das Ziel auf „flowfile-content“ gesetzt ist.