Funções no Jitterbit App Builder

Ao escrever expressões (particularmente ao criar Regras), existem várias funções que podem ser usadas para unir, calcular e manipular os dados dentro da expressão. Esta página mostra as funções atualmente disponíveis.

Funções de Banco de Dados

Funções de Banco de Dados são Funções que são traduzidas para uma função nativa SQL e, portanto, são avaliadas pelo mecanismo de banco de dados. As Funções de Banco de Dados têm acesso a informações na Camada de Dados, incluindo tabelas, colunas e outras funções de banco de dados.

As Funções de Banco de Dados são configuradas principalmente na Camada de Lógica de Negócios, especificamente no campo de Coluna ou Expressão ao construir a lógica para uma Regra de Negócio.

• Abs: Retorna o valor absoluto de um número.
• Average: Retorna a média (média aritmética) dos valores em um grupo. Ignora valores nulos.
• Cast: Converte uma expressão para outro tipo de dado.
• Char: Converte um código ASCII int em um valor de caractere.
• Concat: Retorna uma string que é o resultado da concatenação de dois ou mais valores de string (adicione espaços manualmente).
• ConcatWithDash: Adiciona o segundo parâmetro ao final do primeiro, separado por um traço.
• ConcatWithParentheses: Adiciona o segundo parâmetro ao final do primeiro entre parênteses.
• ContainsAlpha: Determina se uma expressão contém um caractere alfabético (a-z). Retorna 1 ou 0.
• Count: Retorna o número de itens em um grupo.
• DateAdd: Adiciona um certo número de dias, meses ou anos a uma data.
• DateDiff: Determina quanto tempo passou entre uma data de início e uma data de término dadas.
• DateName: Retorna uma parte de um valor de data ou data/hora com uma representação em string em inglês para dias e meses.
• DatePart: Igual ao DateName, mas retorna o inteiro apropriado para um mês ou dia.
• DenseRank: Numera sequencialmente cada linha dentro de um conjunto, ordenado por uma ou mais colunas, começando em 1. Esta função requer o modificador ORDER BY e também suporta o modificador PARTITION BY.
• Differ: Verifica se ambos os argumentos correspondem; se corresponderem, o App Builder exibe um deles; se não corresponderem, o App Builder formata para que pareça Valor -----> Novo Valor.
• EscapeIfRequired: Escapa um nome de tabela ou coluna, se necessário.
• Expression: Permite que o designer especifique sua própria expressão de função para agregados.
• FromOffSet: Retorna o número de minutos para um argumento de deslocamento.
• FromTimeZone: Converte um DATETIME em um determinado fuso horário para UTC.
• GroupConcat: Permite agregar uma coluna de string no contexto de um agrupamento, por exemplo, criando uma lista delimitada por vírgulas.
• HasFlag: Avalia uma expressão para determinar se o campo tem uma flag.
• IIF: Retorna um de dois valores, dependendo se a expressão booleana avalia como verdadeira ou falsa.
• IsNull: Retorna um valor alternativo para uma entrada nula, ou NULL se todos os argumentos forem nulos.
• IsNumeric: Retorna um valor booleano indicando se uma expressão pode ser avaliada como um número.
• Left: Retorna um número dado de caracteres do lado esquerdo de uma string de texto fornecida.
• Length: Retorna o número de caracteres da string especificada, excluindo espaços em branco finais.
• Lower: Retorna uma string em letras minúsculas.
• Lpad: Faz com que uma string tenha um comprimento dado.
• Max: Retorna o maior valor em uma lista dada.
• Min: Retorna o menor valor em uma lista dada.
• NewUUID: Gera um novo UUID aleatório para cada entrada em uma tabela.
• Now: Retorna a data e hora atuais.
• Null: Retorna um valor nulo Exemplo: IIF(Status='Delete',Null, Status)
• Position: Encontra a posição de uma substring dentro de uma string.
• Power: Retorna o valor de um número elevado a outro, onde ambos os números são passados como argumentos.
• Rank: Numera sequencialmente cada linha dentro de um conjunto, ordenado por uma ou mais colunas, começando em 1.
• RowNumber: Numera sequencialmente cada linha dentro de um conjunto, ordenado por uma ou mais colunas, começando em 1. Esta função requer o modificador ORDER BY e também suporta o modificador PARTITION BY.
• RemoveSpaces: Remove todos os espaços de uma string.
• Replace: Substitui todas as ocorrências de um valor de string especificado por outro valor de string.
• Right: Retorna um número dado de caracteres do lado direito de uma string de texto fornecida.
• Rj0: Faz com que uma string tenha um comprimento dado, preenchendo o início da string com o número 0.
• Round: Arredonda um número para cima ou para baixo, usando um segundo argumento para determinar quantas casas à direita (+) ou à esquerda (-) do ponto decimal arredondar.
• Rpad: Retorna uma cópia da string que é preenchida à direita para o número total de caracteres que o argumento de comprimento especifica.
• Sqrt: Retorna a raiz quadrada de um número.
• Substring: Extrai uma parte de uma string.
• Sum: Retorna a soma de todos os valores.
• Timestamp: Recebe uma string que é um horário e/ou data e a converte em um timestamp.
• ToOffSet: Retorna um deslocamento para o argumento de minutos.
• ToTimeZone: Converte um DATETIME em UTC para o fuso horário dado.
• Trim: Remove espaços em branco iniciais e finais de uma string.
• Type: Fornece informações sobre o tipo de uma expressão sem alterar a própria expressão.
• Upper: Retorna uma expressão de caractere com dados de caractere em minúsculas convertidos para maiúsculas.
• UUID: Suporte nativo para UUID, padronizando-o entre fornecedores.
• VisibilityOption: Fornece a capacidade de usar Valores de Visibilidade nomeados em uma expressão.
• Weekday: Retorna o dia da semana da data.
• Workday: Avalia se a data dada é um dia útil.

