Saltar para o conteúdo principal
Versão: v19

$compute

Calcular em atributos específicos (por exemplo, Employee/salary/?$compute=sum) ou no caso de um atributo de objeto (por exemplo., Employee/objectAtt.property1/?$compute=sum)

Descrição

Este parâmetro permite-lhe efetuar cálculos sobre os seus dados.

Para efetuar um cálculo sobre um atributo, escreve-se o seguinte:

GET /rest/Employee/salary/?$compute=$all

Se quiser passar um atributo de Objeto, tem de passar uma das suas propriedades. Por exemplo:

GET /rest/Employee/objectAtt.property1/?$compute=$all

Pode utilizar qualquer uma das seguintes palavras-chave:

Palavra-chaveDescrição
$allUm objeto JSON que define todas as funções para o atributo (média, contagem, mínimo, máximo e soma para atributos do tipo Número e contagem, mínimo e máximo para atributos do tipo Cadeia
averageObter a média de um atributo numérico
countObter o número total na coleção ou na classe de dados (em ambos os casos há que especificar um atributo)
minObter o valor mínimo num atributo numérico ou o valor mais baixo num atributo do tipo String
maxObter o valor máximo num atributo numérico ou o valor mais alto num atributo do tipo String
sumObter a soma de um atributo numérico

Exemplo

Se quiser obter todos os cálculos para um atributo do tipo Número, pode escrever:

GET /rest/Employee/salary/?$compute=$all

Resposta:

{
"salary": {
"count": 4,
"sum": 335000,
"average": 83750,
"min": 70000,
"max": 99000
}
}

Se quiser obter todos os cálculos para um atributo do tipo String, pode escrever:

GET /rest/Employee/firstName/?$compute=$all

Resposta:

{
"salary": {
"count": 4,
"min": Anne,
"max": Victor
}
}

Se pretender obter apenas um cálculo num atributo, pode escrever o seguinte:

GET /rest/Employee/salary/?$compute=sum

Resposta:

235000

Se pretender efetuar um cálculo num atributo de um objeto, pode escrever o seguinte:

GET /rest/Employee/objectAttribute.property1/?$compute=sum

Responsa:

45