Funções de mapeamento de dados

A tarefa de mapeamento de dados oferece várias funções de mapeamento predefinidas para transformar e padronizar os dados de mapeamento na sua integração. Uma função de mapeamento pode ter um ou mais parâmetros de entrada, em que cada parâmetro pode conter ainda um valor literal, uma variável ou uma função base com funções de mapeamento aplicadas. Pode usar várias funções de mapeamento para uma única origem de entrada, formando uma expressão de transformação de mapeamento.

A tabela seguinte apresenta as funções de mapeamento predefinidas disponíveis na tarefa Mapeamento de dados.

Função	Descrição
`ADD`	Adiciona o número especificado a um número existente.
`AND`	Executa a operação lógica AND nos valores booleanos especificados.
`APPEND`	Anexa o valor especificado a uma matriz.
`APPEND_ALL`	Anexa todos os valores especificados a uma matriz.
`APPEND_ELEMENT`	Anexa um elemento a uma matriz JSON.
`AVG`	Calcula a média numérica de todos os valores numa matriz.
`CEIL`	Calcula o menor número inteiro que é maior ou igual à entrada fornecida.
`CONCAT`	Concatena os carateres especificados a uma string existente.
`CONTAINS`	Verifica a ocorrência do valor especificado numa determinada string ou matriz de strings.
`DECODE_BASE64_STRING`	Descodifica uma string base64 para o conjunto de carateres UTF-8.
`DIVIDE`	Divide um número existente pelo número especificado.
`EQUALS`	Compara o valor especificado com o valor existente.
`EQUALS_IGNORE_CASE`	Compara o valor especificado com o valor existente.
`EPOCH_TO_HUMAN_READABLE_TIME`	Converte a indicação de tempo de época Unix (em milissegundos) num formato de hora legível por humanos.
`EXPONENT`	Calcula o valor de um número existente elevado à potência especificada.
`FILTER`	Filtra os elementos da matriz que cumprem uma determinada condição de filtro. Tenha em atenção que uma condição de filtro tem de ser avaliada como VERDADEIRO ou FALSO.
`FLATTEN`	Aplaina uma matriz JSON recursivamente para criar uma nova matriz unidimensional.
`FLOOR`	Calcula o maior número inteiro que é menor ou igual à entrada fornecida.
`FOR_EACH`	Aplica uma ou mais funções de transformação a cada elemento numa matriz.
`GET`	Devolve o valor numa matriz num índice especificado. Numa matriz, o primeiro valor está disponível no índice 0 e o último valor está disponível no índice n-1, onde n é a dimensão da matriz.
`GET_ELEMENT`	Devolve o elemento no índice especificado numa matriz JSON. Na matriz, o primeiro valor está disponível no índice 0 e o último valor está disponível no índice n-1, em que n é a dimensão da matriz.
`GET_PROPERTY`	Devolve o valor da propriedade especificada num objeto JSON.
`GREATER_THAN`	Verifica se um número existente é superior ao número especificado.
`GREATER_THAN_EQUAL_TO`	Verifica se um número inteiro é maior ou igual ao valor especificado.
`LENGTH`	Calcula o comprimento de uma string. O comprimento de uma string é o número de carateres na string.
`LESS_THAN_EQUAL_TO`	Verifica se um número inteiro é inferior ou igual ao valor especificado.
`LESS_THAN`	Verifica se um número existente é inferior ao número especificado.
`MAX`	Encontra o valor mais elevado numa matriz.
`MERGE`	Mescla duas variáveis JSON (objetos ou matrizes). Se o mesmo valor estiver presente em ambas as variáveis, a função remove o valor duplicado.
`MIN`	Encontra o valor mais baixo numa matriz.
`MOD`	Divide dois valores e devolve o resto da operação de divisão.
`MULTIPLY`	Multiplica um número existente pelo número especificado.
`NAND`	Executa a operação lógica NAND nos valores booleanos especificados.
`NOR`	Executa a operação lógica NOR nos valores booleanos especificados.
`NOT`	Devolve o valor oposto de um valor booleano.
`OR`	Executa a operação lógica OU nos valores booleanos especificados.
`REMOVE`	Remove o valor especificado de uma matriz.
`REMOVE_AT`	Remove um elemento de uma matriz no índice especificado.
`REMOVE_PROPERTY`	Remove uma propriedade de um objeto JSON.
`REPLACE_ALL`	Substitui todas as ocorrências de uma substring numa string.
`RESOLVE_TEMPLATE`	Resolve referências numa string de modelo que contém referências $variable$.
`ROUND`	Arredonda um número para o número inteiro mais próximo.
`SET`	Atualiza o valor de uma matriz de strings no índice especificado.
`SET_PROPERTY`	Adiciona ou atualiza uma propriedade num objeto JSON.
`SIZE`	Conta o número de elementos numa matriz.
`SPLIT`	Divide uma string com base no delimitador especificado.
`SUBSTRING`	Devolve a substring da string atual do índice de início inclusive ao índice de fim exclusivo.
`SUBTRACT`	Subtrai o número especificado de um número existente.
`SUM`	Adiciona todos os valores numa matriz.
`TO_BASE_64`	Codifica uma string para o formato base64 através do charset UTF-8.
`TO_BOOLEAN_ARRAY`	Converte uma matriz JSON numa matriz booleana.
`TO_BOOLEAN`	Converte uma string num tipo de dados booleano.
`TO_DOUBLE_ARRAY`	Converte uma matriz JSON numa matriz dupla.
`TO_DOUBLE`	Converte uma string ou um número inteiro num número de vírgula flutuante de precisão dupla.
`TO_INT_ARRAY`	Converte uma matriz JSON numa matriz de números inteiros.
`TO_INT`	Converte uma string num número inteiro.
`TO_JSON`	Converte o valor atual num objeto JSON.
`TO_LOWERCASE`	Converte todos os carateres numa string em minúsculas.
`TO_SET`	Remove valores duplicados numa matriz.
`TO_STRING_ARRAY`	Converte uma matriz JSON numa matriz de strings.
`TO_UPPERCASE`	Converte todos os carateres numa string em maiúsculas.
`XNOR`	Executa a operação lógica XNOR nos valores booleanos especificados.
`XOR`	Executa a operação lógica XOR nos valores booleanos especificados.
`GENERATE_UUID`	Gera um UUID aleatório.
`GET_EXECUTION_ID`	Devolve o ID de execução da integração atual.
`GET_INTEGRATION_NAME`	Devolve o nome da integração atual.
`GET_INTEGRATION_REGION`	Devolve a região da integração atual.
`GET_PROJECT_ID`	Devolve o ID do projeto do Google Cloud da integração atual.
`INT_LIST`	Devolve uma lista de números inteiros entre os valores especificados. A lista devolvida inclui o valor inicial e exclui o valor final.
`NOW_IN_MILLIS`	Devolve a hora de época Unix atual da integração em milissegundos.