Funções em Tempo de Execução

Funções em Tempo de Execução são funções que são avaliadas durante a execução, enquanto as Funções de Banco de Dados são traduzidas para uma função nativa SQL e são avaliadas pelo mecanismo de banco de dados. As Funções em Tempo de Execução são executadas na Camada de Negócios e, portanto, não conseguem referenciar informações armazenadas na Camada de Dados, como colunas de tabela e outras funções de banco de dados.

As Funções em Tempo de Execução não podem ser usadas com Regras de Migração. As Regras de Migração são executadas na camada de dados, e as Funções em Tempo de Execução são executadas em tempo de execução. Por exemplo, não é possível usar a Função Enum em uma Regra de Migração porque a função não consegue acessar a tabela e realizar a substituição necessária de PK para string Enum por design.

As Funções em Tempo de Execução são configuradas principalmente na Camada de Lógica de Negócios. As Funções em Tempo de Execução podem ser usadas no campo Coluna ou Expressão ao construir a lógica para uma Regra de Negócios.

• App: Retorna o identificador da aplicação como um UUID no qual o evento está sendo executado.
• Caller: Retorna o valor da coluna da linha que chamou o evento.
• Changed : Informa se um valor de coluna foi modificado no início do evento.
• Claim: Retorna uma reivindicação de um provedor de segurança.
• Client: Retorna informações do cliente, como endereço IP, fuso horário, deslocamento de fuso horário, localidade etc.
• Enum: Um tipo de dado definido pelo usuário que consiste em constantes inteiras.
• Event: Retorna informações sobre a execução do evento atual.
• Generated: Recupera um valor gerado durante o Evento pelo mecanismo de negócios.
• Memory: Retorna o valor da coluna da função Shared() se existir, caso contrário, da função Caller().
• Page: Retorna o Id da Página.
• RandomBytes: Gera bytes aleatórios no servidor e os retorna como uma string hexadecimal.
• Recipient: Retorna um URN identificando um objeto como destinatário de uma notificação.
• Realm: Retorna o identificador do reino de segurança no qual o evento está sendo executado.
• Role: Determina se o usuário atual é membro de um determinado Papel.
• Session: Retorna o identificador da sessão do usuário atual.
• Shared: Retorna os critérios de link compartilhado.
• Version: Fornece acesso às informações da versão atual do App Builder.
• Who: Retorna informações sobre o usuário logado com base no parâmetro especificado.