EvaluateJsonPath 2025.5.31.15¶
Bundle¶
org.apache.nifi | nifi-standard-nar
Description¶
Évalue une ou plusieurs expressions de JsonPath par rapport au contenu du FlowFile. Les résultats de ces expressions sont affectés aux attributs du FlowFile ou sont inscrits dans le contenu de 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é mappe le nom de l’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. Si le type de retour est « auto-détection », la détermination se fera en fonction de la destination configurée. Lorsque le paramètre Destination est défini sur lowfile-attribute, un type de retour scalaire sera utilisé. JSON Si JsonPath évalue un tableau JSON ou un objet JSON et que le type de retour est défini sur scalaire, le FlowFile ne sera pas modifié et sera routé vers l’échec. Un type de retour de JSON peut renvoyer des valeurs scalaires si le fichier JsonPath fourni est évalué à la valeur spécifiée et sera routé comme une correspondance. Si la destination est flowfile-content et que le JsonPath n’est pas évalué à un chemin défini, le FlowFile sera routé vers « sans correspondance » sans que son contenu soit modifié. Si la destination est flowfile-attribute et que l’expression ne correspond à rien, les attributs seront créés avec des chaînes vides comme valeur, à moins que le paramètre Path Not Found Behaviour ne soit réglé sur « ignoré », et l’adresse FlowFile sera toujours routée vers « avec 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é pour les expressions du chemin JSON. En sélectionnant « auto-détection », le type de retour sera json pour une destination de type « flowfile-content » et scalaire pour une destination de type 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 |