EvaluateJsonPath 2025.5.31.15¶

Pacote¶

org.apache.nifi | nifi-standard-nar

Descrição¶

Avalia uma ou mais expressões do JsonPath em relação ao conteúdo de um FlowFile. Os resultados dessas expressões são atribuídos aos atributos do FlowFile ou são gravados no conteúdo do próprio FlowFile, dependendo da configuração do processador. JsonPaths são inseridos por meio da adição de propriedades definidas pelo usuário; o nome da propriedade mapeia para o nome de atributo no qual 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” for definido como “flowfile-attribute”, será usado um tipo de retorno “scalar”. Quando “Destination” for definido como “flowfile-content”, será usado um tipo de retorno “JSON“. Se o JsonPath for avaliado como uma matriz JSON ou um objeto JSON e o tipo de retorno for definido como “scalar”, o FlowFile não será modificado e será encaminhado para a falha. Um tipo de retorno de JSON pode retornar valores escalares se o JsonPath fornecido for avaliado como o valor especificado e for roteado como uma correspondência. Se Destination for “flowfile-content” e o JsonPath não for avaliado como um caminho definido, o FlowFile será roteado para “unmatched” sem ter seu conteúdo modificado. Se Destination for “flowfile-attribute” e a expressão não corresponder a nada, os atributos serão criados com cadeias de caracteres vazias como valor, a menos que “Path Not Found Behaviour” seja definido como “skip”, e o FlowFile será sempre roteado 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 das expressões de caminho JSON. A seleção de “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”