Compartilhar via

  • Artigo

Caixa de diálogo Definir formula (Designer de Modelos)

Use para criar um novo campo que contenha uma fórmula. Para obter exemplos de fórmulas válidas, consulte Usando funções (Construtor de Relatórios 1.0).

Opções

  • Campos
    Use essa guia para localizar campos dentro do modelo de relatório que você deseja incluir na expressão. Clique duas vezes no campo para adicioná-lo à expressão.

  • Funções
    Use essa guia para selecionar a função que você deseja usar na sua expressão. Clique duas vezes na função para adicioná-la à expressão. Para obter uma descrição de cada função, consulte a seção a seguir.

  • Nome do campo
    Insira um nome para a expressão que está sendo criada.

  • Fórmula
    Use para gravar e editar a fórmula.

  • Pesquisar
    Clique para iniciar a caixa de diálogo Pesquisar.

  • Agregar aqui
    Se você clicar duas vezes em um nome de campo exibido na caixa Fórmula, a relação entre a entidade principal e entidade do campo será exibida. Clique para aplicar uma agregação à expressão em qualquer ponto do caminho do modelo.

  • Nenhum filtro aplicado
    Se você clicar duas vezes em um nome de campo exibido na caixa Fórmula, a relação entre a entidade principal e entidade do campo será exibida. É possível aplicar um filtro à expressão em qualquer ponto do caminho do modelo. Clique para aplicar um filtro à expressão e clique em Criar novo filtro. A caixa de diálogo Dados do Filtro é exibida.

  • Atalhos de função
    Clique para adicionar um operador à formula exibida na caixa Fórmula. A caixa de diálogo Definir Fórmula fornece atalhos para as funções mais usadas; no entanto, você poderá selecionar esses operadores também na guia Funções. A seguir, uma explicação de cada atalho.

    + Usado para adicionar dois valores.

    - Usado para subtrair um valor de outro.

    * Usado para multiplicar dois valores.

    / Usado para dividir dois valores.

    & Usado para concatenar dois valores.

    ( Usado para iniciar um cálculo.

    ) Usado para encerrar um cálculo.

Funções

As informações a seguir descrevem cada uma das funções localizadas na guia Funções da caixa de diálogo Definir Fórmula.

Agregação

Para resumir um intervalo de valores numéricos, use as funções a seguir.

  • SUM
    Retorna a soma de todos os valores dentro de uma expressão.

    Sintaxe

    SUM(agregação)

    SUM pode ser usado apenas com campos que contenham valores numéricos. Valores nulos são ignorados.

  • AVERAGE
    Retorna a média (aritmética) de todos os valores não nulos da expressão.

    Sintaxe

    AVERAGE(agregação)

    AVERAGE pode ser usado apenas com campos que contenham valores numéricos. Valores nulos são ignorados.

  • MAX
    Retorna o valor máximo na expressão.

    Sintaxe

    MAX(agregação)

    Para as colunas de caracteres, MAX identifica o valor mais alto na seqüência de agrupamento. Valores nulos são ignorados.

  • MIN
    Retorna o valor mínimo na expressão.

    Sintaxe

    MIN(agregação)

    Para as colunas de caracteres, MIN identifica o valor mais baixo na seqüência de agrupamento. Valores nulos são ignorados.

  • COUNT
    Retorna o número de itens não-nulos em um grupo.

    Sintaxe

    COUNT(agregação)

    COUNT sempre retorna um valor do tipo de dados Int.

  • COUNTDISTINCT
    Retorna o número de instâncias distintas não-nulas de um item em um grupo.

    Sintaxe

    COUNTDISTINCT(agregação)

  • STDev
    Retorna o desvio padrão dos valores não-nulos de um item.

    Sintaxe

    STDEV(agregação)

  • STDevP
    Retorna o desvio padrão da população de valores não-nulos de um item.

    Sintaxe

    STDEVP(agregação)

  • VAR
    Retorna a variância de valores não-nulos de um item.

    Sintaxe

    VAR(agregação)

  • VARP
    Retorna a variância da população dos valores não-nulos de um item.

    Sintaxe

    VARP(agregação)

Condicional

Para testar uma condição, use as funções a seguir.

  • IF
    Retorna um valor se uma condição que seja avaliada como TRUE for especificada e outro valor se uma condição avaliada como FALSE for especificada.

    Sintaxe

    IF(condição, value_if_true, value_if_false)

    A condição deve ser um valor ou uma expressão que possa ser avaliada como TRUE ou FALSE. Value_if_true representa o valor retornado se a condição for verdadeira. Value_if_false representa o valor retornado se a condição for falsa.

  • IN
    Determina se um item é membro de um conjunto.

    Sintaxe

    IN(item, conjunto)

  • Alternar
    Avalia uma lista de expressões e retorna o valor de uma expressão associado à primeira expressão na lista que seja True. Alternar pode ter um ou mais pares de condições/valores.

    Sintaxe

    Switch(condição1, valor1, …)

Conversão

