Utilizando Variáveis Locais e de Ambiente na IDR

Além das variáveis de sistema, você também pode criar novas variáveis para desenvolver sua IDR.

Para isto utilize a ação ‘Criar ou atualizar variável‘:

• Variáveis locais: Referem-se apenas ao contato que passou por este ponto do fluxo.
• Variáveis de ambiente: Serão aplicadas a todos os contatos do seu ambiente.

Selecionar o tipo de variável correto é imprescindível para o bom funcionamento. Quando lidamos com dados específicos de um contato (valor, proposta, produto, ordem de serviço) o correto é trabalhar com variáveis locais. Desta forma cada contato terá suas respectivas.

Ao passo que para atribuições mais genéricas, como variáveis que armazenem um telefone, link, e-mail, o ideal seria trabalhar com variáveis de ambiente, desta forma uma vez atualizada ela será compartilhada por todos os demais fluxos e contatos.

É também possível armazenar o retorno de uma chamada externa em uma variável utilizando a variável de sistema ‘{{lastapiresponse}}’. Assim como trabalhá-la utilizando jsonpath. Ex: ‘{{lastapiresponse@dados.valor}}’.

Por fim, uma vez criada, a variável pode ser manipulada com diferentes funções:

COUNT
Sintaxe: {{Variável/JsonPath.replace.count()}}

A função count retornaa quantidade de objetos contidos em um array de objetos.

REPLACE

Sintaxe: {{Variável/JsonPath.replace(“TermoPropriedade“, “TermoFinal“)}}

Exemplo de Json: {     “VendaID”:”125874″,     “qtd”:5,     “DataVenda”:”02 de Janeiro de 2023″,     “ValorTotal”:”R$137,44″,     “valorEntrada”:”R$28,93″,     “DataEntrada”:”03 de Janeiro de 2023″,     “CPFComprador”:”15.154.154/45″,     “percentualDesconto”:50 }

Com a função “Replace”, podemos alterar inteiramente ou parcialmente os valores dos objetos que um JSON contém.     O JSON ao lado contém o a propriedade “DataVenda”:”02 de Janeiro de 2023″; se desejar alterar este formato transformando-a em 04-01-21 poderá seguir o exemplo:   {{json@DataVenda.replace(“ de Janeiro de ”, “-01-”)}}       = 02-01-2023   Perceba que ao incluir uma parte do termo (incluindo os espaços) o sistema alterou o 1º termo para o 2º termo.   O Objeto “CPFComprador”:”15.154.154/45″; contém um CPF com uso de barra ao final.   {{json@CPFComprador.replace(“/”, “-”)}}   = 15.154.154-45   Quando desejar remover algo, poderá usar o “TermoFinal” vazio:   {{lastapiresponse@Objeto.Replace(“TermoObjeto”, “”)}}

FORMAT

Sintaxe: {{Variável/JsonPath.format(“OperadorFormat”)}}

Exemplo de Json: {     “Telefone”:”11912345678″,     “qtd”:5,     “DataVenda”:”02 de Janeiro de 2023″,     “ValorTotal”:”R$137,44″,     “valorEntrada”:”R$28,93″,     “DataHoraEntrada”:”2023-01-15T13:45:30.0000005″,     “CPFComprador”:”15.154.154/45″,     “PercentualDesconto”:0,500 }

Essa função formata o conteúdo de um objeto de um JSON.    O JSON ao lado possui a propriedade “Telefone”:”11912345678″; para formatar essa cadeia numérica no formato de telefone pode ser usado o comando a seguir:   Operador “#”   Substitui o símbolo “#” pelo dígito correspondente se um estiver presente; caso contrário, nenhum dígito aparece na sequência de resultados.   {{Json@Telefone.format(“(##) # ####-####”)}}   = (11) 9 1234-5678   Para a propriedade “percentualDesconto”:0,500; pode ser alterada a casa decimal de algumas formas:   Operador “%”   Multiplica um número por 100 e insere um símbolo de porcentagem localizada na sequência de resultados.   {{Json@PercentualDesconto.format(“%#,##”)}}   = %50 (revisão)   Para a propriedade “DataHoraEntrada”:”2023-01-15T13:45:30.0000005″; pode-se ajustar o formato manipulando cada tipo de Data, Ano, Mês, Hora, Minutos, Segundos e Milissegundos.   Operador de Datas   {{Json@DataHoraEntrada.format(“dd/MM/yyyy HH:mm:ss:ff”)}}   = 15-01-2023 13:45:30:00

SUBSTRING

Sintaxe: {{Variável/JsonPath.substring(NúmeroPosiçãoInicial, NúmeroCaracteresAFrente)}}

Essa função possibilita retirar um intervalo de caracteres de um conteúdo da variável.

Considere que uma variável de nome {{Data}} contenha: 04/05/2023

• Utilizando Substring(int,int) podemos desmembrar em novas variáveis dia, mês e ano.

• {{Data.substring(0,2)}}
  • Retorno: “04”

• {{Data.substring(3,2)}}
  • Retorno: “05”

• {{Data.substring(6,4)}}
  • Retorno: “2023”

Partindo para outro exemplo, vamos supor que uma API retornou o valor do pedido como 226665. Neste caso, desejamos obter o resultado “R$2.266,65“.

Utilizando ‘Format’, chegaremos apenas a este resultado: R$ 226.665,00″, pois essa estrutura entende que foi enviado um número inteiro.

Então, como podemos transformar 226665 em  “R$2.266,65” utilizando substrings?

Seguiremos o seguinte passo a passo, criando as seguintes variáveis:

Agora criamos uma nova variável chamada “valorFormatado“:

valorFormatado = R$ {{parte1}}.{{parte2}},{{parte3}}

Resultado final: R$ 2.266,65