Numeric Segmentation Properties

The following properties are stored as numeric values:

cpuCores

displayCount

ram

resolutionWidth

resolutionHeight

lifetimeRuntimeMinutes

lifetimeSessionCount

screenPpi

javaVmRam

The type field in the above properties needs to be number or numberRange. If number is specified, then a value field must also be present. The value field should contain a number, which may contain a decimal point if required. If numberRange is specified, then the value field should NOT be used. Instead, the properties min and max are to be used. These refer to the minimum and maximum number to be included in the report. If only one limit needs to be set, the other property is to be left out. Therefore, if you want to include installations with up to 2 display devices, you would not specify a min value, but instead specify only a max and set it as 2.

Example using segmentation by number, and numberRange values

{

    "segmentBy": "cpuCores",

    "segments": [

        {

            "type": "number",

            "value": 1,

        },

        {

            "type": "numberRange",

            "min": 2,

            "max": 4,

            "segmentLabel": "2 - 4"

        },

        {

            "type": "numberRange",

            "min": 5,

            "segmentLabel": "5 +"

        }

    ]

}

In the above example, we are requesting a report with 3 segments. The first segment contains only installations running on 1 CPU core, the second segments contains installations running on 2, 3, or 4 cores (range 2 - 4), while the last segment contains all installations which are running on a machine with 5 or more CPU cores. Note how when the type was numberRange, we had do specify a segmentLabel which is a free string that will be used by the user to identify what is being included in that specific segment.