Para converter um valor de um tipo de dados para outro, use as funções a seguir.

  • INT
    Converte um valor em um inteiro.

    Sintaxe

    INT(valor)

  • DECIMAL
    Converte um valor em um decimal.

    Sintaxe

    DECIMAL(valor)

  • FLOAT
    Converte um valor em um tipo de dados flutuante.

    Sintaxe

    FLOAT(valor)

  • TEXT
    Converte um valor numérico em texto.

    Sintaxe

    TEXT(valor)

Data e hora

Para exibir a data ou a hora, use as funções a seguir.

  • DATE
    Retorna um valor de data e hora, se fornecidos um ano, mês e dia às 12:00:00 AM.

    Sintaxe

    DATE(ano, mês, dia)

  • DATEONLY
    Retorna o ano, mês e dia de um valor de data e hora.

    Sintaxe

    DATEONLY(data e hora)

  • DATETIME
    Retorna um valor de data e hora, se fornecidos o ano, mês, dia, hora, minutos e segundos.

    Sintaxe

    DATETIME(ano, mês, dia, hora, minutos, segundos)

  • YEAR
    Retorna um valor de ano de uma data e hora.

    Sintaxe

    YEAR(data e hora)

  • QUARTER
    Retorna o trimestre de calendário (1 a 4) da data e hora.

    Sintaxe

    QUARTER(data e hora)

  • MONTH
    Retorna o mês de uma data e hora.

    Sintaxe

    MONTH(data e hora)

  • DAY
    Extrai o dia de uma data e hora.

    Sintaxe

    DAY(data e hora)

  • HOUR
    Extrai a hora de uma data e hora.

    Sintaxe

    HOUR(data e hora)

  • MINUTE
    Extrai o minuto de uma data e hora.

    Sintaxe

    MINUTE(data e hora)

  • SECOND
    Extrai o segundo de uma data e hora.

    Sintaxe

    SECOND(data e hora)

  • DAYOFYEAR
    Retorna o dia do ano da data e hora. 1º de janeiro = 1 até 31 de dezembro = 366, pressupondo-se que se trate de um ano bissexto.

    Sintaxe

    DAYOFYEAR(data e hora)

  • WEEK
    Retorna o valor numérico da semana no ano calendário.

    Sintaxe

    WEEK(data e hora)

  • DAYOFWEEK
    Retorna o dia da semana, começando com segunda-feira. Segunda-feira = 1 até domingo = 7.

    Sintaxe

    DAYOFWEEK(data e hora)

  • NOW
    Retorna a data e a hora atuais.

    Sintaxe

    NOW( )

  • TODAY
    Retorna a data atual.

    Sintaxe

    TODAY( )

  • DATEDIFF
    Retorna a diferença entre a data e hora de início e a data e hora de término.

    Sintaxe

    DATEDIFF(intervalo, data e hora, data e hora)

  • DATEADD
    Retorna uma hora e data que é o resultado da adição do número especificado de unidades de intervalo de tempo à data e à hora originais.

    Sintaxe

    DATEADD(intervalo, unidades, data e hora)

Lógica

Para testar a lógica de uma condição, use as funções a seguir.

  • AND
    Retorna TRUE se todos os argumentos forem TRUE; retorna FALSE se um ou mais argumentos forem FALSE.

    Sintaxe

    AND(lógico, lógico)

    Os argumentos devem ser avaliados como valores lógicos, como TRUE ou FALSE, ou devem ser matrizes ou referências com valores lógicos. Se um argumento de matriz ou referência contiver texto ou células vazias, esses valores serão ignorados.

  • OR
    Retorna TRUE se qualquer argumento for TRUE; retorna FALSE se todos os argumentos forem FALSE.

    Sintaxe

    OR(lógico, lógico)

    Os argumentos devem ser avaliados como valores lógicos, como TRUE ou FALSE, ou estar contidos em matrizes ou referências com valores lógicos. Se uma matriz ou referência contiver texto ou células vazias, esses valores serão ignorados.

  • NOT
    Inverte o valor de seu argumento. Use NOT para garantir que uma cláusula não é igual a um valor específico.

    Sintaxe

    NOT(lógico)

    Se o valor for FALSE, NOT retorna TRUE; se o valor for TRUE, NOT retorna FALSE.

Matemática

Para manipular valores numéricos, use as funções a seguir.

  • MOD
    Retorna o resto após a divisão de um número por um divisor. O divisor não pode ser igual a 0.

    Sintaxe

    MOD(número, divisor)

  • TRUNC
    Trunca um número até o número de dígitos especificado. Se o número for positivo, será truncado à direita do decimal. Se o número for negativo, será truncado à esquerda do decimal.

    Sintaxe

    TRUNC(número, dígitos)

  • ROUND
    Arredonda um número para um número de dígitos especificado.

    Sintaxe

    ROUND(número, dígitos)

    Se o número de dígitos for maior que 0 (zero), o número será arredondado até o número de casas decimais especificado. Se o número de dígitos for 0, então, o número será arredondado até o inteiro mais próximo. Se o número for menor que 0, então será arredondado à esquerda da vírgula decimal.

