form/
Contains API calls related to forms associated with tasks.
See forms
Form object structure
<form> =
{
"id": 2, //form unique id
"label": "Order form", //user-defined form label, from 1 to 100 characters
"fields": [ //multiple <form_field> objects can be here
{
"id": "111-aaa-whatever", //id must be unique across form fields
"label": "Name",
"description": "Your full name",
"required": true,
"min_length": 5,
"max_length": 255,
"type": "text"
}
],
"created": "2017-03-15 12:36:27", //date when this form was created (attached to the task). Read-only field
"submit_in_zone": true, //if true, form can be submitted only in task zone
"task_id": 1, //id of the task to which this form is attached
"template_id": 1, //id of the form template on which this form is based. Can be null if template was deleted.
"values": { //A map with field ids as keys and <field_value> objects as values
"111-aaa-whatever": { //key is used to link field and its corresponding value
"type": "text", //value type and field type must match
"value": "John Doe" //the rest of value object is field type-specific
}
},
"submitted": "2017-03-21 18:40:54", //date when form values were last submitted
"submit_location": { //location at which form values were last submitted
"lat": 11.0,
"lng": 22.0,
"address": "Wall Street, NY"
}
}
For form_field and form_value object description, see form fields and values