Funções

• A função Aggregate permite consolidar dois ou mais objetos de entrada em um único objeto de saída, criando um array.

• A função DateTime Add permite adicionar um intervalo de tempo específico a uma data e hora, facilitando a manipulação e cálculos temporais.

• Abaixo segue uma breve explicação sobre os campos
  • Nome da função: Identificador do nome da função.
  • Date: Esse campo representa a data base à qual você deseja adicionar ou subtrair um intervalo de tempo. O preenchimento desse campo, pode ser uma data fixa, variável ou um dado de entrada que contenha uma data.
  • Format:  O campo "Formato" refere-se à maneira como a data é representada. Ele indica como a data deve ser interpretada no campo "Date". Por exemplo, o formato pode ser "dd/MM/yyyy HH:mm:ss". Para saber mais, clique aqui. 
  • Unit: Este campo indica a unidade de tempo que você deseja adicionar ou remover à data. Pode incluir opções como anos, meses, dias, horas, minutos, segundos, e milissegundos. Você especifica a unidade de tempo que será adicionada ou removida à data.
  • Amount: O campo "Quantidade" representa o valor numérico que será adicionado à data base. Por exemplo, se a unidade for "dias" e a quantidade for "5", a data resultante será a data base mais 5 dias.
• Exemplo: Suponhamos que você queira adicionar 3 meses à data "2023-01-01 12:00:00". Você preencheria os campos da seguinte forma:
  
  Nome da Função: Adiciona 3 meses na data
  Date: 2023/01/01 12:00:00
  Format: yyyy/MM/dd HH:mm:ss
  Unit: Meses
  Amount: 3
  
  
  
  Resultado: O resultado seria a nova data após adicionar 3 meses à data base fornecida.
  
  
  
  

• A função DateTime Diff calcula a diferença entre duas datas e horas, fornecendo o resultado em termos de intervalo de tempo, como dias, horas, minutos, etc.

• Abaixo segue uma breve explicação sobre os campos
  • Nome da função: Identificador do nome da função.
  • Date 1: Este campo refere-se à primeira data que você deseja comparar. Pode ser uma data fixa ou uma variável que contenha uma data.
  • Format date 1: Indica o formato como a data no campo "Date 1" está representada. Especifica como a data deve ser interpretada para garantir uma comparação precisa. Para saber mais, clique aqui. 

  • Date 2: Este campo representa a segunda data para a comparação. Pode ser uma data fixa ou uma variável que contenha uma data.

  • Format date 2: Indica o formato como a data no campo "Date 2" está representada. Da mesma forma que o campo "Format Date 1", este campo garante que ambas as datas sejam interpretadas corretamente durante a comparação. Para saber mais, clique aqui. 

• Exemplo: Suponhamos que você queira calcular a diferença em dias entre duas datas: "01-01-2023 12:00:00" e "01-03-2023 15:30:00". Você preencheria os campos da seguinte forma:
  
  Nome da Função: Diferença entre datas
  Date 1: 2023-01-01 12:00:00
  Format Date 1: dd-MM-yyyy HH:mm:ss
  Date 2: 2023-03-01 15:30:00
  Format Date 2: dd-MM-yyyy HH:mm:ss
  
  
  
  Resultado: O resultado seria a diferença em dias entre as duas datas e horas fornecidas.
  
  

• A função Division permite dividir os valores informados nos campos Fator. Neste exemplo temos a subtração do Fator 100 pelo Fator 2, ou seja, 100/2 e o resultado deste exemplo é 50. 
• É possível adicionar quantos Fatores desejar através do campo Adicionar.
• O resultado do fator anterior sempre será dividido pelo valor do próximo fator. Por exemplo: primeiro Fator 100, segundo Fator 2 e terceiro Fator 2 onde o resultado da divisão entre o primeiro e segundo fator será 50 e este resultado será dividido pelo o terceiro fator, dando o resultado de 25. 

• A função Format DateTime permite formatar uma data e hora de acordo com um padrão específico, transformando a representação padrão em um formato personalizado.

• Abaixo segue uma breve explicação sobre os campos
  • Nome da função: Identificador do nome da função.
  • Date: Este campo representa a data e hora que você deseja formatar. Pode ser uma data fixa ou uma variável que contenha uma data.
  • Input Format: Indica o formato como a data no campo "Date" está representada inicialmente. Especifica como a data deve ser interpretada para garantir que seja formatada corretamente. Para saber mais, clique aqui. 
  • Output Format: Este campo define o formato desejado para a representação final da data. Você especifica como deseja que a data seja exibida após a formatação. Para saber mais, clique aqui.
• Exemplo: Suponhamos que você tenha a data "2023-01-15 18:45:30" e deseje formatá-la para o formato "15 de Jan de 2023, 18:45". Você preencheria os campos da seguinte forma:
  
  Nome da Função: Formata data e hora
  Date: 2023-01-15 18:45:30
  Input Format: yyyy-MM-dd HH:mm:ss
  Output Format: dd 'de' MMM 'de' yyyy, HH:mm
  
  
  
  Resultado: O resultado seria a data formatada conforme o formato desejado: "15 de Jan de 2023, 18:45".
  
  
  
  

• A função Get DateTime obtém a data e hora atuais baseado na localidade escolhida.

• Abaixo segue uma breve explicação sobre os campos
  • Nome da função: Identificador do nome da função.

  • Format: O campo "Formato" representa o formato desejado para a representação da data e hora obtidas pela função. Você especifica como deseja que a data e hora atuais sejam formatadas. Para saber mais, clique aqui.

  • Timezone: Este campo indica o fuso horário desejado para ajustar a data e hora obtidas. Pode ser especificado usando a nomenclatura do fuso horário, como "America/Sao_Paulo"

