Definir Variável

Definir variável: Cria ou atualiza uma variável no fluxo. 

No Flowbuilder, o bloco "Definir Variável" permite que você crie ou atualize variáveis dentro do seu fluxo de automação. Isso é útil para armazenar informações temporárias, personalizar a interação com o usuário ou controlar o fluxo com base em dados dinâmicos. 


 


Como Funciona  

O que é:  

Definir Variável é uma ação que permite definir ou atualizar o valor de uma variável específica dentro do seu fluxo de trabalho.  

Quando Usar:  

Para armazenar respostas do usuário que serão usadas mais tarde no fluxo.  

Para personalizar mensagens ou ações com base em informações específicas.  

Para controlar o comportamento do fluxo com base em condições ou estados definidos por variáveis.  

Como Configurar:  

Localizar o Bloco:  

No Flowbuilder, procure pelo bloco chamado "Definir Variável" ou algo similar. Adicionar ao Fluxo: Arraste e solte o bloco "Definir Variável" no ponto do seu fluxo onde você deseja definir ou atualizar uma variável. Configurações do Bloco: 

  1. Título do Bloco: Dê um nome ao bloco para facilitar a identificação dentro do seu fluxo, como "Definir variável". 

  1. Variável à ser definida: Aqui você escolhe ou cria a variável que deseja definir. No exemplo, há uma interface de seleção onde você pode buscar ou selecionar a variável. 

  1. Valor definido: Insira o valor que você quer atribuir à variável. No exemplo, o valor é "Atendente", mas você pode deixar em branco se quiser manter o valor atual da variável. Há também uma lista de sugestões (datalist-variable-value) com opções como "Cliente" e "Atendente". 

  1. Ação na Variável? Esta opção permite escolher se você quer realizar alguma ação adicional sobre a variável, como concatenar, incrementar, etc. No exemplo, a opção está definida como "Nenhuma...", indicando que nenhuma ação adicional será realizada além da definição do valor. 

  • Substituir Valor

    • O que faz: Procura um trecho no valor atual da variável usando uma Expressão Regular (RegEx) e o substitui por um novo texto.

    • Campos Principais:

      • Expressão Regular: Informe o padrão de RegEx que identifica o texto a ser substituído.

      • Substituir por: Informe o novo texto que substituirá as ocorrências encontradas pela Expressão Regular. Para remover o texto encontrado, deixe este campo vazio.

    • Recursos Auxiliares :

      • Botões de atalho como "Remover espaços em branco", "Remover dígitos numéricos", "Deixar apenas dígitos numéricos", etc., podem estar disponíveis. Eles geralmente preenchem o campo Expressão Regular com padrões comuns e podem ajustar o campo Substituir por (ex: vazio para remoções).

    • Interface de Teste :

      • Valor para testes: Campo para inserir um texto de exemplo.

      • Resultado: Mostra como o texto ficaria após a aplicação da RegEx e da substituição.

    • Exemplo (Remover hífens de um código):

      • Variável: codigo_antigo (valor atual: "XYZ-123-ABC")

      • Expressão Regular: -

      • Substituir por: (campo deixado vazio)

      • Resultado: A variável codigo_antigo se tornará "XYZ123ABC".


  • Extrair Valor

    • O que faz: Permite retirar (extrair) uma porção específica do valor de uma variável usando uma Expressão Regular (RegEx). O valor extraído, que corresponde ao texto capturado por um grupo de captura na RegEx (geralmente o primeiro), substitui o valor original da variável ou é salvo nela.

    • Campo Principal:

      • Expressão Regular: Informe o padrão de RegEx que define qual parte do texto da variável deve ser extraída. Utilize parênteses () no padrão para criar o grupo de captura desejado.

    • Recursos Auxiliares:

      • Botões de atalho como "Extrair CPF", "Extrair CNPJ", "Extrair e-mail", "Extrair data", etc., podem estar disponíveis para preencher o campo Expressão Regular com padrões de captura comuns.

    • Interface de Teste:

      • Valor para testes: Campo para inserir um texto de exemplo.

      • Resultado: Mostra o valor que seria extraído com base na RegEx e no valor de teste.

    • Exemplo (Extrair o número de um CPF em uma frase):

      • Variável: dados_usuario (valor atual: "O CPF do cliente é 123.456.789-00 e ele mora em SP.")

      • Expressão Regular: (\d{3}\.\d{3}\.\d{3}-\d{2}) (O padrão de CPF está dentro de parênteses, formando um grupo de captura)

      • Resultado (na variável dados_usuario ou em uma nova): 123.456.789-00


  • Somar valor

    • O que faz: Adiciona um valor numérico ao valor atual da variável. A variável deve conter um número.

    • Campo Adicional:

      • Qual o valor para a operação: Informe o número que você deseja somar ao valor atual da variável.

    • Exemplo:

      • Variável: pontos_fidelidade (valor atual: 250)

      • Qual o valor para a operação: 50

      • Resultado: A variável pontos_fidelidade se tornará 300.

  • Subtrair valor

    • O que faz: Subtrai um valor numérico do valor atual da variável. A variável deve conter um número.

    • Campo Adicional:

      • Qual o valor para a operação: Informe o número que você deseja subtrair do valor atual da variável.

    • Exemplo:

      • Variável: quantidade_estoque (valor atual: 100)

      • Qual o valor para a operação: 10

      • Resultado: A variável quantidade_estoque se tornará 90.



Salvar: Após configurar, clique em Salvar para aplicar as mudanças. Se precisar cancelar, há um botão de Cancelar disponível. 



Teste de RegEx

Para garantir que a sua RegEx irá extrair o valor desejado corretamente, utilize a ferramenta de testes integrada.

Ao usar a ação "Substituir Valor” ou “Extrair Valor", clique no ícone indicado pela seta para abrir a janela de validação.



  1. Na tela "Extrair Valores", você pode:

    • Digitar sua própria expressão regular.

    • Usar atalhos para padrões comuns, como CPF, CNPJ, CEP e e-mail.

    • Inserir um texto no campo "Valor para testes".

    • Conferir o "Resultado" da extração imediatamente.


  2. Essa verificação permite ajustar e confirmar o comportamento da sua RegEx de forma rápida e precisa.