Função que formata o texto substituindo os valores entre chaves ({ }) pelos termos desejados.

Figura 1 - Bloco Suprir Texto

Compatibilidade

• Bloco cliente: cronapi.text.formatTextWithReplacement()

Retorno

Retorna uma string com o texto alterado conforme os termos especificados nos parâmetros.

Características do bloco

O bloco Suprir Texto é configurado originalmente com dois parâmetros: Texto e Termo. No entanto, é possível adicionar mais parâmetros "Termo" conforme necessário. Para isso, clique no ícone de configuração do bloco e arraste para a função quantos blocos "item" forem necessários para gerar os parâmetros adicionais.

Figura 2 - Adicionando mais parâmetros "Termo"

Parâmetros

Texto

Este parâmetro recebe o texto que será modificado, com os pontos de substituição indicados entre chaves e em ordem numérica.

• Posição: 1
• Inglês: Text
  
• Tipo: Numérico, Data e Tempo / Number, Date and Time

• Exemplo: "{0} comprou {1} carro no dia {2}."

Termo

Termos utilizados para substituir os valores que estão entre chaves no primeiro parâmetro. Serão contados de cima para baixo em ordem numérica.

• Posição: 2 ou mais
• Inglês: Term
  
• Tipo: Objeto / Object

• Exemplo: "Ana", "1", "29/10/2024"

Exemplo

Na função abaixo, o bloco Suprir Texto altera os valores entre chaves ({ }) contidos no parâmetro "Texto" com base nos "Termos" informados nos demais parâmetros. O resultado de execução será impresso no console do navegador.

Figura 3 - Exemplo de uso do bloco Suprir Texto

A imagem a seguir apresenta o resultado de execução da função da Figura 3 no console do navegador.

Figura 3.1 - Resultado de execução da função da Figura 3