Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Atualmente as funções disponíveis no TOTVS iPaaS são:

  • Aggregate
  • Size
  • Lowercase
  • Uppercase
  • Jolt
  • Multiplication
  • Sum
  • Subtraction
  • Substring
  • Divsion
  • Length
  • Base64 Decoder
  • Base64 Encoder
  • Date time add
  • Date time diff
  • Division
  • Format date time
  • Get date time
  • Is date time
  • Jolt
  • Length
  • Lowercase
  • Multiplication
  • Replace
  • Size
  • Substring
  • Subtraction
  • Sum
  • UppercaseReplace


Utilizando as funções

...

Cada função representa uma operação que deve ser usada conforme a necessidade que o componente possua. Abaixo vamos detalhar e exemplificar cada uma delas para que facilite o entendimento.


Aggregate

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

Size

Date time add

Essa função permite

que seja retornado a quantidade de registros que um array tem, ou seja, de uma listagem retorna a quantidade de registros que a mesma possui informando o valor numérico dos registros.

Lowercase

Essa função transforma os dados informados para que todos os caracteres fiquem em minúsculo.

adicionar um intervalo de tempo específico a uma data e hora, facilitando a manipulação e cálculos temporais

Date time diff

Essa função permite calcula a diferença entre duas datas e horas, fornecendo o resultado em termos de intervalo de tempo, como dias, horas, minutos, etc

Division

Essa função irá dividir o valor do fator 1 pelo valor do fator 2. Caso tenha mais de dois fatores, o resultado da divisão anterior será dividido pelo próximo fator. 

Format date time

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

Get date time

Essa função obtém a data e hora atuais baseado na localidade escolhida.

Is date time

Essa função verifica se um determinado valor é do tipo DateTime

Uppercase

Essa função transforma os dados informados para que todos os caracteres fiquem em maiúsculo.

Jolt

Essa função é usada para transformar dados de entrada de acordo com o que o outro sistema espera receber. É possível passar comandos específicos para essa transformação através da tela de comando apresentada. 

Length

Essa função retorna quantos caracteres possui a string informada.

Lowercase

Essa função transforma os dados informados para que todos os caracteres fiquem em minúsculo.

Multiplication

Essa função irá multiplicar o valor do fator 1 pelo valor do fator 2. Caso tenha mais de dois fatores, o resultado da multiplicação anterior será multiplicado pelo próximo fator.

Sum

Essa função irá somar o valor do fator 1 pelo valor do fator 2. Caso tenha mais de dois fatores, o resultado da soma anterior será acrescentado ao próximo fator

Replace

Informa um texto, define o valor a ser substituído pelo novo valor informado no campo valor substituto.

Size

Essa função permite que seja retornado a quantidade de registros que um array tem, ou seja, de uma listagem retorna a quantidade de registros que a mesma possui informando o valor numérico dos registros.

Substring

Permite cortar parte de uma string informada no campo Texto, ou seja, permite utilizar partes da string informada.

Subtraction

Essa função irá subtrair o valor do fator 1 pelo valor do fator 2. Caso tenha mais de dois fatores, o resultado da subtração anterior será subtraído pelo próximo fator. 
Division

Sum

Essa função
irá dividir
irá somar o valor do fator 1 pelo valor do fator 2. Caso tenha mais de dois fatores, o resultado da
divisão
soma anterior será
dividido pelo
acrescentado ao próximo fator.
 
Length

Uppercase

Essa função
retorna quantos caracteres possui a string informada.

Replace

Informa um texto, define o valor a ser substituído pelo novo valor informado no campo valor substituto.

Substring

Permite cortar parte de uma string informada no campo Texto, ou seja, permite utilizar partes da string informada.

transforma os dados informados para que todos os caracteres fiquem em maiúsculo.

Exemplos de uso das funções

...

Deck of Cards
idsample
Card
id1
labelAggregate
  • A função Aggregate permite consolidar dois ou mais objetos de entrada em um único objeto de saída, criando um array.

