☝️Small business or a startup? See if you qualify for our special offer.
+
All documentation

AggregatedDataObject

This object is used in the responses to the /select requests for the pivot table and the flat table. It contains information about aggregated data.

Properties

{
  values: {
    (uniqueName): {
      (func): number
    }
  },
  keys: {
    (uniqueName): string | number
  }
}
Property/TypeDescription
values
Object
For the /select request for the pivot table, values should contain numeric values that are calculated for a specific tuple.
For the /select request for the flat table, values should contain numeric values that are calculated for column totals.
values.(uniqueName)
Object
The field's unique name.
values.(uniqueName).(func)
Number
The result of the calculation, where (func) is an aggregation function.
keys
Object
optional Field's keys that describe a specific tuple. In case it is not defined, values are treated as totals.
Only for the /select request for the pivot table.
keys.(uniqueName)
String | Number
Field's member, where (uniqueName) is a field's unique name. Note: totals for each field should be included in the response even if they are disabled on the client side.

Examples

1) Example of a response to the /select request for the pivot table, where the AggregatedDataObject contains totals and values calculated for a specific tuple:

{
  "aggs": [
    {
      "keys": {
        "City": "Toronto"
      },
      "values": {
        "Price": {
          "sum": 100
        }
      }
    },
    {
      "keys": {
        "City": "New York"
      },
      "values": {
        "Price": {
          "sum": 23
        }
      }
    },
    {
      "values": {
        "Price": {
          "sum": 123
        }
      }
    }
  ]
}

2) Example of a response to /select request for the flat table, where the AggregatedDataObject contains column totals:

{
  "fields": [
    { "uniqueName": "Color" },
    { "uniqueName": "Destination" },
    { "uniqueName": "Country" },
    { "uniqueName": "Price" }
  ],
  "hits": [
    ["red", "Germany", "United States", 185],
    ["red", "Germany", "United States", 374],
    ["red", "Germany", "United States", 123]
  ],
  "aggs": [
    {
      "values": {
        "Price": {
          "sum": 682
        }
      }
    }
  ],
  "page": 0,
  "pageTotal": 1
}

See also

/select request for the pivot table
/select request for the flat table