Categorical Bin

Purpose

The categorical bin interface allows categorical data to be assigned to nodes. The participant drags nodes into an appropriate "bin" to assign the value.

Configuration

Each prompt defines a variable, whose value identifies an entry in the variable registry. The valid options for the categorical value are defined in that variable registry entry. Values are expected to be unique.

See also the General Interface API.

Example definition

{
  "id": "catBin1",
  "type": "CategoricalBin",
  "label": "Contact Types",
  "subject": {
    "entity": "node",
    "type": "person"
  },
  "prompts": [
    {
      "id": "contactType",
      "text": "Contact type categorical variable",
      "variable": "contactType",
      "bucketSortOrder": [
        {
          "property": "nickname",
          "direction": "desc"
        }
      ],
      "binSortOrder": [
        {
          "property": "nickname",
          "direction": "desc"
        },
        {
          "property": "age",
          "direction": "desc"
        }
      ]
    },
    {
      "id": "discussType",
      "text": "Discussion type variable, with a much longer prompt than the previous prompt. Please also note that this prompt uses the max number of bins, 8.",
      "variable": "discussType"
    }
  ]
}