Card
id24
labelSizeDateTimeAdd
  • A função

    Size permite que você consulte quantos registros uma listagem possui. Neste exemplo estamos utilizando uma listagem que contém 50 registros.

Image Removed

Card
id3
labelLower case
  • 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.

Image Removed

Card
id4
labelUpper case
  • 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.

Image Removed

  • 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 representar 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"
    • 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 remover à 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

    Image Added

    Resultado:
    O resultado seria a nova data após adicionar 3 meses à data base fornecida.

    Image Added



Card
id5
labelDateTimeDiff
  • Date time diff


Card
id6
labelDivision
Dica

No caso das funções matemáticas sempre que utilizarmos números que não são inteiros, ou seja, que possuem virgula, é necessário que o separador utilizado seja sempre o mesmo em todos os fatores. Recomendamos sempre utilizar a vírgula como separador. Por exemplo: 10,5 ou 8,7 ou 3,4. 

  • 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

Image Added

Card
id7
labelFormatDateTime
  • FormatDateTime


Card
id8
labelGetDateTime
  • GetDateTime


Card
id9
labelIsDateTime
  • IsDateTime


Card
id10
Card
id5
labelJolt
  • 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
Painel
borderColor#f2f2f2
bgColor#f2f2f2

Importante: Evite inserir comentários "//" no campo de especificação do Jolt, para garantia de processamento com sucesso. Comentários inseridos neste campo podem não ser corretamente processados impactando em erros na execução da integração.

Card
id11
labelLength
  • A função Length permite retornar a quantidade de caracteres da string informada no campo Texto. Neste exemplo estamos utilizando "Joinville SC" que contém 12 caracteres pois o espaço também é contado como um caractere. 

Image Added

Card
id12
labelLower case
  • 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.

Image Added

Card
id136
labelMultiplication
Dica

No caso das funções matemáticas sempre que utilizarmos números que não são inteiros, ou seja, que possuem virgula, é necessário que o separador utilizado seja sempre o mesmo em todos os fatores. Recomendamos sempre utilizar a vírgula como separador. Por exemplo: 10,5 ou 8,7 ou 3,4. 

  • 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.  

Card
id714
labelSum
Dica

No caso das funções matemáticas sempre que utilizarmos números que não são inteiros, ou seja, que possuem virgula, é necessário que o separador utilizado seja sempre o mesmo em todos os fatores. Recomendamos sempre utilizar a vírgula como separador. Por exemplo: 10,5 ou 8,7 ou 3,4. 

  • 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.  

    Image Removed

    Replace
    • 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.

    Image Added

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

    Image Added

    Card
    id16
    labelSubstring
    • 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".

    Image Added

    Card
    id17
    Card
    id8
    labelSubtraction
    Dica

    No caso das funções matemáticas sempre que utilizarmos números que não são inteiros, ou seja, que possuem virgula, é necessário que o separador utilizado seja sempre o mesmo em todos os fatores. Recomendamos sempre utilizar a vírgula como separador. Por exemplo: 10,5 ou 8,7 ou 3,4. 

    • 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

    Card
    id918
    labelDivisionSum
    Dica

    No caso das funções matemáticas sempre que utilizarmos números que não são inteiros, ou seja, que possuem virgula, é necessário que o separador utilizado seja sempre o mesmo em todos os fatores. Recomendamos sempre utilizar a vírgula como separador. Por exemplo: 10,5 ou 8,7 ou 3,4. 

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

    Image RemovedImage Added

    Card
    id1019
    labelLengthUpper case
    • A função Length permite retornar a quantidade de caracteres da string informada no campo Texto. Neste exemplo estamos utilizando "Joinville SC" que contém 12 caracteres pois o espaço também é contado como um caractere. 

    Image Removed

    Card
    id11
    labelReplace
    • 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.

    Image Removed

    • 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.

    Image Added

    Card
    id12
    labelSubstring
    • 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".

    Image Removed