ReplaceText 2025.5.31.15

Pacote

org.apache.nifi | nifi-standard-nar

Descrição

Atualiza o conteúdo de um FlowFile pesquisando algum valor textual no conteúdo do FlowFile (por meio de expressão regular/regex ou valor literal) e substituindo a seção do conteúdo correspondente por algum valor alternativo. Ele também pode ser usado para acrescentar ou prefixar texto ao conteúdo de um FlowFile.

Tags

Alterar, Modificar, Regex, Expressão regular, Substituir, Texto, Atualizar

Requisito de entrada

REQUIRED

Oferece suporte a propriedades dinâmicas confidenciais

falso

Propriedades

Propriedade

Descrição

Conjunto de caracteres

O conjunto de caracteres no qual o arquivo está codificado

Modo de avaliação

Execute a “Estratégia de substituição” em cada linha separadamente (linha por linha) ou armazene o arquivo inteiro na memória (Texto inteiro) e execute-o.

Modo de avaliação linha por linha

Execute a “Estratégia de substituição” em cada linha separadamente (linha por linha) para todas as linhas no FlowFile, somente a primeira linha (cabeçalho), somente a última linha (rodapé), exceto a primeira linha (cabeçalho) ou exceto a última linha (rodapé).

Tamanho máximo do buffer

Especifica a quantidade máxima de dados a serem armazenados em buffer (por arquivo ou por linha, dependendo do modo de avaliação) para aplicar a substituição. Se “Texto inteiro” (no Modo de avaliação) for selecionado e o FlowFile for maior que esse valor, o FlowFile será encaminhado para “failure”. No modo “Linha por linha”, se uma única linha for maior que esse valor, o FlowFile será roteado para “failure”. Um valor padrão de 1 MB é fornecido, principalmente para o modo “Texto inteiro”. No modo “Linha por linha”, sugere-se um valor como 8 KB ou 16 KB. Esse valor será ignorado se a propriedade <Replacement Strategy> estiver definida como uma das seguintes opções: Append, Prepend, Always Replace

Expressão regular

O valor de pesquisa a ser buscado no conteúdo do FlowFile. Usado apenas para as estratégias de correspondência “Substituição literal” e “Substituição por expressão regular”

Estratégia de substituição

A estratégia de como e o que substituir no conteúdo de texto do FlowFile.

Valor de substituição

O valor a ser inserido usando a “Estratégia de substituição”. O uso de referências anteriores “Substituição por expressão regular” para grupos de captura de expressões regulares é compatível, mas as referências anteriores que fazem referência a grupos de captura que não existem na expressão regular serão tratadas como valor literal. As referências anteriores também podem ser referenciadas usando a linguagem de expressão, como “$1”, “$2” etc. As aspas simples devem ser incluídas, pois essas variáveis não são nomes de atributos “padrão” (os nomes de atributos devem ser colocados entre aspas, a menos que contenham apenas números, letras e _).

Texto a ser anexado no fim

O texto a ser anexado ao fim do FlowFile, ou a cada linha, dependendo do valor configurado da propriedade Modo de avaliação

Texto a ser anexado no início

O texto a ser anexado ao início do FlowFile, ou a cada linha, dependendo do valor configurado da propriedade Modo de avaliação

Relações

Nome

Descrição

failure

FlowFiles que não puderam ser atualizados são encaminhados para essa relação

success

FlowFiles que foram processadas com sucesso são encaminhados para essa relação. Isso inclui tanto os FlowFiles que tiveram o texto substituído quanto os que não tiveram.

Casos de uso

Anexar texto ao fim de cada linha em um FlowFile

Anexar texto ao início de cada linha em um FlowFile

Substitua cada ocorrência de uma cadeia de caracteres literal no FlowFile por um valor diferente

Transforme cada ocorrência de uma cadeia de caracteres literal em um FlowFile

Substitua completamente o conteúdo de um FlowFile por um texto específico