EvaluateXPath 2025.5.31.15¶

Pacote¶

org.apache.nifi | nifi-standard-nar

Descrição¶

Avalia um ou mais XPaths em relação ao conteúdo de um FlowFile. Os resultados desses XPaths são conferidos aos atributos do FlowFile ou são gravados no conteúdo do próprio FlowFile, dependendo da configuração do processador. XPaths 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 XPath válida. Se o XPath for avaliado como mais de um nó e o tipo de retorno for definido como “nodeset” (diretamente ou por meio de “auto-detect” com um destino de “flowfile-content”), o FlowFile não será modificado e será encaminhado para a falha. Se o XPath não for avaliado como um nó, 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 cadeias de caracteres vazias como valor, e o FlowFile será sempre roteado para “matched”

Tags¶

XML, XPath, 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 XPath 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 XPath poderá ser especificado e o nome da propriedade será ignorado.
Tipo de retorno	Indica o tipo de retorno desejado das expressões Xpath. A seleção de “detecção automática” definirá o tipo de retorno como “nodeset” para um destino de “flowfile-content” e “string” para um destino de “flowfile-attribute”.
Valide a DTD	Permita a declaração de tipo de documento incorporada no XML. Esse recurso deve ser desativado para evitar vulnerabilidades de expansão da entidade XML.

Relações¶

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

Grava atributos¶

Nome	Descrição
user-defined	Esse processador adiciona atributos definidos pelo usuário se a propriedade <Destination> estiver definida como “flowfile-attribute”.