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

Поля входных данных определяют типы объектов, которые вы передаете исполнителю в задании. Например, ссылка на картинку, текст, координаты.

Поля выходных данных определяют типы объектов, которые вы получите в результате выполнения задания. Например, текст, фотография.

Добавьте поля входных и выходных данных в Спецификации проекта, чтобы затем использовать в блоке HTML задания, а также в Названии и Описании для заданий на карте.

Чтобы добавить поле:
  1. Нажмите кнопку Добавить поле.
  2. Введите Название.
  3. Выберите Тип.
  4. Отметьте поле как Обязательное. Необязательные выходные поля используйте, чтобы исполнитель мог заполнить их по желанию, например дать дополнительный комментарий.
  5. Заполните другие параметры при необходимости. Например, установите минимальную длину строки.
  6. Нажмите кнопку Сохранить.

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

Пример полей входных и выходных данных

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

Чтобы редактировать существующее поле:

  1. Наведите курсор на поле и нажмите кнопку .
  2. Измените параметры поля.
  3. Нажмите кнопку Сохранить.
Внимание. Если вы редактируете обязательные поля, изменения применятся только к новым пулам. Существующие пулы будут работать в соответствии со старой версией проекта.
Параметры полей

Параметр

Параметр в JSON

Описание

Название

id

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

Тип

type

Тип данных:

  • строка — string;

  • ссылка — url;

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

  • число — number;

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

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

  • объект JSON — json.

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

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

required

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

Обязательность ответа исполнителя для выходных данных.

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

Скрытое поле

hidden

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

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

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

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

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

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

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

allowed_values

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

Мин. длина

min_length

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

Макс. длина

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

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

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

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

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

current_location

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

По умолчанию false.

pattern

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

Примеры полей в формате 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
}