App Builder Funções¶

Ao escrever expressões em App Builder(particularmente ao criar regras), há várias funções que podem ser usadas para unir, calcular e manipular os dados dentro da expressão. A seguir está uma lista de funções atualmente disponíveis em App Builder.

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 do SQL e, portanto, são avaliadas pelo mecanismo de banco de dados. As funções de banco de dados têm acesso às informações na camada de dados de App Builder, incluindo tabelas, colunas e outras funções de banco de dados.

Em App Builder as funções do banco de dados são configuradas principalmente na camada de lógica de negócios, especificamente no campo Coluna ou Expressão ao criar a lógica para uma regra de negócios em App Builder.

• Abdômens: Retorna o valor absoluto de um número.
• Média: Retorna a média (média matemá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 decorreu entre uma determinada data de início e término.
• DateName: Retorna uma parte de uma data ou valor de data/hora com uma representação de string em inglês para dias e meses.
• DatePart: O mesmo que DateName, mas retorna o inteiro apropriado para um mês ou dia.
• DenseRank: Numera sequencialmente cada linha dentro de um conjunto, ordenada por uma ou mais colunas, começando em 1. Esta função requer o ORDER BYmodificador e também suporta o PARTITION BYmodificador.
• Diferem: Verifica se ambos os argumentos correspondem, se corresponderem, App Builder emite um deles, se não o fizerem App Builder formata-o para que pareça Valor -----> Novo Valor
• EscapeIfRequired: Escapa um nome de tabela ou coluna, se necessário.
• Expressão: 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 offset.
• FromTimeZone: Converte um DATETIME em um fuso horário dado para UTC.
• GroupConcat: Permite que você agregue uma coluna de string no contexto de um grupo, por exemplo, criando uma lista delimitada por vírgulas.
• HasFlag: Avalia uma expressão para determinar se o campo tem um sinalizador.
• IIF: Retorna um de dois valores, dependendo se a expressão booleana é avaliada 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.
• Comprimento: Retorna o número de caracteres da string especificada, excluindo espaços em branco à direita.
• Lower: Retorna uma string em minúsculas.
• Lpad: Faz com que uma string tenha um determinado comprimento.
• Max: Retorna o maior valor em uma lista fornecida.
• Min: Retorna o menor valor em uma lista fornecida.
• NewUUID: Gera um novo UUID randomizado para cada entrada em uma tabela.
• Agora: 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, ordenada por uma ou mais colunas, começando em 1.
• RowNumber: Numera sequencialmente cada linha dentro de um conjunto, ordenada por uma ou mais colunas, começando em 1. Esta função requer o ORDER BYmodificador e também suporta o PARTITION BYmodificador.
• 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.
• Direita: Retorna um número dado de caracteres do lado direito de uma string de texto fornecida.
• Rj0: Faz com que uma string tenha um determinado comprimento preenchendo o início de uma 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 length especifica.
• Sqrt: Retorna a raiz quadrada de um número.
• Substring: Retira uma parte de uma string.
• Soma: Retorna a soma de todos os valores.
• Timestamp: Pega uma string que é uma hora e/ou data e a converte em um timestamp.
• ToOffSet: Retorna um deslocamento para o argumento minutes.
• ToTimeZone: Converte um DATETIME em UTC para o fuso horário fornecido.
• Trim: Corta espaços em branco iniciais e finais de uma string.
• Tipo: Fornece informações sobre o tipo de uma expressão sem alterar a expressão em si.
• Upper: Retorna uma expressão de caractere com dados de caracteres minúsculos convertidos para maiúsculos.
• UUID: Suporte nativo para UUID, padronizando-o entre fornecedores.
• VisibilityOption: Fornece a capacidade de usar Valores de Visibilidade nomeados em uma expressão.
• Dia da semana: Retorna o dia da semana da data.
• Workday: Avalia se a data fornecida é um dia útil.

Funções de Tempo de Execução¶

Funções de tempo de execução são funções que são avaliadas durante o tempo de execução em App Builder, 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 de tempo de execução são executadas na camada de negócios de App Builder 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 de Tempo de Execução não são suportadas para uso com Regras de Migração em App Builder. As regras de migração são executadas na camada de dados em App Builder, e as Funções de Tempo de Execução são executadas em tempo de execução. Por exemplo, você não pode usar a Função Enum em uma Regra de Migração porque a função não consegue acessar a tabela e fazer a substituição de string PK para Enum necessária por design.

Em App Builder, Funções de tempo de execução são configuradas principalmente na camada de lógica de negócios. Funções de tempo de execução podem ser usadas no campo Coluna ou Expressão ao construir a lógica para uma regra de negócios em App Builder.

• Aplicativo: Retorna o identificador do aplicativo como um UUID no qual o evento está sendo executado.
• Caller: Retorna o valor da coluna da linha que chamou o evento.
• Alterado : Relata se um valor de coluna foi modificado no início do evento.
• Claim: Retorna uma reivindicação de um provedor de segurança.
• Cliente: Retorna informações do cliente, como endereço IP, fuso horário, deslocamento do fuso horário, localidade etc.
• Enum: Um tipo de dado definido pelo usuário que consiste em constantes inteiras.
• Evento: Retorna informações sobre a execução do evento atual.
• Gerado: Recupera um valor gerado durante o Evento pelo mecanismo de negócios.
• Memória: Retorna o valor da coluna da função Shared() se existir, caso contrário, da função Caller().
• Página: Retorna o ID da página.
• RandomBytes: Gera bytes aleatórios no servidor e os retorna como uma string hexadecimal.
• Realm: Retorna o identificador do domínio de segurança no qual o evento está sendo executado.
• Role: Determina se o usuário atual é um membro de uma dada função.
• Session: Retorna o identificador da sessão do usuário atual.
• Shared: Retorna os critérios de link compartilhado.
• Versão: Fornece acesso a App Builder informações da versão atual do.
• Quem: Retorna informações sobre o usuário logado com base no parâmetro especificado.