comma-separated list of properties to include in the response
Typically when retrieving submissions an include of values
will be specified.
This will return a map of field names to the values associated to that field.
{
...,
"values": {
"Checkbox Field": ["Value 1", "Value 2"],
"Text Field": "Value"
}
}
Specifying an include of values.raw
is similar to specifying an include of
values
, except the values will be returned as a map of field keys to
metadata about the value associated to that field.
-
isMalformed indicates whether the value matches the expected format for the field type.
-
isUnexpected indicates whether the value corresponds to a field key that does not exist on the form.
-
name indicates the name of the field (if it exists on the form).
-
rawValue is the raw string that corresponds to the value.
-
value is the value in JSON format (if the value is not malformed).
Because the rawValue property is returned as a string, this include can be
used to troubleshoot issues where a submission contains values in an
unexpected format (such as when a field type changes). Additionally,
values.raw
includes values for field keys that do not exist on the form
(likely because the field was deleted). This makes it possible to write
scripts to access or manipulate historical values that no longer correspond to
the current form.
{
...,
"valuesRaw": {
"f1": {
"isMalformed": false,
"isUnexpected": true,
"name": null,
"rawValue": "Orphaned Value",
"value": "Orphaned Value"
},
"f2": {
"isMalformed": false,
"isUnexpected": false,
"name": "Checkbox Field",
"rawValue": "[\"Value 1\", \"Value 2\"]",
"value": ["Value 1", "Value 2"]
},
"f2": {
"isMalformed": false,
"isUnexpected": false,
"name": "Text Field",
"rawValue": "Value",
"value": "Value"
}
}
}