EvaluateXQuery 2025.10.2.19¶

Pacote¶

org.apache.nifi | nifi-standard-nar

Descrição¶

Evaluates one or more XQueries against the content of a FlowFile. The results of those XQueries are assigned to FlowFile Attributes or are written to the content of the FlowFile itself, depending on configuration of the Processor. XQueries are entered by adding user-defined properties; the name of the property maps to the Attribute Name into which the result will be placed (if the Destination is “flowfile-attribute”; otherwise, the property name is ignored). The value of the property must be a valid XQuery. If the XQuery returns more than one result, new attributes or FlowFiles (for Destinations of “flowfile-attribute” or “flowfile-content” respectively) will be created for each result (attributes will have a “.n” one-up number appended to the specified attribute name). If any provided XQuery returns a result, the FlowFile(s) will be routed to “matched”. If no provided XQuery returns a result, the FlowFile will be routed to “unmatched”. If the Destination is “flowfile-attribute” and the XQueries matche nothing, no attributes will be applied to the FlowFile.

Tags¶

XML, XPath, XQuery, avaliar

Requisito de entrada¶

REQUIRED

Oferece suporte a propriedades dinâmicas confidenciais¶

falso

Propriedades¶

Propriedade	Descrição
Destination	Indicates whether the results of the XQuery evaluation are written to the FlowFile content or a FlowFile attribute. If set to <flowfile-content>, only one XQuery may be specified and the property name is ignored. If set to <flowfile-attribute> and the XQuery returns more than one result, multiple attributes will be added to theFlowFile, each named with a “.n” one-up number appended to the specified attribute name
Saída: recuo	Especifica se o processador pode acrescentar espaços em branco adicionais ao gerar uma árvore de resultados.
Saída: método	Identifica o método geral que deve ser usado para a saída de uma árvore de resultados.
Saída: omitir a declaração XML	Especifica se o processador deve emitir uma declaração XML ao transformar uma árvore de resultados.
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 XQuery não pode ser avaliado em relação ao conteúdo do FlowFile.
matched	FlowFiles são encaminhados para essa relação quando o XQuery é avaliado com sucesso e o FlowFile é modificado como resultado
unmatched	FlowFiles são encaminhados para essa relação quando o XQuery 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”.