Pick values

Extracts specified values from a group of fields. For example, extracts the selected boxes from a checkbox group, or extracts all “yes” answers from a group of fields with yes/no/maybe dropdowns.

Parameters

The following parameters are in the computed field’s global Method parameter:

key	value	description
id (required)	pickValues
source_ids (required)	array of field ids in the current config	The id of the fields from which to pick values. Returns the fields whose values matches that specified in the Value parameter.
match	one, all. default: all	one: Select this option for mutually exclusive field groups, for example, a group of radio buttons where the user can select a single item. If no fields in the group have the specified value, or if more than one field has the expected value, then Sensible returns null. all: Returns all fields in the group with the specified value.
value	null, boolean, string, or string array. default: True	The value to pick. Sensible converts checkbox and radio button selection marks to true and false. For example, to pick selected checkboxes, specify true. Or, to return dropdown questions set to “yes”, specify “yes”.null returns the list of source IDs with null values, for example when Sensible can’t find a checkbox.

The following example shows returning a single value from a radio button group, and two values from a group of dropdowns.

Config

JSON

{
  "fields": [
    {
      "id": "individual",
      "anchor": "individual",
      "method": {
        "id": "nearestCheckbox",
        "position": "left"
      }
    },
    {
      "id": "partnership",
      "anchor": "partnership",
      "method": {
        "id": "nearestCheckbox",
        "position": "left"
      }
    },
    {
      "id": "llc",
      "anchor": "limited liability",
      "method": {
        "id": "nearestCheckbox",
        "position": "left"
      }
    },
    {
      "id": "income_over_100k",
      "anchor": "in excess of",
      "method": {
        "id": "row"
      }
    },
    {
      "id": "out_of_state_income",
      "anchor": "out-of-state",
      "method": {
        "id": "row"
      }
    },
    {
      "id": "professional_services",
      "anchor": "professional services",
      "method": {
        "id": "row"
      }
    }
  ],
  "computed_fields": [
    {
      "id": "business_classification",
      "method": {
        "id": "pickValues",
        "match": "one",
        "source_ids": [
          "individual",
          "partnership",
          "llc"
        ]
      }
    },
    {
      "id": "income_yes_answers",
      "method": {
        "id": "pickValues",
        "match": "all",
        "value": "yes",
        "source_ids": [
          "income_over_100k",
          "out_of_state_income",
          "professional_services"
        ]
      }
    },
    {
      "id": "cleanup_output",
      "method": {
        "id": "suppressOutput",
        "source_ids": [
          "income_over_100k",
          "out_of_state_income",
          "professional_services",
          "individual",
          "partnership",
          "llc"
        ]
      }
    }
  ]
}

Example document

The following image shows the example document used with this example config:

Example document	Download link

Output

JSON

{
  "business_classification": {
    "value": "partnership",
    "type": "string"
  },
  "income_yes_answers": [
    {
      "value": "income_over_100k",
      "type": "string"
    },
    {
      "value": "professional_services",
      "type": "string"
    }
  ]
}
`