EvaluateJsonPath 2025.10.2.19¶
Bundle¶
org.apache.nifi | nifi-standard-nar
Description¶
Évalue une ou plusieurs expressionsJsonPath par rapport au contenu d’un FlowFile. Les résultats de ces expressions sont assignés aux attributs FlowFile ou sont écrits dans le contenu du fichier FlowFile lui-même, en fonction de la configuration du processeur. Les JsonPaths sont saisis en ajoutant des propriétés définies par l’utilisateur ; le nom de la propriété est mappé au nom d’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 JsonPath valide. Un retour de type “auto-detect” (auto-détection) effectuera une détermination basée sur la destination configurée. Lorsque “Destination” est défini sur “flowfile-attribute” (attribut de flowFile), un retour de type “scalar” sera utilisé. Lorsque “Destination” est défini sur “flowfile-content,” un retour de type “JSON” sera utilisé. Si le JsonPath s’évalue sur un tableau JSON ou un objet JSON et si le type du retour est défini sur “scalar” (scalaire), le FlowFile n’est pas modifié et est acheminé vers failure (échec). Un retour de type JSON peut produire des valeurs scalaires si le JsonPath fournie s’évalue sur la valeur spécifiée et est acheminé comme une correspondance. Si la destination est “flowfile-content” et que JsonPath ne s’évalue pas sur un chemin défini, l” FlowFile est acheminé vers “matched” (sans correspondance) sans que son contenu soit modifié. Si la destination est un “flowfile-attribute” et si l’expression ne correspond à rien, les attributs sont créés avec des chaînes vides comme valeur à moins que “Path Not Found Behaviour” (Comportement chemin non trouvé) ne soit défini sur “skip” (ignorer) et que le FlowFile est toujours acheminé vers “matched” (correspondance) ».
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 JsonPath 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 JsonPath peut être spécifié, et le nom de la propriété est ignoré. |
Longueur maximale de la chaîne |
Longueur maximale autorisée d’une valeur de chaîne lors de l’analyse du document JSON |
Représentation des valeurs nulles |
Indique la représentation souhaitée des expressions du chemin JSON qui aboutissent à une valeur nulle. |
Comportement en cas de chemin non trouvé |
Indique comment traiter les expressions de chemin JSON manquantes lorsque la destination est définie sur flowfile-attribute. L’option « warn » génère un avertissement lorsqu’une expression de chemin JSON n’est pas trouvée. Si vous sélectionnez « ignorer », les attributs de toutes les expressions de chemin JSON ne seront pas pris en compte. |
Type de renvoi |
Indique le type de retour souhaité des expressions de chemin JSON. Sélectionner ’auto-detect’ définira le type de retour sur ’json’ pour une destination “flowfile-content” et “scalar” pour une destination ’flowfile-attribute’. |
Relations¶
Nom |
Description |
|---|---|
failure |
Les FlowFiles sont routés vers cette relation lorsque l’adresse JsonPath ne peut être évaluée par rapport au contenu du FlowFile ; par exemple, si le FlowFile n’est pas un JSON valide |
matched |
Les FlowFiles sont routés vers cette relation lorsque le JsonPath 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 JsonPath ne correspond pas au contenu du FlowFile et que le paramètre Destination est fixé à flowfile-content |