Manipulação de texto e expressões regulares
strings.concatenateJunta múltiplas strings
Junta vários textos (ou uma lista) num só, com um separador opcional entre eles.
Exemplo: Junte {rua}, {numero} e {cidade} com ", " em {endereco}.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Textos * | Lista | ||
| Separador | Texto | Use \n para quebra de linha | |
| Salvar resultado na variável * | Variável de saída | text |
Resultado: guardado na variável text (Texto).
strings.splitDivide string por delimitador
Divide um texto em partes pelo separador e guarda a lista, removendo espaços de cada parte. Com o separador vazio, divide nos espaços.
Exemplo: Divida "SP;RJ;MG" por ; em {estados} e percorra com Para Cada.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Texto * | Texto | ||
| Separador (vazio = espaços) | Texto | , | Use \n para linhas e \t para tabulação |
| Remover espaços de cada parte | Sim/Não | Sim | |
| Remover partes vazias | Sim/Não | Não | |
| Salvar resultado na variável * | Variável de saída | parts |
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Máximo de divisões (0 = todas) | Número | 0 |
Resultado: guardado na variável parts (Lista).
strings.replaceSubstitui ocorrências
Troca todas as ocorrências de um texto por outro, com a opção de ignorar maiúsculas e minúsculas.
Exemplo: Troque "." por "" em {cnpj} para tirar a pontuação.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Texto * | Texto | ||
| Procurar * | Texto | ||
| Substituir por | Texto | ||
| Ignorar maiúsculas/minúsculas | Sim/Não | Não | |
| Salvar resultado na variável * | Variável de saída | text |
Resultado: guardado na variável text (Texto).
strings.regex_matchEncontra padrões com regex
Procura um padrão (expressão regular) no texto e devolve todas as ocorrências, só a primeira ou apenas se existe (verdadeiro/falso). Use grupos () para pegar só parte do padrão.
Exemplo: Encontre a primeira ocorrência de \d{2}/\d{2}/\d{4} em {texto_email} para achar a data de vencimento.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Texto * | Texto | ||
| Expressão regular * | Texto | Ex.: \d{3}\.\d{3}\.\d{3}-\d{2} | |
| Retornar | Opção | Todas as ocorrências (lista) | Opções: Todas as ocorrências (lista), Primeira ocorrência, Só verificar (verdadeiro/falso) |
| Ignorar maiúsculas/minúsculas | Sim/Não | Não | |
| Salvar resultado na variável * | Variável de saída | matches |
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Grupo a retornar (0 = tudo) | Número | 0 | |
| ^ e $ valem para cada linha | Sim/Não | Não |
Resultado: guardado na variável matches (Qualquer).
strings.regex_replaceSubstitui com regex
Substitui trechos que casam com uma expressão regular, podendo reaproveitar grupos (\1, \2) no novo texto.
Exemplo: Troque [^0-9] por "" em {telefone} para manter só os dígitos.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Texto * | Texto | ||
| Expressão regular * | Texto | ||
| Substituir por (\1 = grupo 1) | Texto | ||
| Ignorar maiúsculas/minúsculas | Sim/Não | Não | |
| Salvar resultado na variável * | Variável de saída | text |
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Máximo de substituições (0 = todas) | Número | 0 | |
| ^ e $ valem para cada linha | Sim/Não | Não |
Resultado: guardado na variável text (Texto).
strings.trimRemove espaços início/fim
Remove espaços e quebras de linha do início e/ou fim do texto (ou outros caracteres), e pode reduzir espaços repetidos no meio.
Exemplo: Remova os espaços de {codigo_lido} antes de comparar com a planilha.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Texto * | Texto | ||
| Remover de | Opção | Início e fim | Opções: Início e fim, Só do início, Só do fim |
| Também reduzir espaços repetidos no meio | Sim/Não | Não | |
| Salvar resultado na variável * | Variável de saída | text |
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Caracteres a remover (vazio = espaços e quebras de linha) | Texto |
Resultado: guardado na variável text (Texto).
strings.change_caseConverte caixa
Converte para maiúsculas, minúsculas, iniciais maiúsculas ou só a primeira letra, e pode remover acentos.
Exemplo: Converta {nome_cliente} para maiúsculas sem acentos para o sistema legado.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Texto * | Texto | ||
| Converter para | Opção | MAIÚSCULAS | Opções: MAIÚSCULAS, minúsculas, Primeira De Cada Palavra, Primeira letra da frase |
| Remover acentos (ação → acao) | Sim/Não | Não | |
| Salvar resultado na variável * | Variável de saída | text |
Resultado: guardado na variável text (Texto).
strings.format_stringTemplate com variáveis {var}
Monta um texto a partir de um modelo com {variavel}, formatando números no padrão brasileiro (1.234,56) ou americano.
Exemplo: Monte "Pedido {numero} - total R$ {total}" com números pt-BR para o e-mail.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Modelo * | Código | Formato do Python: {nome}, {total:,.2f} (2 casas), {data:%d/%m/%Y}, {linha.campo}Ex.: Pedido {pedido}: R$ {total:,.2f} em {data:%d/%m/%Y} | |
| Números | Opção | Brasileiro (1.234,56) | Opções: Brasileiro (1.234,56), Americano (1,234.56) |
| Salvar resultado na variável * | Variável de saída | text |
Resultado: guardado na variável text (Texto).
strings.containsVerifica se string contém texto
Verifica se o texto contém, começa com, termina com ou é igual a outro, e guarda verdadeiro ou falso para usar num Se.
Exemplo: Verifique se o assunto {item.subject} contém "boleto", ignorando maiúsculas.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Texto * | Texto | ||
| Procurar * | Texto | ||
| Verificar se o texto | Opção | Contém | Opções: Contém, Começa com, Termina com, É igual a |
| Ignorar maiúsculas/minúsculas | Sim/Não | Sim | |
| Salvar resultado na variável * | Variável de saída | found |
Resultado: guardado na variável found (Booleano).
strings.substringExtrai parte da string
Extrai um pedaço do texto: entre dois textos, depois ou antes de um texto de referência, ou por posição e quantidade.
Exemplo: Extraia o que está entre "Protocolo: " e "\n" em {mensagem} para obter o protocolo.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Texto * | Texto | ||
| Extrair | Opção | Entre dois textos | Opções: Entre dois textos, Depois de um texto, Antes de um texto, Por posição |
| Texto inicial | Texto | Só quando «Extrair» = «Entre dois textos» | |
| Texto final | Texto | Só quando «Extrair» = «Entre dois textos» | |
| Texto de referência | Texto | Só quando «Extrair» = «Depois de um texto» ou «Antes de um texto» | |
| Posição inicial (a primeira é 0) | Número | 0 | Só quando «Extrair» = «Por posição» |
| Quantidade (vazio = até o fim) | Número | Só quando «Extrair» = «Por posição» | |
| Salvar resultado na variável * | Variável de saída | text |
Resultado: guardado na variável text (Texto).
strings.lengthRetorna tamanho da string
Guarda o tamanho de um texto (número de caracteres) ou de uma lista (número de itens).
Exemplo: Se o tamanho de {cpf} não for 11, registre o cadastro como inválido.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Texto ou lista * | Texto | ||
| Salvar resultado na variável * | Variável de saída | length |
Resultado: guardado na variável length (Número).
strings.parse_numberConverte string para int/float
Converte um texto em número, entendendo o formato brasileiro (1.234,56), americano ou detectando sozinho. Pode devolver vazio em vez de falhar quando não for número.
Exemplo: Converta "R$ 1.234,56" lido da tela em {valor} (1234.56) no formato pt-BR.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Texto * | Texto | Ex.: R$ 1.234,56 | |
| Formato do número | Opção | Automático | Automático: com vírgula e ponto, o último é o decimal; um ponto sozinho é decimal (1.234 = 1,234). Use Brasileiro para milharOpções: Automático, Brasileiro (1.234,56), Americano (1,234.56) |
| Resultado | Opção | Inteiro quando possível | Opções: Inteiro quando possível, Inteiro (arredonda), Decimal |
| Salvar resultado na variável * | Variável de saída | number |
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Falhar se não for número (senão devolve vazio) | Sim/Não | Sim |
Resultado: guardado na variável number (Número).