• Exemplo: Suponhamos que você queira obter a data e hora atuais formatadas como "dd/MM/yyyy HH:mm:ss" no fuso horário "America/Sao_Paulo". Os campos seriam preenchidos da seguinte forma:
  
  Nome da Função: Data e hora atual
  Format: dd/MM/yyyy HH:mm:ss
  Timezone: America/Sao_Paulo
  
  
  
  Resultado: O resultado seria a data e hora atuais formatadas conforme especificado, ajustadas para o fuso horário desejado.
  
  
  
  

• A função IsDateTime verifica se um determinado valor é do tipo DateTime baseado em um formato de datetime.

• Abaixo segue uma breve explicação sobre os campos
  • Nome da função: Identificador do nome da função.

  • Date: O campo "Data" refere-se à variável ou valor que você deseja verificar se é do tipo DateTime. Este campo contém o valor que será avaliado pela função. O preenchimento desse campo pode ser uma data fixa, variável ou um dado de entrada que contenha uma data.

  • Format: O campo "Formato" indica o formato esperado da data para realizar a verificação. Isso é útil quando você precisa garantir que o valor seja interpretado corretamente como uma data e hora específicas. Para saber mais, clique aqui.

• Exemplo: Suponhamos que você queira verificar se o retorno da função "Get date time" é do tipo DateTime e está no formato "dd/MM/yyyy HH:mm:ss". Os campos seriam preenchidos da seguinte forma:
  
  

  Nome da Função: Valida get date time
  Date: {{{function.id3.date}}}
  Format: dd/MM/yyyy HH:mm:ss

  
  
  
  Resultado: A função retornará verdadeiro se "Get date time" for uma data válida no formato especificado; caso contrário, retornará falso.
  
  

• A função Jolt permite aplicar várias transformações de dados através da Especificação determinando qual função será executada em qual atributo.  Na imagem abaixo estamos utilizando um exemplo que irá transformar o objeto de entrada (spreadsheet_id) em caracteres maiúsculos.

• Existem alguns recursos no campo Especificação do jolt para facilitar seu uso, como Copiar o comando passado através do ícone , Formatar JSON através do ícone , Abrir arquivo através do ícone e Tela cheia através do ícone

• A função Length permite retornar a quantidade de caracteres da string informada no campo Texto. Neste exemplo estamos utilizando uma variável com o valor "TOTVS iPaaS" que contém 11 caracteres pois o espaço também é contado como um caractere.

Configuração da variável:

Configuração da função:

Configuração do componente Generator para exibir o texto e a quantidade de caracteres no monitor:

Resultado no monitor:

• A função Lower case permite transformar strings, ou seja, palavras que estão com um ou mais caracteres em maiúsculo serão alterados para minúsculo.

• A função Multiplication permite que os valores informados nos campos Fator sejam multiplicados. Neste exemplo temos a multiplicação do fator 35 pelo fator 3, ou seja, 35x3 e o resultado deste exemplo é 105. 
• É possível adicionar quantos Fatores desejar através do campo Adicionar.
• O resultado do fator anterior sempre será multiplicado pelo valor do próximo fator. Por exemplo: primeiro Fator 5, segundo Fator 3 e terceiro Fator 2 onde o resultado da multiplicação entre o primeiro e segundo fator será 15 e este resultado será multiplicado pelo terceiro fator, dando o resultado de 30.  

• A função Replace permite substituir o valor informado no campo Valor a ser substituído pelo valor informado no campo Valor substituto. No nosso exemplo utilizamos Joinville Santa Catarina onde Santa Catarina irá ser substituído pelo valor SC retornando o resultado final como Joinville SC.

• A função Size permite que você consulte quantos registros uma listagem possui. Neste exemplo estamos utilizando uma listagem que contém 50 registros.

• A função Substring permite cortar parte da string informada no campo Texto, ou seja, permite utilizar partes da string informada. Neste exemplo estamos utilizando a string "Joinville Santa Catarina" onde queremos usar somente o "Santa Catarina".

• A função Subtraction permite subtrair os valores informados nos campos Fator. Neste exemplo temos a subtração do Fator 80 pelo Fator 30, ou seja, 80-30 e o resultado deste exemplo é 50. 
• É possível adicionar quantos Fatores desejar através do campo Adicionar.
• O resultado do fator anterior sempre será subtraído pelo valor do próximo fator. Por exemplo: primeiro Fator 50, segundo Fator 5 e terceiro Fator 20 onde o resultado da subtração entre o primeiro e segundo fator será 45 e este resultado será subtraído pelo o terceiro fator, dando o resultado de 25. 

• A função Sum permite somar os valores informados nos campos Fator. Neste exemplo temos a soma do Fator 25 pelo Fator 30, ou seja, 25+30 e o resultado deste exemplo é 55. 
• É possível adicionar quantos Fatores desejar através do campo Adicionar.
• O resultado do fator anterior sempre será somado pelo valor do próximo fator. Por exemplo: primeiro Fator 15, segundo Fator 4 e terceiro Fator 20 onde o resultado da soma entre o primeiro e segundo fator será 19 e este resultado será somado com o terceiro fator, dando o resultado de 39.

• A função Upper case permite transformar strings, ou seja, palavras que estão com um ou mais caracteres em minúsculo serão alterados para maiúsculo.

• A função base64 é dividida em duas funções distintas no builder:

• • Base64 Encoder: Transforma um texto em sua versão base64.
  • Base64 Decoder: Transforma uma base64 em sua versão textual que geralmente estará em utf-8.