Sum

Retorna o total de todos os valores válidos que não estão em branco em um campo.

Formato 

Sum ( campo {; campo...}

Parâmetros 

campo - qualquer campo relacionado, campo de repetição ou conjunto de campos sem repetição; ou uma expressão que retorna um campo, campo de repetição ou conjunto de campos sem repetição.

Os parâmetros entre chaves { } são opcionais.

Tipo de dados retornado 

número

Originada na versão 

6.0 ou anterior

Descrição 

Campo pode ser qualquer um dos seguintes:

  • um campo de repetição (campoDeRepetição).
  • um campo em registros relacionados correspondentes especificados por (tabela::campo), se esses registros aparecerem ou não em um portal.
  • vários campos sem repetição em um registro(campo1;campo2;campo3...).
  • repetições correspondentes de campos de repetição em um registro (campoDeRepetição1;campoDeRepetição2;campoDeRepetição3), se o resultado for retornado em um campo de repetição com pelo menos o mesmo número de repetições.
  • vários campos no primeiro registro correspondente especificados por (tabela::campo1;tabela::campo2;...). Você pode incluir campos de diferentes tabelas (tabela 1::campo A;tabela 2::campo B...).

Notas 

  • Quando um campo mencionado é um campo de repetição, a função Sum retorna a soma do primeiro campo de repetição, depois a soma do segundo campo de repetição e assim por diante.

Exemplo 1 

Uma tabela Fatura tem um portal que mostra itens de linha.

Sum(ItensdeLinha::PreçoEstendido) totaliza os valores de todos os itens da fatura.

Exemplo 2 

Uma tabela FaturamentoTempo tem um portal que mostra as horas trabalhadas em um projeto. Horas é um campo de tempo.

Sum(Horas::HorasFaturáveis) retorna o número total de horas faturáveis em um projeto. Dessa forma, se o portal mostrar 40 horas e 15:30 horas, o total de horas faturáveis será 55:30 ou 55 horas e meia.

Exemplo 3 

Nos seguintes exemplos:

  • Campo1 contém duas repetições com valores de 1 e 2.
  • Campo2 contém quatro repetições com valores de 5, 6, 7 e 8.
  • Campo3 contém 6.

Se o resultado do cálculo não for um campo de repetição:

  • Sum(Campo2) retorna 26.
  • Sum(Campo1;Campo2;Campo3) retorna 12.

Se o resultado do cálculo for um campo de repetição:

  • Sum(Campo2) retorna um campo de repetição com 26 na primeira repetição.
  • Sum(Campo1;Campo2;Campo3) retorna um campo de repetição com 12, 8, 7, 8.

Tópicos relacionados