Compartilhar via

  • Artigo

Caixa de diálogo Definir Fórmula (Construtor de Relatórios 3.0)

Use a caixa de diálogo Definir Fórmula para criar uma fórmula ou um novo campo que contenha uma fórmula.

A caixa de diálogo tem as guias Campos e Funções.

  • Use a guia Campos para localizar no modelo de relatório os campos que você deseja incluir na fórmula.

  • Use a guia Funções para selecionar as funções que você deseja usar na fórmula.

Opções na guia Campos

  • Entidades
    Lista as entidades. Clique em uma entidade para exibir seus campos na lista Campos.

  • Campos
    Lista os campos nas entidades. É possível arrastar um campo para a caixa de texto Fórmula ou clicar duas vezes no campo para adicioná-lo à caixa de texto Fórmula.

  • Novo Campo
    Clique para adicionar um novo campo. O valor Novo Campo <nome da entidade> é exibido em Nome do campo.

  • Nome do campo
    Digite um nome para o novo campo que você está criando.

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

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

  • Modo Avançado
    Clique para mostrar relações adicionais entre as entidades. Essas relações permitem criar consultas complexas. Quando você clica no botão Modo Avançado, são exibidos mais três tipos de funções:

    • Funções Inverter. As funções Inverter mostram a relação com a entidade em que você estava.

    • Entidades de pesquisa. Uma entidade de pesquisa é uma função que contém apenas um campo de interesse.

    • Entidades que herdam de ancestrais diretos da entidade selecionada, mas que não são um ancestral direto da entidade atual.

  • 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 a entidade do campo será exibida. Clique para aplicar uma agregação à expressão em qualquer ponto do caminho do modelo.

  • 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, é fornecida uma explicação de cada atalho.

    + Use para somar dois valores.

    - Usado para subtrair um valor de outro.

    * Usado para multiplicar dois valores.

    / Usado para dividir dois valores.

    & Use para concatenar dois valores.

    ( Use para iniciar um cálculo.

    ) Use para encerrar um cálculo.

  • Fórmula expandida
    Se você clicar duas vezes em um nome de campo exibido na caixa de texto Fórmula, a relação entre a entidade principal e a entidade do campo será exibida. É possível aplicar um filtro à expressão em qualquer ponto do caminho do modelo.

    • Clique em Nenhum filtro aplicado e em Criar novo filtro para criar um novo filtro para o campo.

    • Se o campo já tiver um filtro, clique no filtro e em Editar filtro.

    • Para remover um filtro existente, clique no filtro e em Remover.

  • Salvar essa fórmula como um novo campo <nome da entidade>
    Marque a caixa de seleção para o indicar que você deseja adicionar a fórmula como um campo.

Opções na guia 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.

Agregado

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 sequê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 sequê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(agregado)

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

    Sintaxe

    STDEV(agregado)

  • 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 for especificada uma condição que seja avaliada como TRUE e outro valor se for especificada uma condição avaliada como FALSE.

    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 é um membro de um conjunto.

    Sintaxe

    IN(item, conjunto)

  • SWITCH
    Avalia uma lista de expressões e retorna um valor de uma expressão associada à primeira expressão da 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 float.

    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 a partir 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)

  • WEEK
    Retorna o valor numérico correspondente à semana no ano civil.

    Sintaxe

    WEEK(data e hora)

  • DAYOFWEEK
    Retorna o dia da semana, começando com segunda-feira. Segunda-feira = 1 a 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 um valor de data e hora 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 do argumento. Use NOT para garantir que uma cláusula não seja igual a um determinado valor.

    Sintaxe

    NOT(lógico)

    Se o valor for FALSE, NOT retornará TRUE; se o valor for TRUE, NOT retornará 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 0.

    Sintaxe

    MOD(número, divisor)

  • TRUNC
    Trunca um número de acordo com 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 especificado de dígitos.

    Sintaxe

    ROUND(número, dígitos)

    Se o número de dígitos for maior que 0 (zero), o número será arredondado para o número especificado de casas decimais. Se o número de dígitos for 0, o número será arredondado para o inteiro mais próximo. Se o número for menor que 0, será arredondado à esquerda do ponto 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. A opção Atalhos de função contêm os operadores aritméticos mais utilizados.

  • + Adicionar
    Use para adicionar dois ou mais itens.

    Sintaxe

    valor + valor

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

    Sintaxe

    valor- valor

  • * Multiplicação
    Use para multiplicar itens.

    Sintaxe

    valor* valor

  • / Divisão
    Use para dividir itens. O divisor não pode ser 0.

    Sintaxe

    valor/divisor

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

    Sintaxe

    -valor

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

    Sintaxe

    valor^potência

  • = Igual a
    Use para igualar dois valores. True quando value1 for igual a value2.

    Sintaxe

    valor1= valor2

  • <> Diferente de
    Use para indicar que dois valores não são iguais. True quando o valor1 não é igual ao valor2.

    Sintaxe

    valor1 <> valor2

  • > Maior que
    Use para indicar que um valor é maior do que outro. True quando o valor1 é maior que o valor2.

    Sintaxe

    valor1 > valor2

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

    Sintaxe

    valor1 >= valor2

  • < Menor que
    Use para indicar que um valor é menor que outro. True quando o valor1 é menor que o valor2.

    Sintaxe

    valor1 < valor2

  • <= Menor ou Igual a
    Use para indicar que um valor é menor ou igual a outro. True quando value1 for menor ou igual a value2.

    Sintaxe

    value1 <= value2

Texto

Para manipular texto, 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

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

    Sintaxe

    FIND(cadeia de caracteres, subcadeia de caracteres)

  • LEFT
    Retorna os caracteres mais à esquerda de uma cadeia de caracteres. Se você 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)

  • LENGTH
    Retorna o número de caracteres em uma cadeia de caracteres.

    Sintaxe

    LENGTH(cadeia de caracteres)

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

    Sintaxe

    LOWER(cadeia de caracteres)

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

    Sintaxe

    LTRIM(cadeia de caracteres)

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

    Sintaxe

    REPLACE(localizar, substituir, cadeia de caracteres)

  • RIGHT
    Retorna os caracteres mais à direita de uma cadeia de caracteres. Se você 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)

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

    Sintaxe

    TEXT(valor)

  • SUBSTRING
    Retorna uma subcadeia de dentro de uma cadeia de caracteres. Se você 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)

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

    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()