EvaluateJsonPath 2025.10.2.19¶

Pacote¶

org.apache.nifi | nifi-standard-nar

Descrição¶

Avalia uma ou mais expressões JsonPath em relação ao conteúdo de um FlowFile. Os resultados dessas expressões são atribuídos a atributos do FlowFile ou gravados no conteúdo do próprio FlowFile, dependendo da configuração do processador. As JsonPaths são inseridas adicionando propriedades definidas pelo usuário. O nome da propriedade é mapeado para o Nome do atributo em que o resultado será colocado (se o destino for “flowfile-attribute”, caso contrário o nome da propriedade será ignorado). O valor da propriedade deve ser uma expressão JsonPath válida. Um tipo de retorno “auto-detect” fará uma determinação com base no destino configurado. Quando “Destination” é definido como “flowfile-attribute”, um tipo de retorno “scalar” será usado. Quando “Destination” é definido como “flowfile-content”, um tipo de retorno “JSON” será usado. Se o JsonPath for avaliado como uma matriz JSON ou objeto JSON e o tipo de retorno for definido como “scalar” , o FlowFile ficará inalterado e será direcionado para a falha. Um tipo de retorno JSON pode retornar valores escalares se o JsonPath fornecido for avaliado como o valor especificado e será encaminhado como uma correspondência. Se o destino for “flowfile-content” e o JsonPath não for avaliado como um caminho definido, o FlowFile será encaminhado para “unmatched” sem ter seu conteúdo modificado. Se o destino for “flowfile-attribute” e a expressão não corresponder a nada, os atributos serão criados com strings vazias como valor, a menos que “Comportamento se o caminho não for encontrado” esteja definido como “skip”, e o FlowFile será sempre encaminhado para “matched”.

Tags¶

JSON, JsonPath, avaliar

Requisito de entrada¶

REQUIRED

Oferece suporte a propriedades dinâmicas confidenciais¶

falso

Propriedades¶

Propriedade	Descrição
Destination	Indica se os resultados da avaliação de JsonPath são gravados no conteúdo do FlowFile ou em um atributo do FlowFile; se estiver usando atributo, você deve especificar a propriedade de nome de atributo. Se definido como flowfile-content, somente um JsonPath poderá ser especificado e o nome da propriedade será ignorado.
Comprimento máximo da cadeia de caracteres	O comprimento máximo permitido de um valor de cadeia de caracteres ao analisar o documento JSON
Representação de valor nulo	Indica a representação desejada de expressões de caminho JSON que resultam em um valor nulo.
Comportamento de caminho não encontrado	Indica como lidar com expressões de caminho JSON ausentes quando o destino é definido como “flowfile-attribute”. A seleção de “warn” gerará um aviso quando uma expressão de caminho JSON não for encontrada. A seleção de “skip” omitirá os atributos de quaisquer expressões de caminho JSON não correspondentes.
Tipo de retorno	Indica o tipo de retorno desejado de expressões de caminho JSON. Selecionar “auto-detect” definirá o tipo de retorno como “json” para um destino de “flowfile-content” e “scalar” para um destino de “flowfile-attribute”.

Relações¶

Nome	Descrição
failure	FlowFiles são encaminhados para essa relação quando o JsonPath não pode ser avaliado em relação ao conteúdo do FlowFile; por exemplo, se o FlowFile não for JSON válido
matched	FlowFiles são encaminhados para essa relação quando o JsonPath é avaliado com sucesso e o FlowFile é modificado como resultado
unmatched	FlowFiles são encaminhados para essa relação quando o JsonPath não corresponde ao conteúdo do FlowFile e o destino é definido como “flowfile-content”