EvaluateJsonPath 2025.5.31.15¶

Bundle¶

org.apache.nifi | nifi-standard-nar

Beschreibung¶

Bewerten einen oder mehrere JsonPath-Ausdrücke anhand des Inhalts eines FlowFile. Die Ergebnisse dieser Ausdrücke werden FlowFile-Attributen zugewiesen oder in den Inhalt des FlowFile selbst geschrieben, je nach Konfiguration des Prozessors. JsonPaths 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 JsonPath-Ausdruck sein. Beim Rückgabetyp von „auto-detect“ wird die Bestimmung anhand des konfigurierten Ziels vorgenommen. Wenn „Destination“ auf „flowfile-attribute“ gesetzt ist, wird der Rückgabetyp „scalar“ verwendet. Wenn das Ziel auf „flowfile-content“ festgelegt ist, wird ein Rückgabetyp von „JSON“ verwendet. Wenn JsonPath ein JSON-Array oder JSON-Objekt auswertet und der Rückgabetyp auf „scalar“ eingestellt ist, wird das FlowFile nicht verändert und an die Beziehung „failure“ weitergeleitet. Ein Rückgabetyp von JSON kann skalare Werte zurückgeben, wenn der angegebene JsonPath auf den angegebenen Wert ausgewertet wird und an die Beziehung „matched“ weitergeleitet wird. Wenn das Ziel „flowfile-content“ ist und der JsonPath nicht auf einen definierten Pfad ausgewertet wird, wird das FlowFile ohne Änderung seines Inhalts an die Beziehung „unmatched”weitergeleitet. Wenn das Ziel „flowfile-attribute“ ist und der Ausdruck nichts findet, werden Attribute mit leeren Zeichenfolgen als Wert erstellt, es sei denn, „Path Not Found Behaviour“ ist auf „skip“ gesetzt, und das FlowFilewird immer an die Beziehung „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“ wählen, wird der Rückgabetyp bei einem „flowfile-content“-Ziel auf „json“ und bei einem „flowfile-attribute“-Ziel auf „scalar“ 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.