Входные и выходные данные

Поля входных и выходных данных — это объектов, которые вы будете передавать пользователю и получать в результате выполнения задания. Их нужно настроить в спецификации проекта и затем использовать в блоке HTML задания, а также в полях Название и Описание для заданий на карте.

Вы можете добавлять поля, а также редактировать существующие, если создали проект из шаблона. Для нового поля укажите название и тип, а также выберите обязательность поля. Необязательные выходные поля используйте, чтобы исполнитель мог заполнить его по желанию, например дополнительный комментарий.

Внимание. Если вы редактируете обязательные поля, изменения применяются только к новым пулам. Существующие пулы будут работать в соответствии со старой версией проекта.

Работать с полями можно как в графическом режиме, так и в формате JSON. Для переключения режима нажимайте кнопку ⟨ ⟩.

Например, в задании исполнитель будет видеть текст (строковый тип данных) для модерации или перевода. Результат будет тоже строкой, в которую можно записывать значение переключателя или выпадающего списка либо введенный в поле текст. Формат задания, в том числе тип ответа, описывается в интерфейсе задания.

Сами объекты (ссылки, текст и т.д.) для заданий нужно будет загружать через TSV-файл в пул.

Параметры полей

Параметр

Параметр в JSON

Описание

Название

id

Идентификатор поля. Допустимы латинские буквы, цифры, дефис и нижнее подчеркивание.

Тип

type

Тип данных:

  • строка — string;

  • ссылка — url;

  • логический — boolean;

  • число — number;

  • дробное число — float;

  • файл — file;
  • географические координаты — coordinates;

  • объект JSON — json.

В режиме JSON для массивов к типу добавляется префикс array_. Например: array_file.

Обязательное поле

required

Для входных данных обязательность объекта при загрузке заданий. Для выходных данных обязательность ответа исполнителя.

По умолчанию поле необязательное — false.

Скрытое поле

hidden

Для входных данных атрибут поля, скрытого от пользователя. Для выходных данных всегда false.

По умолчанию поле открытое — false.

Массив array_<тип> Массив объектов одного типа. Используется, например, для загрузки нескольких фотографий исполнителем.

В режиме JSON массив — это отдельный тип данных. Например: "type": "array_file".

Мин. элементов

min_size Минимальное число элементов в массиве.
Макс. элементов max_size Максимальное число элементов в массиве.

Допустимые значения

allowed_values

Допустимые значения (для строк, дробных и целых чисел, логического типа данных).

Мин. длина

min_length

Минимальная длина строки.

Макс. длина

max_length Максимальная длина строки

Мин. значение

min_value Минимальное значений для дробных и целых чисел.

Макс. значение

max_value Максимальное значений для дробных и целых чисел.
Текущее положение

current_location

Только для типа данных coordinates: заполнение поля текущими координатами пользователя (true/false). Используется в заданиях для мобильного приложения.

pattern

Регулярное выражение, которому должна соответствовать строка.

Примеры полей в формате JSON

Строка
"my_string": {
    "type": "string",
    "required": true,
    "min_length": 10,
    "max_length": 100,    
    "allowed_values": ["a11", "b22", "c33"],
    "pattern": "^[a-zA-Z0-9]"
}
Ссылка
"my_url": {
    "type": "url",
    "required": true
}
Логический тип данных
"my_boolean": {
    "type": "boolean",
    "required": true
}
Целое число
"my_integer": {
    "type": "integer",
    "required": false,
    "min_value": 1,
    "max_value": 100,
    "allowed_values": [10, 20, 30]
}
Дробное число
"my_float": {
    "type": "float",
    "required": true,
    "min_value": 10.11,
    "max_value": 65.51
    "allowed_values": [10.15, 20.15, 30.15]
}
Файл
"my_file": {
    "type": "file",
    "required": true
}
Массив файлов
"my_file_array": {
    "type": "file_array",
    "required": true,
    "max_size": 5
}
Географические координаты
"my_coordinates": {
    "type": "coordinates",
    "required": true
}
JSON
"my_json": {
    "type": "json",
    "required": true
}