Operadores

Operadores aritméticos

Para efetuar operações matemáticas básicas, como adição, subtração, ou multiplicação, combinar números e produzir resultados numéricos, use os operadores a seguir.

  • + Adicionar
    Usado para adicionar dois ou mais itens.

    Sintaxe

    valor + valor

  • - Subtração
    Usado para deduzir um item de outro.

    Sintaxe

    valor- valor

  • * Multiplicação
    Usado para multiplicar itens.

    Sintaxe

    valor* valor

  • / Divisão
    Usada para dividir itens. O divisor não pode ser igual a 0.

    Sintaxe

    valor/divisor

  • - Negação
    Altere o sinal do valor.

    Sintaxe

    -valor

  • ^ Exponenciação
    Usado para elevar um valor a uma dada potência (exponenciação).

    Sintaxe

    valor^potência

Operadores de comparação

Para comparar dois valores e retornar um valor lógico de TRUE ou FALSE, use os operadores a seguir.

  • = Igual a
    Usado para igualar dois valores. Verdadeiro quando o valor1 é igual ao valor2.

    Sintaxe

    valor1= valor2

  • <> Não igual a
    Usado para indicar que dois valores não são iguais um ao outro. Verdadeiro quando o valor1 não é igual ao valor2.

    Sintaxe

    valor1 <> valor2

  • > Maior que
    Usado para indicar que um valor é maior do que outro. Verdadeiro quanto o valor1 é maior do que o valor2.

    Sintaxe

    valor1 > valor2

  • >= Maior ou Igual a
    Usado para indicar que um valor é maior ou igual a outro valor. Verdadeiro quanto o valor1 é maior ou igual ao valor2.

    Sintaxe

    valor1 >= valor2

  • < Menor que
    Usado para indicar que um valor é menor do que outro. Verdadeiro quando o valor1 é menor que o valor2.

    Sintaxe

    valor1 < valor2

  • <= Menor ou Igual a
    Usado para indicar que um valor é menor ou igual a outro valor. Verdadeiro quando o valor1 é menor ou igual ao valor2.

    Sintaxe

    valor1 <= valor2

Texto

Para manipular texto no seu relatório, use as funções a seguir.

  • Concat (&)
    Combina duas cadeias de caracteres em uma única. A segunda cadeia de caracteres é anexada à primeira.

    Sintaxe

    cadeia de caracteres & cadeia de caracteres

  • Localizar
    Posição da primeira instância de uma cadeia de caracteres.

    Sintaxe

    FIND(cadeia, subcadeia de caracteres)

  • Esquerda
    Retorna os caracteres mais à esquerda de uma cadeia de caracteres. Se especificar um valor menor que zero para o argumento de comprimento dentro da função, o comportamento será indefinido.

    Sintaxe

    LEFT(cadeia de caracteres, comprimento)

  • Comprimento
    Retorna o número de caracteres de uma cadeia.

    Sintaxe

    LENGTH(cadeia de caracteres)

  • Minúsculos
    Converte uma cadeia de caracteres de maiúsculas em minúsculas.

    Sintaxe

    LOWER(cadeia de caracteres)

  • LTrim
    Retorna uma cadeia de caracteres com os espaços à esquerda removidos.

    Sintaxe

    LTRIM(cadeia de caracteres)

  • Substituir
    Retorna uma cadeia de caracteres com todas as instâncias de uma subcadeia de caracteres substituídas por outra subcadeia.

    Sintaxe

    REPLACE(localizar, substituir, cadeia de caracteres)

  • Direita
    Retorna os caracteres mais à direita de uma cadeia de caracteres. Se especificar um valor menor que zero para o argumento de comprimento dentro da função, o comportamento será indefinido.

    Sintaxe

    RIGHT(cadeia de caracteres, comprimento)

  • RTrim
    Retorna uma cadeia de caracteres com os espaços à direita removidos.

    Sintaxe

    RTRIM(cadeia de caracteres)

  • Texto
    Converte um valor numérico em uma cadeia de caracteres.

    Sintaxe

    TEXT(valor)

  • Subcadeia de caracteres
    Retorna uma subcadeia de uma cadeia de caracteres. Se especificar um valor menor que zero para o argumento de comprimento dentro da função, o comportamento será indefinido.

    Sintaxe

    SUBSTRING(cadeia de caracteres, início, comprimento)

  • Maiúsculos
    Converte uma cadeia de caracteres de minúsculos em maiúsculos.

    Sintaxe

    UPPER(cadeia de caracteres)

Informações

Para retornar informações globais sobre usuários, use as funções a seguir.

  • GetUserID
    Retorna a ID utilizada pelo usuário para acessar os dados.

    Sintaxe

    GETUSERID()

  • GetUserCulture
    Retorna o idioma ou a localidade do usuário.

    Syntax

    GETUSERCULTURE()